Essential Studio for MAUI Release Notes

v25.1.35
March 15, 2024

Common

New Controls

The below controls have been added newly.

  • Chat
  • ParallaxView
  • PolarChart
  • RadialMenu
  • Rotator
  • StepProgressBar
  • TreeMap

Production-ready controls

The following .NET MAUI controls have been developed to meet industry standards and are now marked as production-ready in this 2024 Volume 1 release:

  • Cards
  • Carousel
  • Navigation Drawer
  • Pull To Refresh
  • Sunburst Chart
  • Switch

Visual theme support

The Syncfusion .NET MAUI controls now support light and dark themes. This is key-based theming for light and dark themes, which uses a separate ResourceDictionary class for each theme and loads the resources with the DynamicResource markup extension.

Breaking Changes

  • All Syncfusion controls have been updated to the Material 3 UI and colors.

DocIO

Features

  • #I370047, #I515686, #I107555, #I108644, #I116892, #I237097, #I237965, #I257681, #I336732, #F163416 - Now, include \c and \a switches while updating the Table of Contents (TOC) to build table of figures in the Word document.
  • #I565373, #I521060 - Added support to preserve charts with shapes in Word to PDF or image conversion.
  • Added support for wrapped axis titles in charts during Word to PDF or image conversion.
  • Provided support for series line cap formatting in charts during Word to PDF or image conversion.
  • Added support for line dash style formatting in scatter and line charts during Word to PDF or image conversion.
  • Added support for multilevel category labels in charts during Word to PDF or image conversion.
  • Provided support for 100% stacked line charts during Word to PDF or image conversion.
  • Added support for manually positioned chart titles during Word to PDF or image conversion.

PDF

Features

  • Added support for remote goto actions in PDF documents.
  • Added support to identify and optimize identical resources when merging PDF documents.
  • #FB45417 - Added support for converting XPS to PDF in the .NET MAUI platform.

Bug Fixes

  • #I554285 - Fixed an issue where sticky note comments were not being saved properly once the PDF was updated.
  • #I556724, #I555734 - Fixed issue where text extracted from a PDF document was not being returned properly.

Presentation

Features

  • #I520747, #F176520 - Provided APIs to crop pictures in PowerPoint Presentations, similar to the crop options in Microsoft PowerPoint.
  • #I548180 - Provided an API overload ISlides.Add(ISlide clonedSlide, PasteOptions pasteOptions) to add the cloned slide in the PowerPoint Presentation.
  • #I565373, #I521060 - Added support to preserve charts with shapes in PowerPoint to PDF or image conversion.
  • Added support for wrapped axis titles in charts during PowerPoint to PDF or image conversion.
  • Provided support for series line cap formatting in charts during PowerPoint to PDF or image conversion.
  • Added support for line dash style formatting in scatter and line charts during PowerPoint to PDF or image conversion.
  • Added support for multilevel category labels in charts during PowerPoint to PDF or image conversion.
  • Provided support for 100% stacked line charts during PowerPoint to PDF or image conversion.
  • Added support for manually positioned chart titles during PowerPoint to PDF or image conversion.

SfAutocomplete

Features

  • #FB50281 - Provided supports for TokenWrapMode, which allow users to display selected items as tokens inside the control in two ways which is Wrap and None.

  • #FB50281 - Provided supports for EnableAutoSize which allows the control to dynamically extend its layout based on the input content.

  • #FB49392 - Provided setter support for the SelectedItems property which allows the user to bind the selected items through the view model.

  • #FB46095 - Provided support to drop-down elements customizations using the following properties in .NET MAUI SfAutocomplete,

    • DropDownItemFontFamily
    • DropDownItemFontAttributes
    • DropDownItemFontSize
    • DropDownItemHeight
    • DropDownStroke
    • DropDownStrokeThickness
    • DropDownItemTextColor
    • SelectedDropDownItemBackground
    • DropDownBackground
    • SelectionTextHighlightColor

  • Added text alignment support for .NET MAUI Autocomplete control.

  • Added support for hiding borders in .NET MAUI Autocomplete control.

SfButton

Features

  • #FB48360 - Provided supports for Checkable state using IsCheckable and IsChecked properties, which enables the users to determine whether a control can support a checked state and to retrieve its value.

  • #FB48876 - Provided supports for EnableRippleAnimation which enables the users to determine if the ripple animation should be displayed when the control is pressed.

  • #FB50195 - Provided supports for Default ImageAlignment, which enables the users to display the image icon in the center position of the control

  • #I547717 - Added the right-to-left (RTL) support for .NET Maui Button control.

