Essential Studio for MAUI Release Notes

v20.2.0.36
June 30, 2022
Starting with version 20.2 (2022 Vol 2), you need to include a valid license key (either paid or trial key) within your applications. Please refer to this help topic for more information

Common

New Controls

The below controls are added newly.

  • SfAvatarView
  • SfBusyIndicator
  • SfDataGrid
  • SfMaps
  • SfSignaturePad

Features

  • The below controls are now production ready.

    • SfRadialGauge
    • SfLinearGauge
    • SfBarCodeGenerator
    • DocIO
    • PDF
    • Presentation
    • XlsIO
  • Now licensing has been enabled for the production ready controls. Refer this for more details regarding licensing.

Known Issues

The license popup may not be displayed in some cases on the Windows Platform. Framework Issue Link

SfDataGrid New

The .NET MAUI DataGrid control is used to display and manipulate data in a tabular view. It was built from the ground up to achieve the best possible performance, even when loading large amounts of data.

Key features

  • Data binding: Bind different types of data sources, including DataTable.
  • Column types: Show different data types in different types of columns. The following column types are supported: numeric, text, date, checkbox, image, and template. The template column is used to load any control in a column.
  • Sorting: Interactively sort one or more columns.
  • Filtering: Programmatically filter data based on the criteria.
  • Column sizing: Set the width of columns with various sizing options. Columns can also be sized based on their content.
  • Auto row height: Set the height for rows based on the content of their cells.
  • Selection: Select one or more rows. Keyboard navigation is supported for Windows in platform.
  • Styling: Customize the appearance of cells and headers. Conditional styling is supported.

DocIO

Features

  • #I193695, #I204886, #I206463, #I206930, #I207625, #I208400, #I219802, #I223333, #I224205, #I224532, #I230524, #I286086, #I288430, #I304956, #I310217, #I135185, #I135243, #I156004, #F119389, #I157231, #F125603, #I163232, #I164076, #I164410, #I164724, #I167776, #I170758, #F129910, #F129911, #I177323, #I156820, #I182239, #I189834, #I197733, #I158678, #I161942, #I175960, #I178173, #I169491, #I180412, #I181509, #I183143, #I183750, #F131672, #I185703, #I185793, #I185927, #I186314, #I173965, #I187805, #I188727, #I193069, #I193695, #I184554, #I195475, #I195671, #F127227, #I197345, #I197187, #F132419, #I197374, #I198721 – Convert Word document to images.
  • #FB28877- Insert text wrapping break in a Word document.
  • #I61189, #I244076 – Customize the mail merge execution to start a new page for each group of records in a Word document.
  • #I343315 – Access or set the internal margins for shapes in the Word document.
  • #I315632 – Create a Waterfall chart in the DOCX format document.
  • DotDotDashHeavy, DottedHeavy, and Thick underline styles render as they are in the input Word document during Word to PDF conversion.

Bug Fixes

  • #I380680, #I381402 - Bookmark content is now deleted properly while calling DeleteBookmarkContent API.
  • #I379675 - The IndexOutOfRangeException will no longer be thrown while deleting the bookmark content.
  • #I379146 - Map chart is now preserved properly while resaving a DOCX format document.
  • #I378787 - Shape border is now preserved properly while converting a Word document to PDF.
  • #I376761 - Table is now preserved properly while resaving a DOC format document.
  • #I375541 - TextBox line join type is now preserved properly while converting a DOCX document to PDF.
  • #I376003 - Words and characters counts are now updated properly while calling UpdateWordCount API.
  • WPicture.IsMetaFile property is now updated properly for metafile image.

PDF

Features

  • Added a PDF/A-4 conformance creation and conversion support.
  • #I381316 - Added support to create, edit, and remove watermark annotations.
  • Added a high-level API to convert images to PDF documents.
  • Added support to create, edit, and remove the rich media annotations.
  • #F174432 - Added support to get the timestamp certificate from the signature validation result.
  • #I364032 - Added support to flatten annotations without calling the save method.
  • #I360243, F174432 - Added support to get the detail of the signature’s validity from the PdfSignatureValidationResult.
  • Added the property changed event support for the annotations.
  • Added support to split a PDF document by fixed and custom ranges.
  • #376619 - Added support for the PdfGS1Code128Barcode and PdfCode128Barcode.

