Essential Studio for MAUI Release Notes

v21.1.35
March 23, 2023
We are pleased to announce that we have updated the versioning system of Essential Studio to a semantic format that provides greater clarity and consistency in versioning, making it easier for users to understand the significance of each Syncfusion release.

The new format consists of three components: Major, Minor, and Patch.

Format: Major.Minor.Patch
Example: 21.1.35

We believe that this change will enable our users to track and manage updates to our components effectively. We are excited to see how it enhances their experience.

Common

New Controls

The below controls are added newly.

  • Masked Entry
  • Popup
  • Shimmer

Visual Studio Extensions

Syncfusion has launched an innovative product, the .NET MAUI Template Studio, to simplify the process of creating a Syncfusion .NET MAUI application. This comes equipped with an intuitive project wizard that guides you through the creation process. This feature makes it incredibly user-friendly and ensures that you can create an application effortlessly, without any prior experience. This means that you can now develop top-tier applications with Syncfusion advanced components and enjoy a variety of features and functionalities.

Others

  • The following controls have been developed to meet industry standards and are now marked as production-ready:

    • Autocomplete
    • Backdrop Page
    • Calendar
    • ComboBox
    • DataForm
    • Funnel Chart
    • Maps
    • Pyramid Chart
    • Rating
    • Text Input Layout
  • The .NET MAUI Syncfusion controls will now support .NET MAUI version 6.0.552.
  • The Syncfusion controls now officially support the .NET 7.0 framework and are compatible with both .NET 6.0 and .NET 7.0.

SfDataGrid

Features

  • #I428784, #F40291 - Provided the support to scroll the DataGrid to a specific row, column, or cell programmatically.
  • #F39615 - Provided the support to freeze the row and columns at top and left positions like Excel.
  • Provided the support to show stacked headers i.e. unbound header rows. Unbound header rows span stacked header columns across multiple rows and columns.
  • Provided the support to show an additional unbound row to display a summary or totals. Users can display a minimum, maximum, average, and count in columns.

DocIO

Features

  • #I427722, #I433286 - Convert a Markdown file to a Word document.
  • #I197763, #I227388, #I229518, #I298464, #I407308, #I437210 - Find elements in a Word document based on specified properties and their corresponding values.
  • #I425049 - Apply built-in table style as base style for a custom table style in a Word document.

Breaking Changes

  • #I424520 - An InvalidOperationException will be thrown when attempting to remove built-in styles from a Word document.

Bug Fixes

  • #I438158 - Unicode text is now rendered properly while converting a Word document to PDF\Image.

PDF

Features

  • Added support to get and set custom properties in the form fields.
  • Provided support to add an image in the center of QRCode in PDF and Image.
  • #F179088 – Provided support for retrieving custom images from rubber stamp annotations.
  • Provided support for importing and exporting annotations with an appearance in JSON format.
  • #I420880 – Provided support for adding TrueType fonts with full embedding.
  • Provided support for converting TIFF images to PDF in .NET projects.
  • Provided support for extracting accessibility tags from the PDF documents.

Bug Fixes

  • #I437729 - Form fields are not preserved properly after converting PDF to PDF/A is now resolved.
  • #I425746 - Text extraction with line collection returns incorrect results for the specific document is now resolved.
  • #I436823 - Null reference exception no longer occurs when performing OCR for a specific PDF document.
  • #I438154 - “Parameter is not valid” exception occurs while performing redaction in a specific PDF document is now resolved.
  • #I438588 - Text no longer breaks when saving a PDF with certain compression options enabled.
  • #I440543 - Text clipping no longer occurs when drawing the PDF grid with specific padding.
  • #I441813 - Unable to remove pages from the section of the PDF document is now resolved.
  • #I442052 - Invalid font style is no longer returned while extracting text lines from the PDF document.
  • #I440951 - The file size is now reduced properly during long-term verification with an external signature.
  • #I443203 - The unwanted characters are no longer returned during text extraction from the PDF documents.
  • #I437304 - Preservation issue no longer occurs while setting and flattening numeric values in the text box field.
  • #I436739 - Font color is not applied properly to the text box field items is now resolved.
  • #I438772 - Radio button field is now flattened properly in a specific PDF document.
  • #I440678 - PDF signature validation time taken is now reduced while validating the signature.
  • #F180498 - “IsLTVEnabed” no longer returns incorrect results while verifying signature validation for specific PDF documents.
  • #F180445 - “IsValid” API is not working properly in “TimeStamp” for invalid URIs is now resolved.
  • #I441102 - Fixed an issue where invalid revocation names were being displayed in the VRI dictionary when creating a long-term validation PDF.

