Essential Studio for MAUI Release Notes

v20.1.0.47
April 4, 2022

DocIO

Features

  • #I131175, #I195343, #I199221, #I323836, #I333914, #I343475, #I358626 - Provided support for preserving picture fill in DOCX to PDF conversion.
  • #I341225 - Provided an API to link paragraph and character styles in a Word document.

Breaking Changes

  • The default XHTML validation type is changed from XHTMLValidation.Transitional to XHTMLValidation.None while importing a HTML file.

PDF

Features

  • #I259782, #I308276 - Added support for importing and exporting annotations with appearance.
  • #I361251 - Added support for converting the PDF/A conformance document to a normal PDF document.
  • #I362189 - Added support to get annotation type and creation date directly from PdfLoadedAnnotation instance.
  • #I358952 - Improved the performance of Annotation flattening by 30 times faster.
  • Added support for compressing existing PDF document.
  • Added support for converting existing PDF to PDF/A conformance.
  • Added support for extracting images from existing PDF documents.
  • Added support for removing image from existing PDF documents.
  • Added support for replacing image in existing PDF documents.
  • Added support for setting base URL for PDF document.

Known Limitation

  • The image extraction feature will not properly extract CMYK JPEG images encoded with YCCK.

SfBadgeView Preview

Features

  • Now, SfBadgeView supports BadgeAlignment with Start, Center and End values.

  • Now, predefined icons can be used as a badge using BadgeIcon support.

  • Now, the position of the badge can be set to left, right, top and bottom of the Badge control.

SfBarcodeGenerator New

The .NET MAUI Radial Barcode Generator is a data visualization control used to generate and display data in a machine-readable format.

Key features

  • One-dimensional barcodes - Barcode Generator supports different one-dimensional barcode symbologies such as Code128, EAN8, EAN13, UPC-A, UPC-E, Code39, Code39 Extended, Code93, and Codabar.
  • Two-dimensional barcode - Barcode Generator supports popular QR code and Data Matrix.
  • Barcode customization - Customize the visual appearance of barcodes using the backgroundColor and barColor properties, and adjust the size of the smallest line or dot of the code using the module property.
  • Text customization - Configure to display the barcode value and customize the position and style of the barcode text.

SfCartesianChart Preview

Features

  • Provided mouse wheel zooming support in the WinUI and MacCatalyst platforms.
  • Multiple axis support has been provided in the chart, we can add multiple x and y axis in the XAxes and YAxes collections, respectively, in the SfCartesianChart.
  • Now, the chart shows a tooltip when the mouse hovers over the series in the WinUI and MacCatalyst platforms.

Breaking changes

  • The PrimaryAxis and SecondaryAxis properties have been removed from the SfCartesianChart, instead of that need to add x and y axis in the XAxes and YAxes collections, respectively, in the SfCartesianChart.
  • The LegendItems, and Palette properties have been removed from the SfCartesianChart.
  • The CustomBrushes property name has been changed to PaletteBrushes.
  • The ChartBehaviors property has been removed from the SfCartesianChart, instead of that need to add the TooltipBehavior, SelectionBehavior, and ZoompanBehavior properties directly to the SfCartesianChart.
  • The CrossingAxisReference property name has been changed to CrossingAxisName, and also the data type has been changed as string rather than object.
  • The VisibleLabels property has been removed from the ChartAxis.
  • The XAxis, YAxis properties has been removed from the CartesianSeries, instead, we can add the axis in the XAxes and YAxes collection in the SfCartesianChart with a unique name and use that axis name in the XAxisName and YAxisName properties in the CartesianSeries.
  • The ChartLegendItem and ChartAxisCollection classes have been removed from the chart.
  • The Background property name has been changed to Fill in the ChartSeries.
  • The ShowTooltip property name has been changed to EnableTooltip.
  • The Palette, DataCount, and Segments properties has been removed from the ChartSeries.
  • The HitTest method has been removed from the ChartSeries.
  • The Height and Width properties have been renamed PointHeight and PointWidth, respectively, in the ScatterSeries and ScatterSegment classes.
  • The ActualMaximum, and ActualMinimum properties have been changed to getter only in the ActualRangeChangedEventArgs.
  • The VisibleMaximum, and VisibleMinimum properties have been removed from the ActualRangeChangedEventArgs.
  • The SelectionType enum has been removed from the chart.
  • The Placement enum name has been changed to DataLabelPlacement.
  • The Alignment enum name has been changed to DataLabelAlignment.
  • The Type property has been removed from the ChartSelectionBehavior.

SfCircularChart Preview