SfCalendar

Features

  • #FB40906 - The ShowOutOfRangeDates property can be used to hide or show dates beyond the minimum and maximum dates.

SfCartesianChart

Features

The addition of the following new series type to the Cartesian chart control will provide the user with more ways to visualize their data.

  • #I369273 - Histogram : Allows users to understand data patterns by displaying distribution through bars. Each bar on the chart shows how many data points fall within a specific range. They enhance decision-making and analysis by making it easy to identify trends, outliers, and deviations in datasets.

DataLabel:

  • #FB38570 - Data label template: This feature allows users to create personalized data templates for displaying label content, customized to their specific needs.Customization also includes the ability to modify the styling, and layout of the labels.
  • Label context : Allows user to modify the content of data label to percentage value of corresponting data points among other points or corresponting data points value.

Plot band:

  • #FB39278 - This feature allows the users can improve the readability of charts by using different colors to highlights the different ranges inside the plot area. It also supports the regular interval plot band repetition.

SfChat New

The Syncfusion .NET MAUI Chat control, also known as conversational UI, provides a modern, conversational chatbot experience. It is a flexible control that shows the conversation between two or more users in a fully customizable layout. Messages can be different types of text, images, hyperlinks, cards, and more based on the need.

Features

  • Message types: Various message types include text, calendar, time picker, card, image, and hyperlink.

  • Time break: Organizes chat messages into groups according to their date and time of creation.

  • Typing indicator: Real-time indication when the other user is typing a message, enhancing the conversational experience.

  • Suggestions: Offers quick options to choose from and expedites the conversation flow.

  • Load more: Loads past messages as users scroll through the chat history.

  • Styling: Customize the appearance of incoming and outgoing messages.

SfChip

Features

  • #I505788 - Added the IsSelected property to .NET Maui Chip control.

SfCircularChart

Features

DataLabel:

  • #FB38570 - Data label template : This feature allows users to create personalized data templates for displaying label content, customized to their specific needs.Customization also includes the ability to modify the styling, and layout of the labels.
  • Label context : Allows user to modify the content of data label to percentage value of corresponting data points among other points or corresponting data points value.

SfComboBox

Features

  • #FB50281 - Provided supports for TokenWrapMode, which allow users to display selected items as tokens inside the control in two ways which is Wrap and None.

  • #FB50281 - Provided supports for EnableAutoSize which allows the control to dynamically extend its layout based on the input content.

  • #FB49392 - Provided setter support for the SelectedItems property which allows the user to bind the selected items through the view model.

  • #FB46095 - Provided support to drop-down elements customizations using the following properties in .NET MAUI SfComboBox,

    • DropDownItemFontFamily
    • DropDownItemFontAttributes
    • DropDownItemFontSize
    • DropDownItemHeight
    • DropDownStroke
    • DropDownStrokeThickness
    • DropDownItemTextColor
    • SelectedDropDownItemBackground
    • DropDownBackground
    • SelectionTextHighlightColor

  • #I564834,I547432,I549671 - Added support for hiding borders in .NET MAUI ComboBox control.

  • Added the text alignment support for .NET MAUI ComboBox control.

SfDataForm

Features

  • Provided support to floating label layout for date, time, and picker editors.
  • Provided support to customize the label view in the default stack (label and editor) layout.

Breaking changes

  • The inputs controls Switch, CheckBox, and RadioButtons are replaced with the SfSwitch, SfCheckBox, and SfRadioButtons controls, respectively.

SfDataGrid

Features

  • #FB46248 - Provided support for resizing the column by dragging the column header right border.
  • #FB48327 - Provided support for disabling focus for a particular column.
  • #FB48135 - Provided support for customizing the sort icon color.
  • #FB46194 - Provided theming support for the DataGrid and DataPager.
  • #I509126 - Provided support for adding additional rows (unbound rows) and columns (unbound columns) that are not bound to any data object from the underlying collection.
  • #FB48336 - Provided pull-to-refresh support for the DataGrid externally. This can be achieved by wrapping the DataGrid as a pullable content to the SfPullToRefresh.
  • #FB49741 - The public properties and methods of the DataGridColumnSizer class are now accessible.

