Essential Studio for MAUI Release Notes

v30.1.37
June 25, 2025
Test Results: 159849 Success , 0 Failure

Common

Breaking Changes

A new color picker control has been implemented in Syncfusion.Maui.Inputs. It is necessary to include the following additional NuGet packages for Syncfusion.Maui.Inputs:

  • Syncfusion.Maui.Buttons
  • Syncfusion.Maui.Popup
  • Syncfusion.Maui.Sliders

DocIO

Features

  • #I84570, #I149806, #I73532, #I104716, #I105049, #I109548, #I119864, #I124725, #I130014, #I137039, #I137196, #I323992, F165479, F168737, #I652765, #I658111 - Provided support to create and remove editable ranges in protected DOCX format documents.
  • #I635778, #I214139, #I665210, #I624912, #I583370, #F141869, #FB26929 - Added support to create list number formats including Arabic, Hebrew, Chinese, and Thai in DOCX format documents and preserve them during Word-to-PDF and image conversions.
  • #I376950, #I411898, #I465126, #I679498, #I297755, #I301645, #I307279, #I349118, #I176036, #I184228, #I216695, #I331649, #I680106, #I86205, #I107655, #I182993, #I201718, #I209411, #I225246, #I311779, #I317812, #I345122 - Added support to preserve shape fill formats such as gradients, transparency, and pattern fills during Word-to-PDF and image conversions.
  • #I70284, #I144361, #I160658, #I188244, #I201718, #I202261, #I206374, #I212424, #F137571 - Recolor effects like grayscale, sepia, and color tone adjustments are now preserved during Word-to-PDF and image conversions.
  • #I293751, #I310315, #I337547, #I367467, #I469762, #I496627, #I650620, #F176420 - Drawing canvas and its contents are now preserved when converting Word documents to PDFs and images.
  • Font substitution is now supported inside charts, allowing users to configure fallback fonts when the original fonts are unavailable during Word to PDF and image conversions.
  • Provided fallback font support for Unicode characters in charts to preserve multilingual content during Word-to-PDF and image conversions.
  • Improved preservation of EMF and WMF metafile images as searchable content during Word-to-PDF conversions.

Breaking Changes

  • Added the assembly of “Syncfusion.PDF.NET.dll” as a dependency of “Syncfusion.MetafileRenderer.NET.dll” in the build and NuGet package.

PDF

Features

Presentation

Features

  • Font substitution is now supported inside charts, allowing users to configure fallback fonts when the original fonts are unavailable during PowerPoint to PDF and image conversions.
  • Provided fallback font support for Unicode characters in charts to preserve multilingual content during PowerPoint-to-PDF and image conversions.
  • Improved preservation of EMF and WMF metafile images as searchable content during PowerPoint-to-PDF conversions.

Breaking Changes

  • Added the assembly of “Syncfusion.PDF.NET.dll” as a dependency of “Syncfusion.MetafileRenderer.NET.dll” in the build and NuGet package.

SfAccordion

Bug Fixes

  • #I731608 - The SfAccordion now loads properly when the ItemSpacing and ExpandMode properties are configured through global styles.

SfAIAssistView

Features

  • Added support to display an empty view when no conversation is initiated in the AI AssistView.
  • Added support to add a generic collection of models without deriving from IAssistItem.

SfAutocomplete

Features

  • #FB51731, #I699753, #I685621, #I674566, #I660752, #I699144, #I636548 - Provided support for the ValueChanged event, this event triggers when the value of the SfAutocomplete changes, allowing users to handle the event and perform custom actions.

  • #FB44686, #I555903 - Provided support for dropdown shadow visibility, this feature allows users to control the visibility of the dropdown shadow, enhancing the visual appearance of the SfAutocomplete control.

SfBadgeView

Breaking Changes

Enhanced the behavior of the BadgeView by improving its alignment when the BadgeAlignment property is set to Start, Center, or End in .NET MAUI.

SfCalendar

Features

  • FB52708 - Provided template support, allowing users to enhance the selection view by integrating their own custom templates.

SfCarousel

Features

  • #FB64494, #I675915 - Provided support for the Virtualization in the SfCarousel control default mode, efficiently handling large datasets by loading only visible items and recycling views as users scroll.

SfCartesianChart

Bug fixes

  • #I730654, #FB68132 - Resolved an issue where stacked column segments were incorrectly positioned when multiple series contained different sets of X-values.

SfChat

Features

  • Added support to update the delivery states of messages.

SfColorPicker New

The Syncfusion .NET MAUI Color Picker is a versatile UI component that allows users to select a color from various color palettes or a spectrum. It is particularly useful in scenarios involving design, drawing, or customization within .NET MAUI applications.