Breaking changes

  • The LegendItems property has been removed from the SfCircularChart.
  • The ChartBehaviors property has been removed from the SfCircularChart, instead of that need to add the TooltipBehavior, and SelectionBehavior properties directly to the SfCircularChart.
  • The ChartLegendItem class has been removed from the chart.
  • The CustomBrushes property name has been changed to PaletteBrushes.
  • The Background property name has been changed to Fill in the ChartSeries.
  • The ShowTooltip property name has been changed to EnableTooltip.
  • The Palette, DataCount, and Segments properties have been removed from the ChartSeries.
  • The HitTest method has been removed from the ChartSeries.
  • The SmartLabelAlignment property has been removed from the CircularSeries.
  • The CircularCoefficient property name has been changed to Radius.
  • The DoughnutCoefficient property name has been changed to InnerRadius.
  • The SelectionType enum has been removed from the chart.
  • The Placement enum name has been changed to DataLabelPlacement.
  • The Type property has been removed from the ChartSelectionBehavior.

SfDateTimeRangeSelector New

The .NET MAUI DateTime Range Selector (SfDateTimeRangeSelector) is a highly interactive UI control for selecting a smaller date-time range from a larger data set. It provides a rich set of features such as labels, ticks, dividers, step duration, overlays and tooltips. It also supports adding any type of control as its content.

Key features

  • Child support: Add a child of any type inside the Range selector. It is also possible to add the Charts control in it. The DateTime Range selector is smart enough to handle functions like segment selection and chart zooming based on the time range specified in it.
  • Labels: Render labels for the date-time value with the option to customize their formats based on your requirements.
  • Ticks and dividers: Provides the option to show ticks and dividers based on the specified interval. Minor ticks can also be enabled to show the values between intervals. These features display the selected value in a more intuitive way for end users.
  • Tooltips - Render tooltips to show the selected range clearly. It is also possible to customize the format of the text shown in the tooltip.
  • Discrete selection: Select only discrete values.
  • Thumb icon support: Insert custom controls like an icon or text inside the left and right thumbs.

SfDateTimeRangeSlider New

The .NET MAUI DateTime Range Slider (SfDateTimeRangeSlider) is a highly interactive UI control, allowing users to select a range of values within a specified date-time bounds. It provides rich features, such as labels, ticks, dividers, overlay, step duration, drag behavior and tooltip. This is an existing Range-Slider-based control with all of its features and supports date-time values.

Key Features

  • Negative offset: Provided negative offset support for ticks and labels where it can be positioned on top and left for horizontal and vertical sliders.
  • Always show tooltip: Provided an option to always show a tooltip.
  • Thumb icon - Accepts custom controls like icon or text inside the thumbs.
  • Tooltip position: Provided option to set tooltip position at right or left of the vertical range slider.
  • Hover support: Provided hover support for thumb overlay and tooltip for all desktop platforms.

SfDateTimeSlider New

The .NET MAUI DateTime Range Slider (SfDateTimeSlider) is a highly interactive UI control, allowing users to select a single value within a specified date-time bounds. It provides rich features, such as labels, ticks, dividers, overlay, step duration, drag behavior and tooltip. This is an existing Slider-based control with all of its features and supports date-time values.

Key Features

  • Negative offset: Provided negative offset support for tick and labels where it can be positioned on top and left for horizontal and vertical sliders.
  • Always show tooltip: Provided option to render tooltip permanently.
  • Thumb icon: Accepts custom control like icon or text inside the thumb.
  • Tooltip position: Provided option to set tooltip position on right or left for the vertical slider.
  • Hover support: Provided hover support for thumb overlay and tooltip for all desktop platforms.

SfLinearGauge New

The .NET MAUI Linear Gauge is a data visualization control to display data on a linear scale. Use this control to craft high-quality mobile app user interfaces.

Key features

  • Orientation - The Linear Gauge can be set to vertical or horizontal orientation.
  • Scale - The scale is a set of values that can be plotted. You can customize a scale by changing the thickness and edge styles, and you can also inverse the scale.
  • Labels and Ticks - The scale elements such as labels, major ticks, and minor ticks can be customized to different styles.
  • Ranges - A range is a visual element that helps you to quickly visualize where a range falls on the scale track. Multiple ranges with different styles can be added to the Linear Gauge.
  • Pointers - A pointer is used to indicate a specific value on an scale. The gauge has three types of pointers: shape marker pointer, content marker pointer, and bar pointer. All the pointers can be customized as needed and you can also add multiple pointers in the Linear Gauge.
  • Mirror Gauge - The Linear Gauge can be mirrored. When the IsMirrored property is true, all the gauge elements will be rendered in mirror effect.
  • Animation - Animate the gauge elements in a visually appealing manner when they are loaded or their values are changed.
  • Interaction - The shape and content marker pointers in the Linear Gauge can be moved from one value to another by swiping or dragging gestures.

