Essential Studio for MAUI Release Notes

v28.1.33
December 12, 2024

Important Announcement: Changes to Open-Source Control Support After Volume 1 2025 (March 2025)

After the roll out of our Volume 1 2025 release in mid-March 2025, there will be changes to how updates for open-source controls are delivered under the Syncfusion Toolkit for .NET MAUI.

Discontinuation of Bug Fixes and Feature Enhancements in Syncfusion Packages

  • After the Volume 1 2025 release, bug fixes and feature enhancements for open-source controls will no longer be available in the Syncfusion .NET MAUI Controls package.
  • These updates will exclusively be provided in the Syncfusion Toolkit for .NET MAUI package moving forward.

Syncfusion.Maui.Toolkit as a Dependent Assembly

  • The Syncfusion.Maui.Toolkit package will be added as a dependent assembly for Syncfusion .NET MAUI controls that utilize open-source controls from the toolkit.

Action Required

Developers are strongly encouraged to transition to the Syncfusion Toolkit for .NET MAUI to continue receiving updates, bug fixes, and feature enhancements for the open-source controls.

Syncfusion Toolkit GitHub Repository

Syncfusion Toolkit Documentation

Thank you for your cooperation and continued support as we adapt to serve the .NET MAUI community better.

DocIO

Features

  • Provided support to preserve the WMF images in the Word document, during Word to PDF or image conversion.
  • Enhanced the multicolumn balancing algorithm in Word to PDF conversion, particularly for documents containing multicolumn layouts with section breaks.

Bug Fixes

  • #I656800 - Shape within the table cell is now preserved properly while converting a Word document to PDF.

PDF

Features

  • F194287 - Added support to include the signed date in the signature within the PDF document.
  • I612814 - Added support to flatten specified annotation types in the PDF document.
  • I610124 - Added support for setting text alignment in the PdfLoadedCombobox field within the PDF document.
  • I576424 - Added support for exporting newly added annotations in the PDF.

Bug Fixes

  • I661319 - Fixed the issue where bounds were not retrieved properly while extracting text.
  • I652150 - Fixed an issue where a preservation issue occurred while flattening the textbox field.
  • I650628 - Fixed a preservation issue that occurred while drawing templates on the PDF.
  • I649774 - Fixed an issue where text preservation was compromised when creating a template from a PDF document.
  • I652775 - Fixed the issue where the new line character was not proper while importing form fields in JSON format.
  • I652751 - Resolved the issue where border width was not properly returned for a textbox field.
  • I526704 - Resolved the native AOT warning that occurred in compression and PDF.
  • I653965 - Fixed the issue where a preservation problem occurred while parsing an empty style tag.

Breaking Changes

  • The PdfExportAnnotationCollection API now supports both PdfLoadedAnnotation and PdfAnnotation objects with the updated Add method. Additionally, the Indexer now returns a PdfAnnotation object instead of a PdfLoadedAnnotation object.

Presentation

Features

  • Provided support to preserve the WMF images in the PowerPoint presentation, during PowerPoint to PDF or image conversion.

Bug Fixes

  • #I659561, #I660097, #I660582 - Picture within the group shape is now replaced properly.

SfAIAssistView

Features

  • Added support to display the Stop responding view when a new request is initiated, allowing users to easily cancel or stop the response.
  • Provided support to customize the appearance and layout of the editor view by using EditorViewTemplate property.

SfAutocomplete

Features

  • #FB40880, #I436011 - Enhanced user accessibility and interaction by providing keyboard navigation support.
  • #FB58927, #I188880 - Provided support for the Clear method, allowing users to remove all selected items by invoking this method.

SfCartesianChart

Breaking Changes

  • The ChartSeries class now inherits from Element instead of BindableObject to support theme updates and improve chart customization.
  • Improved text alignment for LineAnnotation to ensure precise and consistent positioning.

SfCheckBox

Features

  • F51765- Provided support to adjust the content spacing in the CheckBox control.

SfComboBox

Features

  • #FB40880, #I436011 - Enhanced user accessibility and interaction by providing keyboard navigation support.
  • #FB58927, #I188880 - Provided support for the Clear method, allowing users to remove all selected items by invoking this method.

SfDataGrid

Breaking changes

  • #I486900 - The grid line color and stroke thickness for column headers and stacked header rows can now be customized using the DataGridStyle.HeaderGridLineColor and DataGridStyle.HeaderGridLineStrokeThickness properties.

Features

  • #FB59438 - Provided support for select single and multiple cells both interactively and programmatically.
  • #FB49889 - Provided support for swiping rows interactively in both left and right directions.
  • #FB44025 - Provided support for line break mode in the column header.
  • #FB56838 - Provided support to customize column name for each group in the group caption summary text.
  • #FB59571 - Provided support to export the SfDataGrid to Excel and PDF documents with alternate row background colors.
  • Provided support to apply selection to an entire column by interacting with the column header cell.
  • Provided support to draw images in the image column using the LoadUIView property.
  • Provided support for handling complex properties in the SfDataGrid.
  • Provided ripple effect support to numeric and navigation buttons in the SfDataPager.