Features

  • Color Modes: Easily switch between the color modes such as Palette and Spectrum for diverse color selection options.
  • Custom Colors: Users have the flexibility to add or remove their own custom colors to enhance personalization.
  • Direct Input: Supports direct input of color values in RGB, HSV, and HEX formats for precise color specification.
  • Transparency Adjustment: Allows adjustment of the transparency level of a selected color to meet specific design requirements.
  • Recent Colors: Automatically records and displays a list of recently selected colors for quick reuse and improved workflow efficiency.
  • Theme Adaptation: Seamlessly adapts to the system or app’s current theme, ensuring visual consistency across the user interface.
  • No Color Option: Includes an option to select No Color, allowing users to fully remove any previously selected color.
  • Interaction States: The Color Picker can be programmatically toggled to prevent or allow user interaction, offering developers greater control over UI behavior.
  • Inline mode: The inline feature embeds the color picker directly within the UI layout, avoiding the need for popups.

SfComboBox

Features

  • #FB51731, #I699753, #I685621, #I674566, #I660752, #I699144, #I636548 - Provided support for the ValueChanged event, this event triggers when the value of the SfComboBox changes, allowing users to handle the event and perform custom actions.

  • #FB44686, #I555903 - Provided support for dropdown shadow visibility, this feature allows users to control the visibility of the dropdown shadow, enhancing the visual appearance of the SfComboBox control.

SfDataForm

Features

  • I649570 - Provided support to show or hide error messages programmatically.
  • Added support to get and set DataFormItem values without requiring a data object.

SfDataGrid

Features

  • #FB53931 - Provided support for a record template view to represent additional information for a row.
  • #FB64440 - Provided support to load custom views into the column drag view.
  • #FB40170 - Provided support for clipboard operations, including cut, copy, and paste within SfDataGrid and between other applications such as Notepad and Excel documents.
  • Provided serialization and deserialization support to transfer properties between SfDataGrid instances.
  • Provided support to customize the visibility of details view indent cells and empty grid view definitions.

SfDatePicker

Features

  • I517767,I555690 - Provided Looping support, allowing users to automatically navigate from the last item back to the first item in the list of the SfDatePicker control.
  • Provided PopupSize support, allowing users to customize the size of the date picker within the popup according to their desired dimensions.
  • FB52708 - Provided Template support, allowing users to integrate custom templates for the header, footer, and column header of the SfDatePicker Control.

Bug fixes

  • I737872 - Fixed the issue where ColumnHeader Text properties were not working when initially set on SfDatePicker.

SfDateTimePicker

Features

  • I517767,I555690 - Provided Looping support, allowing users to automatically navigate from the last item back to the first item in the list of the SfDateTimePicker control.
  • Provided PopupSize support, allowing users to customize the size of the datetime picker within the popup according to their desired dimensions.
  • FB52708 - Provided Template support, allowing users to integrate custom templates for the header, footer, and column header of the SfDateTimePicker Control.

SfDockLayout New

The SfDockLayout control in .NET MAUI is a flexible and powerful layout panel that arranges its child elements by docking them to the top, left, right, and bottom of the container. Child elements are docked in the order they are declared, and the layout automatically arranges them accordingly. This layout is ideal for creating structured UIs such as toolbars, navigation drawers, headers and footers, side panels, and main content regions.

Features

  • Dock position: Child elements can be precisely positioned at the top, left, right, or bottom. This feature provides unparalleled control over the elements’ alignment, essential for creating well-structured UIs.
  • Adaptive expansion of the last child: The layout can automatically expand the last child element to occupy any unused area within the container. This feature is crucial for dynamic layout designs that require fluid adaptability across different screen sizes and orientations.
  • Customizable spacing: Spacing between docked elements is customizable, allowing developers to manage the layout’s aesthetic by adjusting horizontal and vertical spaces as needed.

SfImageEditor

Bug fixes

  • Resolved a regression where the ImageEditor control failed to render on .NET for Android using Native embedding when not placed within a parent layout.

SfKanban

Features

  • Added multi-category workflow support in Kanban for smoother card transitions and improved workflow organization.

SfListView

Features

  • Added support to display borders around list items, including options to configure border thickness, color, and corner radius.
  • Added support for applying fade effects to list items during scrolling, enhancing the visual experience.

SfNumericEntry

Features

  • #FB63593, #I707244, #I677551, #I646894 - Provided support for the Updown button order in the SfNumericEntry control. This feature allows users to change the order of the up and down buttons to up then down or down then up in the entry field.

SfPdfViewer

Features

  • #I603122,#I604312 - Provided support for adding a view as a custom stamp annotation in PDFs. The view is converted to an image during save and embedded into the document. This can be used to stamp dynamic UI elements such as checklists, approval stamps, or QR codes for official workflows.

SfPicker

Features

  • I517767,I555690 - Provided Looping support, allowing users to automatically navigate from the last item back to the first item in the list of the SfPicker control.
  • Provided PopupSize support, allowing users to customize the size of the picker within the popup according to their desired dimensions.
  • FB52708 - Provided Template support, allowing users to integrate custom templates for the header, footer, and column header of the SfPicker Control.

Bug fixes

  • I737251 - Fixed the Issue when setting Height explicitly causes selection becomes inconsistent in SfPicker.

SfPopup

