Essential Studio for MAUI Release Notes

v20.4.0.38
December 21, 2022

Common

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

  • Avatar View
  • Badge View
  • Busy Indicator
  • Cartesian Chart
  • Circular Chart
  • Circular ProgressBar
  • DataGrid
  • DateTime Range Selector
  • DateTime Range Slider
  • DateTime Slider
  • Effects View
  • Linear ProgressBar
  • ListView
  • Range Slider
  • Range Selector
  • Scheduler
  • Signature Pad
  • Slider
  • Tab View

New controls

The following controls have been added newly.

  • Backdrop Page
  • Calendar
  • DataForm
  • Funnel Chart
  • PDF Viewer
  • Pyramid Chart
  • Rating
  • Text Input Layout

DocIO

Features

  • #I249958 – Convert the Word document to a Markdown file.
  • #I408285 – Convert charts in the Word documents to images.
  • #FB-38025 – Preserve new line characters in the table of contents entries of the Word document.

PDF

Features

  • Provided image redaction support on .NET using the Skiasharp.

Bug Fixes

  • #I351114 - Hanging issue no longer occurs while creating the QRBarcode with Arabic text.
  • #I419248 - The ExtractText returning incorrect coordinate bounds is now resolved.
  • #I419825 - The formatting exception when getting color from the specific free text annotation PDF document is now resolved.
  • #I423210 - Unable to edit the XMP Metadata no longer occurs in a specific PDF document.
  • #I421277 - OCSP information not embedded while enabling LTV for a specific certificate is now resolved.
  • #I420411 - The flattened annotations not located properly in the specific PDF document is now resolved.
  • #I418723 - The argument exception no longer occurs while compressing a specific PDF document.
  • #I418031 - Find text failure for the text containing numbers with hyphens is now resolved.
  • #I415562 - The out of Memory exception no longer occurs when performing extract text for a particular PDF document.
  • #I415274 - Export annotation as XFDF not working properly for a specific PDF document is now resolved.
  • #I420973 - The ink annotation not preserved properly while flattening a specific PDF document is now resolved.
  • #I421396 - The exception no longer occurs when providing an invalid check digit value to the Ean13 Barcode.
  • #I421642 - The layer subject is no longer changed after merging a PDF document.
  • #I421061 - The image size not reduced properly while compressing a specific PDF document is now resolved.
  • #I421114 - The preservation issue no longer occurs while drawing the nested grid in a PDF document.
  • #I420853 – Converting a specific Document to PDF results in large-size output is now resolved.
  • #I418989 - The textbox multiline preservation issue no longer occurs in a specific PDF document.
  • #I417772 - The extraction failure no longer occurs when extracting attachments from a PDF document.
  • #I415576 - The hanging issue no longer occurs when performing signature validation for a particular PDF document.
  • #F176704 - The incorrect signature validation results no longer occur while validating the signature.

Presentation

Features

  • #I285034, #I300854 – Apply highlight color to a text in the PowerPoint Presentation.
  • #I396782, #I421732 – Find the first occurrence or all occurrences of a text in the entire PowerPoint Presentation or specific slide.

Breaking Changes

  • In earlier releases, the given System.IO.Stream instance as a parameter to Open methods was disposed of internally. From this release onwards, Presentation.Open(Stream) and Presentation.Open(Stream, String) methods will not dispose of the specified stream instance. The user has to take care of its disposal in their application.
  • The below listed APIs has been moved to Syncfusion.Presentation and Syncfusion.PresentationRenderer.
Name Type Old Namespace New Namespace
TransitionEffect Enum Syncfusion.Presentation.SlideTransition Syncfusion.Presentation
TransitionEffectOption Enum Syncfusion.Presentation.SlideTransition Syncfusion.Presentation
TransitionSpeed Enum Syncfusion.Presentation.SlideTransition Syncfusion.Presentation
ISlideShowTransition Interface Syncfusion.Presentation.Interfaces Syncfusion.Presentation
PresentationToPdfConverter Class Syncfusion.PresentationToPdfConverter Syncfusion.PresentationRenderer
PresentationToPdfConverterSettings Class Syncfusion.PresentationToPdfConverter Syncfusion.PresentationRenderer
SlidesPerPage Enum Syncfusion.PresentationToPdfConverter Syncfusion.PresentationRenderer
PublishOptions Enum Syncfusion.PresentationToPdfConverter Syncfusion.PresentationRenderer

SfAutocomplete

Breaking changes

  • The BorderColor property name has been changed to Stroke.

SfAvatarView

Breaking changes

  • The BorderColor property name has been changed to Stroke.
  • The BorderThickness property name has been changed to StrokeThickness.

SfBackdropPage New

The .NET MAUI Backdrop page comprises two surfaces: a back layer and a front layer. The back layer holds actionable content (like navigation or filtration), which is relevant to the front layer.