Bug Fixes

  • #I540796 - The DataGrid now renders properly in the right-to-left direction on Android.
  • #FB47727 - The cell content is now displayed correctly during key navigation.

SfExpander

Bug fixes

  • #I523005 - Fixed issue with expand and collapse functionality based on set IsEnabled property.

SfImageEditor

Features

  • Provided serialization and deserialization support for annotations and their settings.
  • Provided support to add a custom annotation view in the Image Editor.
  • Provided support to users can change the order of annotations along the z-axis in the Image Editor.
  • Provided support to change the flow direction of the Image Editor’s.

Breaking changes

  • The IsRotatable and RotationAngle properties are moved to ImageEditorAnnotationSettings class from ImageEditorTextSettings.

SfListView

Features

  • #I533626 - Added support for ItemRightTapped event.

SfMaskedEntry

Features

  • #I547441 - Added border color support for .NET MAUI MaskedEntry control.

  • #I553675 - Added show border support for .NET MAUI MaskedEntry control.

  • Added text alignment support for .NET MAUI MaskedEntry control.

SfNavigationDrawer

Features

  • #I533119 - Added the IsOpen property support to the .NET Maui Navigation Drawer control.

  • #I544410 - Added swipe threshold property to the .NET Maui Navigation Drawer control.

Breaking Changes

  • #I545460 - Removed the scroll view from the DrawerContentView of the .NET Maui Navigation Drawer control.

SfNumericEntry

Features

  • #I543058 - Added support for text alignment in .NET Maui NumericEntry control.

  • #I559211 - Added support for hiding borders in .NET MAUI NumericEntry control.

  • #F186908 - Added vertical orientation functionality to the up-down button in the Maui Numeric entry

SfParallaxView New

The .NET MAUI ParallaxView control allows the user to create a parallax effect where the front elements move quicker than the background while scrolling through content. It enhances user experience by adding depth and dynamism, making the interface more engaging and easier to navigate.

Features

  • Set any kind of background view.
  • Customize the speed of the parallax scroll.
  • Use horizontal and vertical scrolling orientations.

SfPdfViewer

Features

  • #FB40233, #I428286, #I449362 - Provided support to add, remove, and modify electronic signatures in PDF files, including freehand-drawn, text, and image signatures.
  • #I544814 - Provided support to add, remove, and modify custom bookmarks in PDF files.
  • #I541624, #I550299, #I482500 - Provided support to view the PDF files in different page layout modes, such as continuous and single-page.
  • #FB45939 - Provided support to draw ink annotations only with the stylus in PDF files on the Android and iOS platforms. The touch and mouse interactions will perform panning and scrolling instead in this mode.
  • #I550059, #I561834, #I456019, #I513348, #I514377 - Provided support to print the PDF documents.
  • Provided support for custom data to add user-defined attributes to PDF annotations and form fields.
  • #I547978 - Provided flatten option support for the annotations and form data while saving.
  • #I543721, #I557383, #I531914 - Provided support to obtain the PDF page coordinates relative to the PDF Viewer’s client coordinates and vice versa. It also allows you to obtain the scroll point relative to the PDF page coordinates and bring the given region into view.

SfPolarChart New

The .NET MAUI Polar chart is used to visualize the data in a circular format, making it easy for users to visualize relationships and patterns across different angles and distances from the center. It improves users quick and easy understanding of cyclical or radial data trends, such as changes in the seasons or specific patterns.

Features

  • Gridline type: Change the rendering type of axis gridlines to polygon or circle.
  • Data labels and legends: Enhance readability by labeling data points and providing a legend.
  • Tooltips: Provide additional information about individual segments.
  • Multiple series: Render multiple polar series at the same time to compare and visualize two series simultaneously.

SfRadialMenu New

The .NET MAUI Radial Menu is a control that displays a hierarchical menu in a circular layout, which is optimized for touch-enabled devices. Typically, it is used as a context menu, and it can expose more menu items in the same space than traditional menus.

Features

  • Drag: Move the control around the screen to prevent it from covering underlying content.
  • Rotation: Rotate menu items for enhanced interaction.
  • Font icon support: Add scalable vector graphics to avoid common issues associated with traditional image icons.
  • Custom views: Incorporate custom views, such as images, within the menu.

SfRotator New

The Syncfusion .NET MAUI Rotator is a UI control that provides an interactive way to show images and navigate through a collection of views. It supports various navigation options, like swiping, autoplay, and tapping.