SfImageEditor

Features

  • #F60810 - The Toolbar items are optimized for improved visualization, enhancing the control’s initial loading performance.
  • #I654895 - Improved image saving by generating unique filenames with timestamps, ensuring smooth and conflict-free saving of edited images across all platforms.

Bug fixes

  • #I632592- Cropping high-resolution JPEG images now display correctly on iPhone 15 and iPad devices.

SfLinearGauge

Features

  • #I606939 - The .NET MAUI LinearGauge Control provides support to render ticks over the range on the scale to improve visualization.

SfMaps

Features

  • The .NET MAUI Maps Control includes templates for customizing legends, offering flexibility to match specific styles and requirements.

Bug fixes

  • #F195073 - Now, the app will not throw ObjectDisposedException, when navigating to the page having MapTileLayer for the second time.

SfNumericEntry

Feature

  • #FB45300, #I482469 - Added support for UpDownButtonAlignment, enabling users to adjust the alignment to Left, Right, or Both.

SfPdfViewer

Bug fixes

  • #I650266 - [WinUI] Zoom and page alignment now work properly when switching page layout modes and resizing.
  • #I650304 - The application no longer freezes when the PDF is unloaded.
  • #I650279 - Ink annotation now works properly after using undo and redrawing.
  • #I649908 - PDF Viewer now displays the correct page layout mode when set in code-behind.
  • #I634990 - Horizontal alignment of PDF pages is now maintained in FitToPage zoom mode.
  • #I643139 - System.NullReferenceException no longer occurs when saving a particular PDF file.
  • #I643727 - The Annotations Toolbar now works properly after opening the custom signature pad.
  • #I642478,#I642482 - The application no longer crashes with System.ArgumentOutOfRangeException when loading specific document.
  • #I642484 - The application no longer crashes with System.InvalidOperationException when loading specific document.
  • #I637222 - Text with longer words in the toolbar is now shown properly.
  • #I637717,#I637733 - Sticky note editor scrolling and keyboard are now working properly.
  • #I649357 - Free text annotation is now removed in a single undo operation.
  • #F62197 - Form Fields texts are now displayed properly when loading specific documents.

Breaking changes

  • The font files for Handlee, Boogaloo, PinyonScript, and KaushanScript will now be added directly to the application when the PdfViewer NuGet package is installed.

SfPicker

Bug Fixes

  • #I649972 - Resolved the issue on macOS and iOS platforms where picker items were not displayed when the SelectedIndex property was set to -1 in a single-item source.

SfRadialGauge

Features

  • #I606939 - The .NET MAUI RadialGauge Control provides support to render ticks over the radial axis to improve visualization.

SfRadioButton

Features

  • F51765- Provided support to adjust the content spacing in the RadioButton control.

SfScheduler

Bug fixes

  • #I655868 - The leading and trailing dates text color issue in Right-to-Left CalendarType (eg: UmAlQura), has now been resolved.

SfShimmer

Bug Fixes

*#I651463 - Resolved the issue where the shimmer effect did not render correctly when a ContentView was added inside a CustomView.

SfTabView

Features

  • F44879- Provided support for image size customization in the .NET MAUI TabView control.

Breaking changes

  • The ScrollButtonForegroundColor and ScrollButtonBackgroundColor have been updated to ScrollButtonColor and ScrollButtonBackground.

SfTreeMap

Features

  • F58796 - The TextColor for leaf items will update based on their background luminosity when set to the default value, displaying black for light backgrounds and white for dark backgrounds.

XlsIO

Features

  • Provided support for preserving WMF images during an Excel to PDF and image conversions.
  • I649053 - Provided support for decrypting individual items with different passwords in a protected ZIP file.

Bug Fixes

  • I655057 - Exception no longer occurs when creating a table with the sheet name contains True or False.
  • I639240 - Category labels are now preserved correctly when the major data unit is set to Auto when converting an Excel to PDF.
  • I26423 - Pareto chart line color is now rendered properly when converting an Excel document to PDF.
  • Hyperlinks in the threaded comments are now preserved correctly when resaving an Excel document.
  • Corruption no longer occurs when the value axis in chart contains NaN values.
  • Threaded comment replies are now rendered properly when resaving an Excel document.
  • When converting an Excel file to PDF, empty chart legend area is now rendered correctly.

Breaking Changes

  • The IConnection.ConncetionId API is deprecated and will be removed in v30.x. We recommend using this API IConnection.ConnectionId instead.
  • The ExternalConnection.RefershedVersion API is deprecated and will be removed in v30.x. We recommend using this API ExternalConnection.RefreshedVersion instead.
  • The ExternalConnection.password API is deprecated and will be removed in v30.x. We recommend using this API ExternalConnection.Password instead.