Key features

  • Allows you to add with the NavigationPage and supports seamless navigation and toolbar customizations.

  • Adjusts the height of the back layer automatically based on its content and provides an option to expand the content to fit the screen.

  • Supports curved and flat edge shapes for the front layer with corner radius customization options.

  • Provides smooth animations for revealing and concealing the back layer content.

  • Allows users to customize the icons of the navigation header in the revealed and closed states separately.

SfBadgeView

Breaking changes

  • The BorderWidth property name has been changed to StrokeThickness.

SfCalendar New

The Syncfusion .NET MAUI Calendar (SfCalendar) allows users to select a single date, multiple dates, or a range of dates. It provides month, year, decade, and century views for quick navigation to a desired date. It supports minimum dates, maximum dates, enabling past dates, and disabling dates to restrict date selection.

Key features

  • Use month, year, decade, and century view modes.

  • Quickly navigate to desired dates using different calendar views, and forward and backward methods.

  • Select a single, multiple, or a range of dates.

  • Restrict navigation among calendar views through interaction.

  • Restrict interaction with past dates.

  • Restrict navigation and interaction beyond the specified minimum and maximum dates.

  • Change the first day of the week in month view.

  • Disable interaction for calendar view dates.

  • Specify weekend days and special dates in month view.

  • Customize appearance of different calendar views.

  • Render right to left.

  • Utilize globalization support.

SfCartesianChart

Features

  • The trackball support has been included in the chart. which allows the tooltip for the nearest data points to be displayed when you interact with the chart area.
  • Data marker support is provided to the line, spline, and area charts, which highlight the chart data points with predefined shapes.
  • The ItemTemplate property of ChartLegend in a Cartesian Chart now allows you to customize each item in the legend.

Known issue

  • [iOS] #9135 - The chart legend was taking up a huge amount of vertical space or becoming hidden.

SfCircularChart

Features

  • The ItemTemplate property of ChartLegend in a Circular Chart now allows you to customize each item in the legend.

Known issue

  • [iOS] #9135 - The chart legend was taking up a huge amount of vertical space or becoming hidden.

SfComboBox

Breaking changes

  • The BorderColor property name has been changed to Stroke.

SfDataForm New

The Syncfusion .NET MAUI DataForm (SfDataForm) allows you to create and edit data using a wide range of built-in and custom editors for any data forms such as login, reservation, contact, employee forms, and more. It supports data validation, data handling, grouping, and linear and grid layouts. You can easily customize the editors, groups, labels, and validation labels’ appearances.

Key features

  • Editors: Supports built-in editors such as text, password, multi-line, autocomplete, combo box, date picker, time picker, checkbox, switch, and radio group editors for the primitive data types such as string, enumeration, DateTime, and TimeSpan to enhance the user experience.

  • Custom editor: Support to add custom editors.

  • Validation: Built-in assistance to evaluate the data or user input to alert the user to enter a proper value.

  • Commit mode : Support determining when the value should be committed to the underlying data object.

  • Layout and grouping: Supports grouping linear and grid layout.

  • Appearnace Customization: Supports customizing the appearances of editors, labels, and group headers.

  • Read-Only mode: Supports the read-only display mode.

  • Right to left (RTL): Supports right to left direction for users working with RTL languages like Hebrew, Arabic, and more.

  • Localization: Supports Localization and globalization of all static text.

SfDateTimeRangeSelector

Features

  • Deferred update: Provides an option to defer a selection allowing you to control when the dependent components are updated while thumbs are being dragged continuously.
  • Auto interval: Supports auto interval when the Interval, IntervalType, or DateFormat properties are not set.

Breaking Changes

Find the following API’s default value-breaking changes:

Class name API name Existing default value New default value

IDateTimeElement

IntervalType

 SliderDateIntervalType.Years SliderDateIntervalType.Auto

IDateTimeElement

DateFormat

 yyyy string.Empty

SfDateTimeRangeSlider

Features

  • Deferred update: Provides an option to defer a selection allowing you to control when the dependent components are updated while thumbs are being dragged continuously.
  • Auto interval: Supports auto interval when the Interval, IntervalType, or DateFormat properties are not set.

Breaking Changes

Find the following API’s default value-breaking changes:

Class name API name Existing default value New default value

IDateTimeElement

IntervalType

 SliderDateIntervalType.Years SliderDateIntervalType.Auto

IDateTimeElement

DateFormat

 yyyy string.Empty

SfDateTimeSlider

Features

  • Deferred update: Provides an option to defer a selection allowing you to control when the dependent components are updated while thumbs are being dragged continuously.
  • Auto interval: Supports auto interval when the Interval, IntervalType, or DateFormat properties are not set.

Breaking Changes

Find the following API’s default value-breaking changes:

Class name API name Existing default value New default value

IDateTimeElement

IntervalType

 SliderDateIntervalType.Years SliderDateIntervalType.Auto

IDateTimeElement

DateFormat

 yyyy string.Empty

SfFunnelChart New