Features

  • Navigation styles: Choose between dot or thumbnail navigation styles to browse through content.
  • Placement customization: Position dot or thumbnail indicators on any of the four edges.
  • Continuous play and looping: Set items to play automatically and rotate in a continuous loop.

SfScheduler

Features

  • Provided support to customize the cell selection style.
  • Provided support to customize the month appointment indicator count.

Breaking changes

  • The Background property is removed from the SchedulerHeaderSettingsBase and added to SchedulerHeaderView and SchedulerViewHeaderSettings classes.
  • The SelectedCellBackground property is deprecated, you can use CellSelectionView as an alternate.

SfStepProgressBar New

The .NET MAUI StepProgressBar is a control that displays progress through multiple steps in a process, such as order tracking or a user registration form. It’s customizable, with options for step shape, content, progress bar color, and more.

Features

  • Allows you to change the orientation in a Horizontal or Vertical direction.
  • Primary and Secondary text can be used to display information about a step’s status.
  • Customize the description using primary and secondary formatted text.
  • Supports customization of the active step index and progress values.
  • Provides support for changing the label position (Start, End, Top, and Bottom).
  • Customize the step progress bar shape type to Circle and Square.
  • Supports adding different content types (Tick, Cross, Dot, and None) and their customizations.
  • Step progress bar status can be represented with images inside the step.
  • Supports customization of the step progress bar background color, step size, content size, animations, and more.

SfTabView

Features

  • #FB49048 - Provided support for the Cancel argument in TabItemTappedEventArgs for the TabItemTapped event.

  • #FB49110 - Provide support for the Handled argument in TabSelectionChangedEventArgs for the SelectionChanged event.

  • #I546495,I554947 - Added support for tab header padding in the .NET Maui TabView control.

  • Added IndicatorWidthMode property to the .NET Maui TabView control.

SfTextInputLayout

Features

  • Added PasswordVisibilityToggled event support for .NET MAUI TextInputLayout control.

SfTreeMap New

The .NET MAUI TreeMap control visually represents hierarchical data with rectangles sized and colored based on underlying values. It efficiently displays grouped and nested data structures, offering extensive customization options, supporting item selection, and more.

Features

  • Seamlessly bind the TreeMap control to hierarchical data structures.
  • Offers various layout options such as Squarified, SliceAndDiceHorizontal, SliceAndDiceVertical, and the SliceAndDiceAuto.
  • Offers multi-level support for hierarchical collection data.
  • Utilize brush settings within the TreeMap to customize fill colors for leaf items based on ranges or values.
  • Enhance TreeMap interpretation with the legend feature, incorporating various colors, shapes, and more.
  • Interactive tooltip support provides additional details about the tree map items.
  • Allows you to select or highlight the specific tree map items.
  • Provided accessibility support for tree map control.
  • Implemented keyboard support to perform navigation between items of the tree map control.
  • Customize the tree map appearances.

SfTreeView

Features

  • #I521000,#I562320 - Added support for loading CheckBox in each node and toggle the checked and unchecked state of the respective nodes.
  • #I541140 - Load on demand support has been provided for loading child items dynamically when expanding the parent node.
  • #I562320 - Added support for animated expansion and collapse of treeview nodes.
  • #I533626 - Added support for ItemRightTapped event.

Visual Studio Extensions

Features

  • Syncfusion has introduced a new tool, the Visual Studio Code .NET MAUI Project Template, to simplify the development of Syncfusion .NET MAUI applications. This tool features an intuitive project wizard that guides you through the creation process smoothly. Its user-friendly interface ensures you can create applications effortlessly, even without prior experience.

  • Syncfusion provides code snippet support for inserting Syncfusion .NET MAUI components into your .NET MAUI application.

XlsIO

Features

  • Provided support for wrapped axis titles in chart to image conversion.
  • Provided support for series line cap formatting in chart to image conversion.
  • Provided support for line dash style formatting in scatter and line charts in chart to image conversion.
  • Provided support for multilevel category labels in chart to image conversion.
  • Provided support for 100% stacked line chart in chart to image conversion.
  • Provided support for manually positioned chart titles in chart to image conversion.

Bug Fixes

  • #I552205 - Dotted lines are not rendered properly issue is fixed in the chart to image conversion.
  • Argument out-of-range exception thrown when resaving the Excel file in Thai culture is fixed.