Essential Studio for MAUI Release Notes

v23.2.4
November 20, 2023

Common

Features

  • .NET 8 support - The Syncfusion controls are compatible with both .NET 7.0 and .NET 8.0 and now officially support .NET 8.0.

Breaking changes

  • Starting from Volume 3 2023 Service Pack (v23.2.4), Syncfusion .NET MAUI controls no longer support .NET 6.0. Upgrade your projects to either .NET 7.0 or .NET 8.0.

DocIO

Bug Fixes

  • #I515859- Image is now preserved properly while saving a DOCX format document.

PDF

Features

  • Added support to set polygon points in PdfLoadedPolygonAnnotation and PdfPolygonAnnotation.
  • #F180535 - Added support for retrieving the Certificate Revocation List (CRL) with revocation serial numbers, revoked dates, and revocation status from embedded CRLs during signature validation.
  • #F184954 - Provided support to include certificates in the Document Security Store (DSS) during Long-Term Validation (LTV).
  • #F184644 - Added support for retrieving certificates from the Document Security Store (DSS).

NOTE

When inserting images with a white background into PDFs, an unexpected appearance of gray may occur. This issue has been identified within the SkiaSharp library. This issue is observed specifically when the application targets .NET 8 and is deployed on macOS or iOS environments. Refer to this link for more details.

Bug Fixes

  • #I520965 - Resolved an issue where the destination was not behaving as expected after an update to the destination array functionality in the file link annotation.
  • #I516937 - Resolved an exception that occurred while converting Word to PDF, specifically when handling Arabic text in italic style.
  • #I518050 - The Index outside the bounds of the array exception no longer occurs when compressing a particular PDF document.
  • #I518514 - The Null Reference exception will no longer occur when using the loaded document StructureElement for a particular document.
  • Fixed the issue where the border width is not updated when exporting the annotation in Xfdf format.

SfAccordion

Features

  • Users can customize the header background and header icon color of the AccordionItem using the visual state manager based on the visual states set from the code. The applicable visual states are Normal, PointerOver and Focused.

SfButton

Breaking changes

  • In earlier releases, the default value of text color in SfButton was Colors.Black. However, starting from this release, the default value of text color in SfButton has been changed to Colors.White.

NOTE

The gradient colors used as a background are not functioning as expected because of a framework-level issue. This issue is specifically related to the incorrect rendering of gradient color on iOS and macOS when clipping a view. Refer to this link for more details.

SfCartesianChart

Bug fixes

  • #F47080 - The tooltip drawing at the edge data points of the chart has been improved.

  • #F46696 - Provided a font customization option for charts in embedded applications.

SfDataGrid

Breaking changes

#FB46357 - Replaced the custom derived controls with the framework controls in datagrid cell renderers. This change helps prevent unintended styling when applying implicit styling globally. Please find the API changes below,

Existing class New class
Label SfDataGridLabel
Image SfDataGridImage
Entry SfDataGridEntry
ContentView SfDataGridContentView

Features

  • #F184171 - Provided the helper methods to the MAUI DataGrid. These methods can be accessed from the DataGrid class such us PointToCellRowColumnIndex, GetRecordAtRowIndex, GetCellValue, etc.
  • #I492234 - Enhanced support for refreshing custom summary calculations based on their dependent columns when the cell value of the dependent column changes.

SfExpander

Features

  • Users can customize the header background and header icon color of the Expander using the visual state manager based on the visual states set from the code. The applicable visual states are Normal and PointerOver.

SfImageEditor

Bug fixes

  • #I518126 - Fixed the ImageEditor Save method file location issue.
  • #I514793 - The Visibility of the ImageEditor toolbar items will work properly even after editing the image.

SfPopup

Bug Fixes

  • #I517607 - The application no longer crashes when opening a popup in the OnAppearing event.

SfSegmentedControl

Breaking changes

Class name Existing API name New API name

SfSegmentedControl

 SelectionSettingsProperty SelectionIndicatorSettingsProperty

SelectionIndicatorSettings

 SelectionModeProperty SelectionIndicatorPlacementProperty

SfTextInputLayout

NOTE

Manually input values don’t update the Stroke Value due to an issue at the framework level in .NET 8.0. This problem arises because the manual value doesn’t override an implicit style. However, you can resolve this by setting the Stroke Value using the Visual State Manager (VSM) through Style. Refer to this link for more details.

Visual Studio Extensions

Features

  • Provided the .NET 8.0 support to the Syncfusion MAUI Template Studio and MAUI Toolbox.

Breaking changes

  • Removed the .NET 6.0 support into the Syncfusion MAUI Template Studio and MAUI Toolbox.

XlsIO

Bug Fixes

  • #I515434 - Object reference exception is no longer thrown while resaving the Excel document with empty chart shape.