Essential Studio for MAUI Release Notes

v20.3.0.47
September 29, 2022

Common

New Controls

The below controls are added newly.

  • SfAutocomplete
  • SfComboBox
  • SfCircularProgressBar
  • SfLinearProgressBar

DocIO

Features

  • Wavy, wavy heavy, wavy double, and double underline styles render as they are in the input Word document during Word to PDF conversion.

PDF

Features

  • #F175439 – Provided support to enable LTV from time stamp server URI.
  • #F176704 – Provided support to get specific revocation status with signature validation options.
  • Provided redaction support in PDF imaging library with SkiaSharp.

Bug Fixes

  • #I401102 – Invalid annotation export generated JSON format is now resolved.
  • #I389626 - Form field values are now preserved properly when the font embedded with the string PS/PMST value.
  • #I403467 – The bookmark mapping issue while merging PDF documents is now resolved.
  • #I397797 - The space between text missing issue is now resolved when extracting the text from PDF.
  • #I397908 – Conformance failure is now resolved while converting PDF to PDF/A-1b.
  • #I397566 - Text is now correctly preserved while exporting PDF as an image using ImageExportSettings.
  • #I397189 - Preservation issue no longer occurs while converting the PDF to PDF/A1-b and PDF/A2-b document.
  • #I375314 – KeyNotFoundException no longer occurs while OCRing the particular PDF document.
  • #394556 – Form field bounds are now appropriately set while modifying the existing pdf document.
  • #I386200 – PDF/A3-b Conformance failure is now resolved for a particular PDF document.
  • #I403717 - Replace Image is now working properly for specific PDF documents.
  • #F176704 - The revocation error message is now updated correctly.
  • #I401014 - Exception occurs while flatting the particular document after adding the checkbox field is now resolved.
  • #I397274, #I401301 - Exception no longer occurs when getting fonts details from free text annotation in an existing PDF document.
  • #I394699 - Exception no longer occurs when drawing a nested grid using page graphics with pagination content.
  • #I398528 – Annotation is no longer misplaced after flattening the annotation from the existing PDF document.
  • #F176704 – Signature validation returns incorrect results for a particular signed PDF document is now resolved.
  • #I397452 - The PDF string layout now shows a proper layout of the text with an incorrect size.
  • #I395927 - Form Fields and their values are now preserved correctly after merging a PDF document.
  • #F176582 – Exception no longer occurs while saving the document by enabling EnableXfaFormFill.
  • #I395541 – Exception no longer occurs when getting the border value from loaded square annotation.
  • #I388926 - The digital signature failed issue no longer occurs while getting page layer count from a signed PDF document.
  • #I379333 - Annotation comments are missing after export and import annotation with XFDF format is now resolved.

Presentation

Features

  • #I274283 - Preserve structure tags in converted PDF documents for accessibility (PDF/UA or 508 compliance) support.

SfAutoComplete New

The Autocomplete control is highly optimized to load and populate suggestions quickly from a large volume of data depending on the users’ input characters. It allows users to select an item from a suggestion list.

Key features

  • Text search mode: Suggestions can be filtered based on StartsWith or Contains.

  • Data binding: Bind various types of data sources.

  • Watermark: Display placeholder text inside the control until the user enters text.

  • MaxDropdownHeight: The height of the dropdown can be customized.

SfBusyIndicator Preview

Features

  • The SingleCircle and DoubleCircle animation type has been provided in the SfBusyIndicator control.

SfCartesianChart Preview

Features

  • The logarithmic axis support has been provided in the chart. It makes it easier to visualize the widest range of data points.
  • Support for single and multiple-series selection is provided in the chart. We can highlight the series as needed.
  • Any view can now be added as the background of a chart plot region.

Known Issues

  • Due to a framework issue on the Android platform, the chart legend is partially clipped.

Breaking changes

  • The SfCartesianChart’s ChartSelectionBehavior type SelectionBehavior property has been updated. The SeriesSelectionBehavior is initialized to highlight series or Using the SelectionBehavior property of the ChartSeries, initialize the DataPointSelectionBehavior to highlight the data points.

SfCircularChart Preview

Features

  • The doughnut chart has center view support. Any view can be positioned in the doughnut center.
  • Support for multiple-segment selection is provided in the chart. We can highlight the segment as needed.
  • Any view can now be added as the background of a chart plot region.

Known Issues

  • Due to a framework issue on the Android platform, the chart legend is partially clipped.

Breaking changes

  • The SelectionBehavior property of the SfCircularChart has been removed. Instead, use SelectionBehavior of ChartSeries.

SfCircularProgressBar New

The .NET MAUI Circular ProgressBar shows the progress of a task with customizable visuals. It displaying the progress of a process in circular shapes, determinate and indeterminate states, segments, smooth animation, and with customizable content. You can also define ranges with different colors.

Key features

  • States: Visualize the progress of a process in determinate and indeterminate states.
  • Progress shapes: Visualize progress in a circular shape.
  • Segments: Progress can be divided into multiple segments to show a gradual progress.
  • Color ranges: Customize ranges with different colors.
  • Appearance customization: Customize the track thickness, color, and corner radius style.
  • Customizable content: Display custom content at the center of a circular progress bar.
  • Angle: Customize the angles of a circular progress bar.