SfAutoComplete

Features

  • #I427599, F179752 - Added support for the Text property to retrieve the user-submitted text in the SfAutoComplete control.
  • #I428641, F179895, I433599, I439356 - Added support for customizing drop down (suggestion) items using the ItemTemplate property in the SfAutoComplete control.
  • #I427599 - Added support for the Completed event in the SfAutoComplete control to allow users to finalize text entry by pressing the return key on the keyboard.

SfBarcodeGenerator

Features

  • #F38893 - Support to export barcodes to image formats like JPEG and PNG.

SfCalendar

Features

  • Provided the support to customize cells using the template and template selector for all view modes.
  • Provided support to hide and show the action buttons. You can confirm and unconfirm the selected date, dates, and range in all view modes.
  • Provided support for hiding and showing the today button, which easily navigates the current view to the today view.
  • Supports a special day predicate that allows displaying different icon shapes on month cells while the date is special date.

Breaking changes

  • The calendar API’s type changed from not necessary nullable to non-nullable.

SfCartesianChart

Features

  • The chart axis now has auto-scrolling delta support, which allows for showing a specific range of data in the chart at the start or end position.
  • The category axis supports value-based series plotting , which is used to determine how the items in a category axis are arranged.
  • Now, the cartesian charts can be exported to image formats like JPEG and PNG. This will make it easier for users to share their charts with others.
  • The addition of several new series types to the Cartesian Chart control, which will provide users with more ways to visualize their data. The following series types are now available:
    • Range Column : It allows the visualization of data points with range columns, making it easy to identify patterns and trends and compare different data sets.
    • Bubble : It is a visually appealing way to represent data with multiple dimensions, as the size of the bubbles indicates an additional data dimension.
    • Stacked Column : It represents data values in a stacked column format, where the columns are stacked on top of each other to indicate the cumulative value of the data points.
    • Waterfall : It visually represents the cumulative effect of a set of positive and negative values.
    • Box and Whisker : It used to visualize datasets by summarizing their distribution and identifying potential outliers.
    • Error Bar : This series provides a graphical representation of the uncertainty associated with reported values, which helps to identify potential measurement deviations.

SfCircularChart

Features

  • Provided support for the radial bar chart type, which compares categories using circular shapes.
  • Now, the circular charts can be exported to image formats like JPEG and PNG. This will make it easier for users to share their charts with others.

SfComboBox

Features

  • #I427599, F179752 - Added support for the Text property to retrieve the user-submitted text in editable mode of the SfComboBox control.
  • #I428641, F179895, I433599, I439356 - Added support for customizing drop down (suggestion) items using the ItemTemplate property in the SfComboBox control.
  • #I427599 - Added support for the Completed event in the editable mode of the SfComboBox control to allow users to finalize text entry by pressing the return key on the keyboard.

SfDataForm

Features

  • Floating label layout: Support for the floating label layout was made available, providing an easy-to-use and aesthetically pleasing approach to interact with the data form input editors and comprehend the function of each field. The Floating label layout supports built-in editors such as text, password, multi-line, autocomplete, and combo box.

  • Keyboard interaction: Provided keyboard interaction support for MacCatalyst, Android, and iOS.

Breaking changes

Class name Existing API name New API name Exisiting type New type

DataFormItem

LeadingLabelIcon

 LeadingView ImageSource View

SfFunnelChart

Features

  • Now, the funnel charts can be exported to image formats like JPEG and PNG. This will make it easier for users to share their charts with others.

SfListView