The Syncfusion .NET MAUI Funnel Chart (SfFunnelChart) are often used to represent stages in a process, such as the amount of potential revenue for each stage in sales.

Features

  • Provides a user-friendly funnel chart component with impressive visualization.
  • Enhances the end-user experience greatly by including user interaction features such as selection, and tooltips in the chart.
  • Displays legends to show additional information about the chart series. The legends can be scrolled if an item exceeds the available space.
  • Provides various options for customizing and visualizing chart features like the title, data labels, legends, gap ratio, and more.

SfLinearProgressBar

Features

  • Progress Padding - Provided support to adjust the left and right edge padding of the progress and the secondary progress indicator in the SfLinearProgressBar using the ProgressPadding property.

SfListView

Features

  • Provided the support to display text or a view in the ListView when there is no data to display.
  • Provided the key navigation support for the iOS and macOS platforms.

Bug Fixes

  • #F178225 - Now, the items will be rendered properly in the horizontal orientation.

SfMaps Preview

Features

  • Tile layer - An interactive tile layer allows you to load map tiles from web map tile services such as Bing Maps, OpenStreetMaps, or Google Maps. Use markers to denote a specific latitude and longitude in the tile layer as required.
  • Zooming and Panning - Zoom in the tile or shape layer for a closer look at a specific region by pinching the map, scrolling the mouse wheel, or using the trackpad. Pan the map to navigate across regions. You can also customize the zoom level and the center point (only for the tile layer) of the map rendering.
  • Sublayer support for tile layer - With sublayer support, you can add another map area (shape layer) and vector shapes such as lines, polylines, arcs, circles, and polygons over the tile layer to show routes or rivers and highlight specific regions on maps.
  • Cartesian support - It is used to render any custom shapes to display a building floor planning, a sports stadium, plane or bus seat arrangements, and more.

Bug fixes

  • #I413944 - Data objects bound to shapes will refresh correctly when dynamically changing the ShapesSource.

SfPdfViewer New

The .NET MAUI PDF Viewer control lets you view the PDF documents seamlessly and efficiently. It has highly interactive and customizable features such as magnification and page navigation.

Key features

  • Virtual scrolling: Easily scroll through the pages in the document with a fluent experience. The pages are rendered only when required, to increase the loading and scrolling performance.

  • Magnification: The content of a PDF document can be efficiently zoomed in and out by pinching or changing the zoom factor programmatically.

  • Page navigation: Navigate to the desired pages instantly using the page navigation option programmatically or by dragging the scroll head in the UI.

SfPyramidChart New

The Syncfusion .NET MAUI Pyramid Chart (SfPyramidChart) represent hierarchies visually in a pyramid-like structure that shows proportions of a total. The item width indicates levels in the hierarchy, and each item height corresponds to its value.

Key features

  • Plot pyramid series for user-friendly data representation and smooth visualization.
  • Includes user interaction features such as tooltip and selection for enhancing the end-user experience.
  • Add a legend to provide more information about the chart segments. The legend can be scrolled if an item exceeds the available space.
  • Provides various options for customizing and visualizing chart features like title, data labels, legends, gap ratio, and more.

SfRangeSelector

Features

  • Deferred update: Provides an option to defer a selection allowing you to control when the dependent components are updated while thumbs are being dragged continuously.
  • Auto interval: Supports auto interval when the Interval property is not set.

SfRangeSlider

Features

  • Deferred update: Provides an option to defer a selection allowing you to control when the dependent components are updated while thumbs are being dragged continuously.
  • Auto interval: Supports auto interval when the Interval property is not set.

SfRating New

The .NET MAUI Rating control is used to provide or view ratings on a numeric scale. This control can be used in various scenarios like movie ratings or rating an application.

Features

  • Precision: Set an accuracy level for ratings.
  • Customization: Customize the rating items’ style, size, and more.
  • Shapes: Add rating items such as stars, hearts, circles, diamonds, and custom paths.
  • Read-only: Limit user selection and allow only the viewing of the rating value.

SfSignaturePad

Breaking Changes

  • The ConfigureSyncfusionSignaturePad() handler will no longer be available, and use the ConfigureSyncfusionCore() handler instead.

SfSlider

Features

  • Deferred update: Provides an option to defer a selection allowing you to control when the dependent components are updated while thumbs are being dragged continuously.
  • Auto interval: Supports auto interval when the Interval property is not set.

SfTextInputLayout New

The Text Input Layout control adds decorative elements like floating labels, icons, and assistive labels on top of input views such as the Entry, Editor, Autocomplete, ComboBox controls.

Features

  • Display floating label when the input view is focused on.
  • Display error labels.
  • Use filled and outlined container types.
  • Display leading and trailing icons.
  • Display help labels.
  • Toggle password visibility.

XlsIO

Breaking Changes

  • #F178313 - Remove method is added under IPivotFilters interface to remove existing filters in the pivot field.