SfComboBox New

The ComboBox control allows users to type a value in a text box or choose from a list of predefined options.

Key features

  • IsEditable: Supports both editable and non-editable modes.

  • Data binding: Bind various types of data sources.

  • Watermark: Display placeholder text inside the control until the user enters text.

  • MaxDropdownHeight: The height of the dropdown can be customized.

SfDateTimeRangeSelector Preview

Breaking Changes

  • The default color of the TrackStyle.ActiveFill, TrackStyle.InactiveFill, ThumbStyle.Fill, ThumbOverlayStyle.Fill, and DividerStyle.InactiveFill has been updated.

SfDateTimeRangeSlider Preview

Breaking Changes

  • The default color of the TrackStyle.ActiveFill, TrackStyle.InactiveFill, ThumbStyle.Fill, ThumbOverlayStyle.Fill, and DividerStyle.InactiveFill has been updated.

SfDateTimeSlider Preview

Breaking Changes

  • The default color of the TrackStyle.ActiveFill, TrackStyle.InactiveFill, ThumbStyle.Fill, ThumbOverlayStyle.Fill, and DividerStyle.InactiveFill has been updated.

SfLinearProgressBar New

The .NET MAUI Linear ProgressBar shows the progress of a task with custom visuals. It displays the progress of a process in rectangular shapes, determinate and indeterminate states, segments, and smooth animation. You can also define ranges with different colors.

Key features

  • States: Visualize progress of a process in determinate, indeterminate, and buffer states.
  • Progress shapes: Visualize progress in a rectangle shape.
  • Segments: Progress can be divided into multiple segments to show a gradual progress.
  • Color ranges: Customize ranges with different colors.
  • Appearance customization: Customize the track thickness, color, and corner radius.

SfListView Preview

Features

  • Provided the support to swipe the ListViewItem.

Breaking changes

Find the following API breaking changes:

Class name Existing API New API

SfListView


 IsBusy IsLazyLoading

ItemTappedEventArgs


ItemLongPressEventArgs


ItemDoubleTappedEventArgs


ItemAppearingEventArgs


ItemDisappearingEventArgs


QueryItemSizeEventArgs


 ItemData DataItem

SfMaps Preview

Features

  • Tooltip customization - Provided the support to customize the Background, TextStyle, and Padding of shape, bubble, and marker tooltips.
  • Legend customizations - Provided the support to customize the IconType and IconSize of the Legend.
  • Shape sublayer - Provides an option to add a shape sublayer with GeoJSON data in another shape layer to show more details about a particular region.
  • Vector shapes - Add shapes such as polylines, lines, polygons, circles, and arcs as a sublayer in the shape layers.

Breaking Changes

  • The BindingContext of the Tooltip will be the MapTooltipInfo, and it has the DataItem property. This property holds the corresponding underline object for the shape, bubble tooltip, and the corresponding MapMarker for the marker tooltip.

SfRangeSelector Preview

Breaking Changes

  • The default color of the TrackStyle.ActiveFill, TrackStyle.InactiveFill, ThumbStyle.Fill, ThumbOverlayStyle.Fill, and DividerStyle.InactiveFill has been updated.

SfRangeSlider Preview

Breaking Changes

  • The default color of the TrackStyle.ActiveFill, TrackStyle.InactiveFill, ThumbStyle.Fill, ThumbOverlayStyle.Fill, and DividerStyle.InactiveFill has been updated.

SfScheduler Preview

Features

  • Provided support to select the scheduler date, time, appointments, and view navigation using keyboard interaction in WinUI, macOS, and iOS platforms.
  • Provided support to remind the upcoming or overdue appointments using the ReminderAlertOpening event.
  • Provided support for Recurrence Rule Until Property consider with Time and Timezone.
  • Added icon for span appointment in all the scheduler views.

Breaking changes

Find the following API type breaking changes:

Class name API name Existing type New type

SchedulerQueryAppointmentsEventArgs

VisibleDates

 List ReadOnlyCollection

SchedulerInteractionEventArgs

Appointments

 List? ReadOnlyCollection?

SchedulerViewChangedEventArgs

NewVisibleDates

 List? ReadOnlyCollection?

SchedulerViewChangedEventArgs

OldVisibleDates

 List? ReadOnlyCollection?

SchedulerMonthCellDetails

Appointments

 List? ReadOnlyCollection?

SfSlider Preview

Breaking Changes

  • The default color of the TrackStyle.ActiveFill, TrackStyle.InactiveFill, ThumbStyle.Fill, ThumbOverlayStyle.Fill, and DividerStyle.InactiveFill has been updated.

SfTabView Preview

Features

  • Support has been provided to customize the spacing between the text and image.

XlsIO

Features

  • #I372558 - Provided support to draw inside horizontal and vertical borders in a worksheet range.
  • #F172476 - Provided support to import HTML table with formulas into Excel worksheet.

Breaking Changes

  • #I372558 - InsideHorizontal and InsideVertical options are included in ExcelBordersIndex enumeration to support inside horzontal and vertical borders in a worksheet range.
  • #F172476 - New enumeration overload HTMLImportOptions with Default and DetectFormulas options is included in ImportHTMLTable method of IWorksheet interface to import html table with formuals into Excel worksheet.