SfListView Preview

Features

  • ListView now also supports the WinUI(Windows) platform.

SfRadialGauge Preview

Features

  • Provided the elevation support for shape marker pointer.
  • Provided the pointer overlay support to show the overlay effect around the shape marker pointer when interacting.

SfRangeSelector New

The .NET MAUI Range Selector (SfRangeSelector) is a highly interactive UI control for selecting a smaller numeric range from a larger data set. It provides a rich set of features such as labels, ticks, dividers, step sizes, overlays, and tooltips. It also supports adding any type of control as its content.

Key features

  • Child support: Add a child of any type inside the Range Selector. It is also possible to add the Charts control in it. The Range Selector is smart enough to handle functions like segment selection and chart zooming based on the range specified in it.
  • Labels: Render labels for the numeric values and customize their formats based on your requirements.
  • Ticks and dividers: Show ticks and dividers based on specified intervals. Minor ticks can also be enabled to show the values between intervals. These features display the selected value in a more intuitive way for end users.
  • Tooltips: Render tooltips to show the selected range clearly. It is also possible to customize the format of the text shown in the tooltip.
  • Discrete selection: Select only discrete values.
  • Thumb icon support: Insert custom controls like an icon or text inside the left and right thumbs.

SfRangeSlider Preview

Key Features

  • Negative offset: Provided negative offset support for ticks and labels where it can be positioned on top and left for horizontal and vertical sliders.
  • Always show tooltip: Provided an option to always show a tooltip.
  • Thumb icon - Accepts custom controls like icon or text inside the thumbs.
  • Tooltip position: Provided option to set tooltip position at right or left of the vertical range slider.
  • Hover support: Provided hover support for thumb overlay and tooltip for all desktop platforms.

Breaking Changes

  • DateTime values were no longer supported by the SfRangeSlider control. A SfDateTimeRangeSlider control has been added to use DateTime values.
  • SfRangeSlider will now have numeric specific callback parameters and SfDateTimeRangeSlider will have DateTime specific callback parameters.
  • Removed the ToolTipMode property and added a Tooltip property in SfRangeSlider

SfScheduler Preview

Features

  • Provided the agenda view support in the scheduler.
  • Provided support to load appointments on-demand based on a visible date range with a loading busy indicator.
  • Improved the allow view navigation button rendering in the scheduler header based on the size updates.
  • Provided the mouse-hovering support for all scheduler elements in Windows and Maccatalyst layouts.
  • Provided support to display the month appointment count based on the size updates.
  • Provided the appointment read-only support.
  • Provided the allow view navigation support to switch view to day or timeline day view to visualize the appointment in detail.
  • Provided the data template customization for scheduler’s month cell, appointments, view header, header, and special time regions.

Breaking changes

Please find the following class and API breaking changes:

Existing class New class
SchedulerMonthViewSettings SchedulerMonthView
SchedulerTimeSlotViewSettings SchedulerTimeSlotView
SchedulerDaysViewSettings SchedulerDaysView
SchedulerTimelineViewSettings SchedulerTimelineView
Class name Existing API New API
SfScheduler MonthViewSettings MonthView
SfScheduler DaysViewSettings DaysView
SfScheduler TimelineViewSettings TimelineView
SfScheduler HeaderSettings HeaderView
SchedulerMonthView MonthCellStyle CellStyle

SfSlider Preview

Key Features

  • Negative offset: Provided negative offset support for tick and labels where it can be positioned on top and left for horizontal and vertical sliders.
  • Always show tooltip: Provided option to render tooltip permanently.
  • Thumb icon: Accepts custom control like icon or text inside the thumb.
  • Tooltip position: Provided option to set tooltip position on right or left for the vertical slider.
  • Hover support: Provided hover support for thumb overlay and tooltip for all desktop platforms.

Breaking Changes

  • DateTime values were no longer supported by the SfSlider control. A SfDateTimeSlider control has been added to use DateTime values.
  • SfSlider will now have numeric specific callback parameters and SfDateTimeSlider will have DateTime specific callback parameters.
  • Removed the ToolTipMode property and added a Tooltip property in SfSlider.

SfTabView Preview

Features

  • #I363185 - Now, SfTabView supports ItemsSource and DataTemplate support for header and content.

XlsIO

Features

  • Provided support for new functions such as XLOOKUP, VALUETOTEXT, ARRAYTOTEXT, XMATCH, and LET.

Bug Fixes

  • #I366365 - The default space maintained between cell border and cell text is now rendered properly in Excel to PDF conversion.