Bug Fixes

  • #I617615 - [Android] Resolved an issue that impacted the initial loading performance of PopupView.

Breaking Changes

  • [iOS] When the UseSafeArea property of ContentPage is set to false, the Popup will now appear from the status_bar, covering the entire device screen.

SfScheduler

Features

  • I626650 - Provided support to customize the “No Events” text in AgendaView.
  • I641891- Added FirstDayOfWeek support for the Date Picker in Scheduler Header.
  • I692844 - Enhanced performance in Month View Appointment Template when handling a large number of spanned and intersecting appointments.
  • Improved rendering performance when displaying multiple resources in timeline views.
  • I689742 - Enhanced Tapped, DoubleTapped, and LongPressed events and commands to include the corresponding cell date when an appointment is tapped.

Bug fixes

  • I736428 - Long-press at SchedulerElement.SchedulerCell is now triggered when drag and drop is enabled.

Breaking changes

Appointment Drag-and-Drop Interaction with Long Press: Dragging an appointment now requires a long press instead of dragging on touch. This change prevents conflicts where swipe gestures would not work on appointments when drag-and-drop was enabled.

SfSegmentedControl

Features

  • Provided support to enable or disable the ripple effect animation on item selection when segment item template added.

SfTimePicker

Features

  • I517767,I555690 - Provided Looping support, allowing users to automatically navigate from the last item back to the first item in the list of the SfTimePicker control.
  • Provided PopupSize support, allowing users to customize the size of the time picker within the popup according to their desired dimensions.
  • FB52708 - Provided Template support, allowing users to integrate custom templates for the header, footer, and column header of the SfTimePicker Control.

SfToolbar

Features

  • Provided support to highlight the selected toolbar item.

SfTreeView

Features

  • Added support to reorder items by dragging and dropping them.
  • Improved the loading performance of the SfTreeView.

XlsIO

Features

  • Auto Fill and Fill Series support is provided to programmatically populate Excel cell ranges based on patterns, sequences, or trends, minimizing manual input.
  • Font substitution is supported to allow configuration of fallback fonts when the original fonts are unavailable during chart-to-image conversion, ensuring visual consistency.
  • Fallback font handling for Unicode text is implemented during chart-to-image conversion, enabling proper rendering when the default fonts lack the necessary glyphs.
  • Preservation of EMF and WMF metafile images as searchable content during Excel to PDF conversion is supported.

Bug Fixes

  • #I735455 - Cell value is accurately returned by the Range.Value property when the number contains high-precision digits.
  • #I737657 - The IsFiltered property is updated properly when clearing a filter contains equal to operator.
  • #I736030 - Hyperlinks are removed properly when performing clear operations in worksheet range.

Breaking Changes

  • Added the assembly of “Syncfusion.PDF.NET.dll” as a dependency of “Syncfusion.MetafileRenderer.NET.dll” in the build and NuGet package.

Test Results

Component Name Test Cases Passed Failed Remarks
SfAIAssistView 119 119 0 All Passed
SfAutocomplete 262 262 0 All Passed
SfBarcodeGenerator 1763 1763 0 All Passed
SfButton 104 104 0 All Passed
SfCalendar 2345 2345 0 All Passed
SfCards 235 235 0 All Passed
SfCarousel 203 203 0 All Passed
SfCharts 521 521 0 All Passed
SfCheck Box 154 154 0 All Passed
SfComboBox 344 344 0 All Passed
SfDataForms 3324 3324 0 All Passed
SfDataGrid 2357 2357 0 All Passed
SfExpander 215 215 0 All Passed
SfGauge 1184 1184 0 All Passed
SfImageEditor 3393 3393 0 All Passed
SfKanban 204 204 0 All Passed
SfListView 4607 4607 0 All Passed
SfMaps 1229 1229 0 All Passed
SfMaskedEntry 174 174 0 All Passed
SfNavigationDrawer 125 125 0 All Passed
SfNumericEntry 233 233 0 All Passed
SfNumericUpDown 233 233 0 All Passed
SfPdfViewer 14271 14271 0 All Passed
SfPicker 445 445 0 All Passed
SfPopup 1240 1240 0 All Passed
SfProgressBar 624 624 0 All Passed
SfRadialMenu 200 200 0 All Passed
SfRadioButton 183 183 0 All Passed
SfRating 200 200 0 All Passed
SfRotator 1194 1194 0 All Passed
SfScheduler 10977 10977 0 All Passed
SfSegment 338 338 0 All Passed
SfShimmer 371 371 0 All Passed
SfSlider 292 292 0 All Passed
SfSwitch 131 131 0 All Passed
SfTab View 1620 1620 0 All Passed
SfTextInputLayout 199 199 0 All Passed
SfTreeMap 454 454 0 All Passed
SfTreeView 233 233 0 All Passed
DocIO 16250 16250 0 All Passed
Metafilerenderer 1701 1701 0 All Passed
PDF 12431 12431 0 All Passed
Presentation 55865 55865 0 All Passed
XlsIO 17302 17302 0 All Passed