Bug Fixes

  • #I380779 - The PDF form field visibility is not working properly from an existing PDF document.
  • #I384734 - The Preservation issue no longer occurs while adding Unicode characters to the PDF form fields.
  • #I385168 - The orientation is properly preserved while trying to import the rotated PDF pages to a new pdf document.
  • #I382887 - The invalid cross-reference table exception will no longer occur while merging a PDF document.
  • #I381950 - The widget annotation properly shows in viewers after merging the cropped PDF documents.
  • #I382355 - A fatal error will no longer occur while opening a PDF document with open and repair mode.
  • #I381563 - An exception will no longer occur when reusing the input stream without closing a PDF document completely.
  • #I380561 - The dropdown field values are imported properly with the dynamic xml file.
  • #F175170 - The PDF signature validation passed when verifying digitally signed with the ECDSA-SHA256 algorithm.
  • #I379400, I380182 - The preservation issue will no longer occur while adding the image into the signature appearance and draw position.
  • #I380425 - The shape is preserved properly while converting the Presentation to a PDF document.
  • #I378529 - The preservation issue will no longer occur after rotating the document and adding a stamp to a PDF document.
  • #I369183 - The rotation is considered while creating a template from the rotated PDF document.
  • #I385801 - The document corruption issue will no longer occur while modifying a specific Pdf document.
  • #I380301 - The runtime and preservation issue will no longer occur when flattening the form field in a particular PDF document.
  • #F35262 - The PdfGrid is preserved properly at the bottom while adding the header and footer.
  • #I383513 - The acrobat reader recognized the required mark fields for the text box and list box created using the PDF library.
  • #I386166 - The incorrect field name exception will no longer occur when trying to receive the value from the newly added form field.
  • #I381517 - Now, the border width is set properly to the textbox field.
  • #I382945 - The invalid type cast exception will no longer occur while retrieving the newly added form fields.
  • #I381698 - The preservation issue will no longer occur after filing the back color to the combed text box field in a PDF document.
  • #I379204 - The preservation issue will no longer occur while filling the text box field on a particular PDF document.
  • #I379233 - Shapes are properly drawn with the transparent color using PdfPen.
  • #I372110 - The Pages are properly added when you collect the page record collection from the loaded PDF document.
  • #I374592 - The bookmark child is not exported multiple times while splitting a PDF document.
  • #I372759 - The numeric format is considered when filling a text form field in a PDF document.
  • #I371581 - The annotations will be active after flattening annotations in the specific PDF documents.
  • #I374556 - The PdfGrid borders are preserved properly while setting the pagination bounds.
  • #I375568 - Now, shapes are filled properly with transparent brush colors.

Presentation

Bug Fixes

  • #I380434 - Line spacing is now applied properly while converting a PowerPoint presentation to PDF.

SfAvatarView Preview

The Avatar View control for .NET MAUI provides a graphical representation of a user’s image. The view can be customized by adding an image, gradient background, group view, and more.

Key Features

  • Display initials, images, and font icons.
  • Customize the border color, background color, and corner radius in the view.
  • Add up to three images or initials in a single view.
  • Use different types of visual styles.
  • Add gradient backgrounds.

SfBusyIndicator Preview

The Busy Indicator control for .NET MAUI provides a visual representation of an app loading, data processing, etc. It can be customized in terms of size, color, speed, and more.

Key Features

  • Choose from three different animation types: [Circular Material, Linear Material, and Cupertino].
  • Customize the indicator color and overlay background.
  • Customize the animation duration.
  • Customize the size of the indicator.
  • Display a title with font customizations.

SfCartesianChart Preview

Features

  • Provided support to get the actual minimum and maximum range of the Numerical and DateTime axis.

Bug Fixes

  • Now, the .NET MAUI Cartesian chart will expand to the available size.

SfDateTimeRangeSelector Preview

Features

  • Extend track: Provides an option to extend the track edges based on the given pixel value.
  • Edge labels placement: Provides an option to place the edge labels inside the track bounds or based on the interval.
  • Command support: Commands added for drag start and drag end events.

SfDateTimeRangeSlider Preview

