Essential Studio for MAUI Release Notes
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
toXHTMLValidation.None
while importing a HTML file.
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
, andCodabar
. -
Two-dimensional barcode - Barcode Generator supports popular
QR code
andData Matrix
. -
Barcode customization - Customize the visual appearance of barcodes using the
backgroundColor
andbarColor
properties, and adjust the size of the smallest line or dot of the code using themodule
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
andYAxes
collections, respectively, in theSfCartesianChart
. - Now, the chart shows a tooltip when the mouse hovers over the series in the WinUI and MacCatalyst platforms.
Breaking changes
- The
PrimaryAxis
andSecondaryAxis
properties have been removed from the SfCartesianChart, instead of that need to add x and y axis in theXAxes
andYAxes
collections, respectively, in theSfCartesianChart
. - The
LegendItems
, andPalette
properties have been removed from theSfCartesianChart
. - The
CustomBrushes
property name has been changed toPaletteBrushes
. - The
ChartBehaviors
property has been removed from the SfCartesianChart, instead of that need to add theTooltipBehavior
,SelectionBehavior
, andZoompanBehavior
properties directly to theSfCartesianChart
. - The
CrossingAxisReference
property name has been changed toCrossingAxisName
, and also the data type has been changed as string rather than object. - The
VisibleLabels
property has been removed from theChartAxis
. - The
XAxis
,YAxis
properties has been removed from theCartesianSeries
, instead, we can add the axis in theXAxes
andYAxes
collection in theSfCartesianChart
with a unique name and use that axis name in theXAxisName
andYAxisName
properties in theCartesianSeries
. - The
ChartLegendItem
andChartAxisCollection
classes have been removed from the chart. - The
Background
property name has been changed toFill
in theChartSeries
. - The
ShowTooltip
property name has been changed toEnableTooltip
. - The
Palette
,DataCount
, andSegments
properties has been removed from theChartSeries
. - The
HitTest
method has been removed from theChartSeries
. - The
Height
andWidth
properties have been renamedPointHeight
andPointWidth
, respectively, in the ScatterSeries and ScatterSegment classes. - The
ActualMaximum
, andActualMinimum
properties have been changed to getter only in theActualRangeChangedEventArgs
. - The
VisibleMaximum
, andVisibleMinimum
properties have been removed from theActualRangeChangedEventArgs
. - The
SelectionType
enum has been removed from the chart. - The
Placement
enum name has been changed toDataLabelPlacement
. - The
Alignment
enum name has been changed toDataLabelAlignment
. - The
Type
property has been removed from theChartSelectionBehavior
.
SfCircularChart Preview
Breaking changes
- The
LegendItems
property has been removed from theSfCircularChart
. - The
ChartBehaviors
property has been removed from the SfCircularChart, instead of that need to add theTooltipBehavior
, andSelectionBehavior
properties directly to theSfCircularChart
. - The
ChartLegendItem
class has been removed from the chart. - The
CustomBrushes
property name has been changed toPaletteBrushes
. - The
Background
property name has been changed toFill
in theChartSeries
. - The
ShowTooltip
property name has been changed toEnableTooltip
. - The
Palette
,DataCount
, andSegments
properties have been removed from theChartSeries
. - The
HitTest
method has been removed from theChartSeries
. - The
SmartLabelAlignment
property has been removed from theCircularSeries
. - The
CircularCoefficient
property name has been changed toRadius
. - The
DoughnutCoefficient
property name has been changed toInnerRadius
. - The
SelectionType
enum has been removed from the chart. - The
Placement
enum name has been changed toDataLabelPlacement
. - The
Type
property has been removed from theChartSelectionBehavior
.
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.