Features

  • #I427702 - Users can customize the mouse hover background of the ListViewItem using the visual state manager based on the visual states set from the code. The applicable visual states are Normal and PointerOver.

Bug Fixes

  • #I445439 - Now, the ScrollbarVisibility property is working properly on Android, iOS, and Mac platforms.

SfMaps

Features

  • #F40262 - Provides panning event support to get the screen coordinates, and it also provides support to identify whether the panning started or was completed.
  • Tapped event support - Provides tapped event support to get the screen coordinates.
  • Get latitude and longitude from pixel point support - Provides panning event support to convert screen coordinates to their corresponding map latitude and longitude values.

Bug fixes

  • #I432979 - Now the ShapeSelected event trigger properly when a map shape is selected or deselected.
  • #I432998 - Now, the selected shape will be cleared when we add a new shape source or the same shape source.
  • #I435046 - Now the SfMaps control will not go blank while zooming and the tiles will be redrawn properly while zooming/panning.
  • #I439185 - Now the SfMaps control will not be blank When loading the application.

SfMaskedEntry New

The Masked Entry is an advanced version of the input control that restricts the input of certain characters by using a mask pattern. This control is used to create a template for providing information such as telephone numbers, email IDs, IP addresses, product keys, and so on.

Key features

  • Easily mask input values.
  • Use simple or regex masking types with either a fixed or variable length.
  • Format input values with prompts, literals, or both.
  • Customize the prompt characters to use them as input in the absence of user input.

SfPdfViewer Preview

Features

  • Support to render the unsupported annotations and form fields in a non-interactive way.
  • Support for the document outline navigation.
  • Support for built-in dialogs to notify loading errors and get a password from the user for password-protected PDF documents.
  • Support for table-of-contents and hyperlink navigations.
  • Support for searching text in PDF documents.
  • [macOS, Windows] Support to interact with the PDF viewer using keyboard shortcuts.
  • Support the right-to-left (RTL) flow direction for users working with RTL languages like Hebrew, Arabic, and more.
  • Support for localization of all static text.

Known issues

  • #13342 - [macOS, iOS] The contents of the built-in tools such as dialogs and outline view are not visible in .NET 7.0 when the flow direction of the viewer is right-to-left (RTL).
  • [Android] Zoom doesn’t occur when pinched over the table of contents of a PDF document.

SfPopup New

The Popup control is an alert dialog that displays content in a separate window on top of the current screen. The control can be displayed in any desired position.

  • Position: Display a popup at any desired location on screen.
  • Relative to view: Display a popup in positions relative to any control on the screen.
  • Full-screen mode: Display a popup with full-screen width and height to show large content.
  • Auto size: Automatically adjust the popup’s width and height based on the content loaded in it.
  • Different layouts: Choose from default layouts, such as one-button layout and two-button layout, to display simple, minimal information.
  • Template support: Load any view as the header, footer, and content through a template.
  • Modal mode: Make the popup a modal dialog to prevent interactions with the underlying screen until certain actions are performed

SfPyramidChart

Features

  • Now, the pyramid charts can be exported to image formats like JPEG and PNG. This will make it easier for users to share their charts with others.

SfShimmer New

The Syncfusion .NET MAUI Shimmer control allows you to enhance the user experience of an application by providing a modern shimmer effect while data is being loaded in the background. By utilizing this control, an application can improve its responsiveness and keep the user engaged while content is being fetched.

Key Features

  • For easy integration, there are seven built-in shimmer types.
  • Support for custom shimmer types.
  • Shimmer wave effects from multiple directions.
  • Supports wave width, repeat count, animation duration, and wave color.

SfTextInputLayout

Features

  • Now, Added support for SfMaskedEntry control.

XlsIO

Features

  • Provided support for creating and modifying table slicers.
  • Date occurring conditional formatting is now supported in Excel to PDF conversion.
  • Linear and Radial gradient fill for cells and shapes are now supported in Excel to PDF conversion.

Bug Fixes

  • #F180523 - Text color applied through RGB value in HTML String is now applied properly while resaving the Excel document.