Features

  • Extend track: Provides an option to extend the track edges based on the given pixel value.
  • Edge labels placement: Provides an option to place the edge labels inside the track bounds or based on the interval.
  • Command support: Commands added for drag start and drag end events.

SfDateTimeSlider Preview

Features

  • Extend track: Provides an option to extend the track edges based on the given pixel value.
  • Edge labels placement: Provides an option to place the edge labels inside the track bounds or based on the interval.
  • Command support: Commands added for drag start and drag end events.

SfListView Preview

Features

  • Provided the key navigation support for the Android platform.
  • [WinUI] Provided support to handle the ScrollBarVisibility.

SfMaps New

The .NET MAUI Maps control is a powerful data visualization component that displays statistical information for a geographical area. It has highly interactive and customizable features such as selection, tooltip, legends, markers, bubbles, and color mapping. You can generate maps for population density, sales, political boundaries, weather, elections, and routes by using the Maps control.

Key features

  • Shape layer - Visualize the map area from GeoJSON or shapefile input data.
  • Data labels - Provide identification for shapes by displaying their names. If the labels exceed the shape bounds, they are trimmed or hidden.
  • Markers - Denote a location with built-in symbols or display custom content at a specific latitude and longitude on a map.
  • Bubbles - Add information to shapes such as population density or number of users. Bubbles can be rendered in different colors and sizes based on the data values of their assigned shapes.
  • Shape selection - Choose a shape to highlight a region on a map. You can use the callback for performing action during the shape selection.
  • Legends - Use legends to provide clear information on the data plotted in a map.
  • Colors - Categorize the shapes on a map by assigning their colors based on their underlying values. It is possible to set the shape color for a specific value or for a range of values.
  • Tooltip - Display additional information about shapes, markers, and bubbles using a customizable tooltip on a map.

SfRangeSelector Preview

Features

  • Extend track: Provides an option to extend the track edges based on the given pixel value.
  • Edge labels placement: Provides an option to place the edge labels inside the track bounds or based on the interval.
  • Command support: Commands added for drag start and drag end events.

SfRangeSlider Preview

Features

  • Extend track: Provides an option to extend the track edges based on the given pixel value.
  • Edge labels placement: Provides an option to place the edge labels inside the track bounds or based on the interval.
  • Command support: Commands added for drag start and drag end events.

SfScheduler Preview

Features

  • Provided the support to group the Scheduler resources and their appointments in timeline day, timeline week, timeline workweek, and timeline month views.
  • Provided the support to different types of calendars such as the Gregorian, Arabic, Hebrew, and more.
  • Provided the support to customize the number of weeks visible in month view.
  • Provided the support to customize the number of days visible in the days and timeline views.
  • Provided the support for monthly recurring appointments on the last day of every month.

Breaking changes

Find the following class and API breaking changes:

Class name Existing API New API

SchedulerAppointment

Data

DataItem

SfSignaturePad New

The .NET MAUI Signature Pad (SfSignaturePad) is a highly interactive UI control that allows you to capture smooth and realistic signatures through drawing. You can also save the signature as an image, which can further be synchronized with your devices and documents that need your signature.

Key features

  • Stroke color: Allows you to customize the stroke color of the signature.
  • Stroke thickness: Allows you to set the minimum and maximum stroke thickness for the signature.
  • Save as image: Save the drawn the signature as an image. This can be used in any of the devices or documents which requires one.
  • Realistic handwritten look and feel: The unique stroke rendering algorithm draws the signature based on the speed of the drawn gestures along minimum and maximum stroke thicknesses, which gives a realistic hand-written look and feel to the signature.

SfSlider Preview

Features

  • Extend track: Provides an option to extend the track edges based on the given pixel value.
  • Edge labels placement: Provides an option to place the edge labels inside the track bounds or based on the interval.
  • Command support: Commands added for drag start and drag end events.

XlsIO

Breaking Changes

  • #I375327 - IsSerializePivotCache boolean property is added in IPivotCache interface to save pivot cache when required.
  • #I376580 - Changed the visibility of the CompoundFileException class from internal to public to catch the exception in the try-catch block.

Bug Fixes

  • #I382987 - The application hanging issue while opening the Excel document with whitespace in drawing XML element is fixed.