Essential Studio for Xamarin.Android Release Notes (Beta)

v16.3.0.17
September 11, 2018
Starting with version 16.2 (2018 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

DocIO

Features

  • #205783, #F138587 - Added Rotation property in WPicture class.
  • #209664 - Added the preservation support for signature line element in DOCX to DOCX conversion.
  • #112831, #144687, #166519, #209732 - Added support to update SectionPages field in Word to PDF conversion.

Bug Fixes

  • #209648 - Tab characters are preserved properly while converting Word document as PDF.
  • #204167, #209881 - InvalidOperationException will be no longer thrown while converting Word document as PDF.
  • #204167, #209881 - IndexOutOfRangeException will be no longer thrown while converting Word document as PDF.
  • #208660, #206994, #204167 - ArgumentOutOfRangeException will be no longer thrown while converting Word document as PDF.
  • #208268 - Paragraph spacing is now preserved properly when replacing content in table cell for Word document.
  • #F138091 - Table header is now preserved properly while converting Word document as PDF.
  • #207657 - Word document will be no longer corrupted when inserting image in Word document.
  • #208020 - paragraph spacing is preserved properly while converting Word document as PDF.
  • #208046 - Multi column is now preserved properly in Word Perfect Office Viewer while resaving Word document as RTF.
  • #207861 - Word document will be no longer corrupted in Microsoft Word 2007 application while resaving Word document.
  • #207772 - Image position is now preserved properly while converting Word document as PDF.
  • #207653 - Text shading is now preserved properly while converting Word document as PDF.
  • #207619, #205309 - Table is now preserved properly while converting Word document as PDF.
  • #204167, #209881 - Performance has been improved while converting Word document as PDF.
  • #204167, #209881 - StackOverflowException will be no longer thrown while converting Word document as PDF.
  • #205919 - Image size is now preserved properly while converting Word document as RTF.
  • #206868 - Bookmark hyperlink is now navigated properly while converting Word document as PDF.
  • #206703, #203618 - Word document will be no longer hangs while converting Word document as PDF.
  • #206993, #203639 - NullReferenceException will be no longer thrown while converting Word document as PDF.
  • #206485 - Table splitting issue has been resolved while converting Word document as PDF.
  • #206496, #205904 - Content control content is now preserved properly while converting Word document as PDF.
  • #206202, #205099, #208898, #213761 - List number is now preserved properly while converting Word document as PDF.
  • #205329, #209408, #203051 - Word document will be no longer hangs while updating document fields in Word document.
  • #205631, #205309 - Text wrapping issue has been resolved while converting Word document as PDF.
  • #205633 - NullReferenceException will be no longer thrown while parsing Word document.
  • #205309 - Table cell text preservation issue has been resolved while converting Word document as PDF.
  • #205309 - Table position issue has been resolved while converting Word document as PDF.
  • #205250 - InvalidOperationException will be no longer thrown while parsing RTF format document.
  • #205188 - StackOverflowException will be no longer thrown while updating document fields in Word document.
  • #202856 - TOC preservation issue has been resolved while converting Word document as HTML.
  • #204774 - NullReferenceException will be no longer thrown while deleting bookmark content in Word document.
  • #204774 - Bookmark content is now deleted properly in Word document.
  • #204542 - TextBox is now preserved properly while converting Word document as PDF.
  • #204342 - Paragraph spacing is now preserved properly while converting Word document as PDF.
  • #202253 - OutOfMemoryException will be no longer thrown while parsing Word document.
  • #180963, #193566 - Font preservation issue has been resolved while converting Word document as PDF.
  • #208059 - MAX field is now properly skipped from updating error result while updating fields in Word document.
  • #209408 - If field result is now properly updated while updating document fields in Word document.
  • #208463 - Paragraph tags are properly created while converting Word document as PDF with accessibility.
  • #211412, #212690 - OutOfMemoryException will be no longer thrown while performing Find & Replace functionality for Word document.
  • #210863, #211412 - ArgumentOutOfRangeException will be no longer thrown while calling the FindAll() API for Word document.
  • #208450 - Table border is now preserved properly while converting RTF document as PDF.
  • #205945 - Word document will be no longer hangs while converting Word document as PDF.
  • #211046 - The nested AutoNum field is now properly skipped while updating its container field.
  • #208117 - Hanging issue has been resolved while updating fields in Word document.
  • #211709 - Style attribute is now preserved properly while converting Word document as HTML.
  • #210867 - List number is now restarted properly on importing contents with ImportOptions as ListRestartNumbering and saving the resultant document as DOC format.
  • #209964 - List style is now preserved properly for the first paragraph inserted to a bookmark using Bookmark Navigator.
  • #204947 - Text wrapping issue has been resolved while converting Word document as PDF.
  • #206374 - Content control content is now preserved properly while converting Word document as PDF.
  • #207193 - The first dot(.) character of a paragraph within a table containing decimal tab stop position is now automatically justified like tab (\t) character while converting Word document as PDF.
  • #208463, #213468 - No more extra white spaces are added between the text while converting Word document as PDF.
  • #207687 - Reduced the generated PDF file size by skipping embedding fonts for non-Unicode text while performing Word to PDF conversion.
  • #211192 - External Workbook relation for chart is now preserved properly while resaving DOCX document.
  • #210694 - System.ArgumentNullException will be no longer thrown while converting Word document as PDF.
  • #209466 - InvalidDataException will be no longer thrown while parsing Word document.
  • #207009 - Text format is now preserved properly while performing Mail merge for Word document.
  • #210694 - DOCVARIABLE field name is now preserved properly while creating a field using AppendField() API.
  • #202856 - Tab and underline is now preserved properly in TOC while converting Word document as HTML.

PDF

Features

  • #203690 - Support for adding Long Term Validation (LTV) with digital signature and timestamp.
  • #209230 - Support for resizing the text box value based on its size.
  • #209578 - Support for retrieving the custom metadata (columns) from PDF annotation.
  • #205794 - Support for adding measurement annotations in the PDF document.
  • #113882, #114486, #124312, #124927, #133647, #136283, #163372, #174924, #166856, #199371, #210727 - Support for drawing complex script language text in the PDF document.
  • #203836 - Support for accessing PDF document hash to digitally sign the PDF document.
  • #212579 - Support for time stamping the existing PDF document.
  • #206510 - Support for getting annotation properties from the appearance content stream.
  • #203836 - Support for changing the signature appearance based on the signature validation.

Bug Fixes

  • #209067 - XML files are now importing properly as form fields.
  • #209067 - Drop-down form fields are now exporting properly as XML files.
  • #209809 - Unable to decrypt document without ID exception will no longer occur when decrypting the PDF documents.
  • #209809 - Catalog is not present exception will no longer occur when loading the PDF documents.
  • #209809, #207003 - Password is incorrect exception will no longer occur when loading the PDF documents.
  • #205727, #199398 - URI value from PdfLoadedUriAnnotation is now retrieving properly from the PDF document.
  • #205636 - “Index out of range exception” will no longer occur when loading the PDF documents.
  • #206504 - Imported document size is not increased if the source document contains hyperlinks.
  • #204160 - Content is now preserving properly when adding large text to a PdfGrid cell in landscape page.
  • #206944 - PDF signature appearance is updating properly when using appearance graphics.
  • #209484 - “Null reference exception” will no longer occur when accessing layer of the PDF document.
  • #204266 - Incorrect layer behavior and syntax issues in Preflight when creating layers in the PDF document are now fixed.
  • #207003 - “Index and length must refer to a location within the string” exception will no longer occur when loading the PDF documents.
  • #206043 - The blank page will no longer be created when rotating the PDF documents.
  • #205034 - Preservation issues will no longer occur when adding layers with overlay to PDF documents.
  • #208125 - “Argument Out Of Range exception” will no longer occur when importing pages from the PDF documents.
  • #206826 - All the form fields are now preserving properly when merging the PDF documents.
  • #206864,209809 - Hanging issues will no longer occur when importing pages form the PDF documents.
  • #208472 - PDF document corruption issue will no longer occur when merging the PDF documents.
  • #209467 - “Object reference not set to an instance of an object” exception will no longer occur when loading the PDF document.
  • #206344 - Text box fields are now preserving properly when flattening the PDF document.
  • #207010,206810 - Null reference exception will no longer occur when appending the PDF documents.
  • #204640 - “Can’t convert to rectangle” exception will no longer occur when flattening the PDF documents.

Presentation

Features

  • #205041 - Added support to directly access the columns of a PowerPoint table.
  • Added support for creating and editing slide transitions in PowerPoint presentation.

Breaking Changes

  • Setter has been added to Text property of ITextBody interface.
  • The property Style has been added to the IPresentationChart interface.

Bug Fixes

  • #209550 - ObjectReferenceException will no longer be thrown while loading a PowerPoint document created with XMLPowerTools.
  • #211236 - Individual shape bounds within the group shapes are now updated to the properties while loading a PowerPoint document.
  • #205502 - Application will no longer hang while re-saving the PowerPoint presentation.
  • AccessViolationException will no longer be thrown while re-saving a PowerPoint document with same file name.
  • StringFormatException will no longer be thrown while creating animations in Afrikaans culture.

SfAutoComplete

Bug Fixes

  • #209824: The SelectedItem property is working properly when token mode is set as wrap.

SfCalendar

Breaking Changes

  • The SfCalendar parameter is deprecated from InlineEventToggledEventArgs, DrawMonthCellEventArgs, and DrawYearCellEventArgs classes in SfCalendar.
  • The MonthChanged event will be triggered initially in SfCalendar.
  • The default appearance of navigation arrow has been changed in SfCalendar.
  • Default height of the Agenda View is 30 % of the control height.
  • The Day View Header UI has been integrated with SfCalendar UI in month view. So when swiping, MonthCells view will only be animated based on forward or backward moves.

Improvements

  • The loading and navigation performance of SfCalendar control have been improved.

SfChart

Features

  • #I196854 - Now, the chart control supports histogram series type.

  • #I205947 – The stacked doughnut support has been provided to chart.

Enhancements

  • #I151003, #I214094 - The collided axis labels can be wrapped into multiple rows.

  • #I146902, #I146877 – The GetDataPoints method has been exposed in CartesianSeries class to get the data points that falls into the given rect area or data range.

  • Now, the dashes can be applied to the polar and radar charts when they are rendered as lines.

  • Now, the color and stroke of plotting area can be customized.

Breaking changes

  • The issue where the OffsetX and OffsetY properties did not consider the device density has been fixed. So, the gap between data point and marker might be longer than expected if you have configured the  OffsetX and OffsetY properties and run them on high density Android devices.

  • The following obsolete APIs have been removed:

    • ChartSeries.DataSource

    • ChartSeries.AnimationEnabled

    • DataMarkerLabelCreatedEventArgs.P0

    • ChartTrackballBehavior.GetView(ChartSeries p0, ChartDataPoint p1, int p2)

    • ChartExtensionUtils.Get(ObservableCollection, Int32)

    • ChartExtensionUtils.Size(ObservableCollection)

    • ChartExtensionUtils.Set(IList, Int32, T)

    • ChartExtensionUtils.Add(ObservableCollection, Int32, T)

    • ChartExtensionUtils.Remove(IList, Int32)

    • ActualRangeChangedEventArgs.P0

    • LabelCreatedEventArgs.P1

    • TooltipCreatedEventArgs.P0

    • TooltipDismissEventArgs.P0

    • ResetZoomEventArgs.P1

    • ScrollEventArgs.P1

    • SelectionZoomEndEventArgs.P1

    • SelectionZoomDeltaEventArgs.P1

    • SelectionZoomStartEventArgs.P1

    • ZoomEndEventArgs.P1

    • ZoomDeltaEventArgs.P1

    • ZoomStartEventArgs.P1

    • ObservableArrayList class

    • ChartObservableArrayList class

SfCircularGauge

Bug fixes

  • # 208037 – The ObjectDisposedException will no longer be thrown when using gauge in fragments transition.

SfDataGrid

Features

  • Support for loading control in the designer by drag and dropping from the tool box and setting properties using custom attributes from axml has been provided.

SfDateTimeRangeNavigator

Features

  • The SfDateTimeRangeNavigator can be added to XML designer from the toolbox and the required attributes can be configured using property windows.

Breaking changes

  • The following obsolete APIs have been removed:

    • RangeChangedEventArgs.P1

    • RangeChangedEventArgs.P0

    • MajorScaleLabelsCreateEventArgs.P0

    • MinorScaleLabelsCreateEventArgs.P0

SfDiagram

Bug Fixes

  • #213352 - Now, “Node clicked event” triggers properly for android.
  • #211646 - System.ObjectDisposedException is properly handled while disposing SfDiagram instance.
  • #210679 - Annotation index is maintained properly when node/connector contains multiple annotations.
  • #206732 - Diagram layer bounds will update properly when changing its height/width at runtime.

Key Features

  • Overview panel support provided for diagram area.

  • Enhanced zooming from 0.01 factor to infinite.

  • Default style can be modified for node, connector, and stencil symbols.

  • Enhancement provided to move each user handle from its default position.

  • Now, hierarchy of directed tree layout can be changed by interaction at runtime.

  • Spacing support and exclude node support have been provided in directed tree layout.

  • RTL support has been provided for diagram control.

SfImageEditor

### Features

  • #194419 - Support has been provided to save the images with custom size.

  • #209326 - Support has been provided to customize the text formats such as bold, italic, and underline.

  • #198209 - Multiline support has been provided for text with alignment option.

  • #198209 - Support has been provided to save the images in different formats such as JPG, PNG, and BMP.

  • #204627 - Rotation support has been provided to text and custom view.

SfMaps

Features

  • #196656 - The ImageryLayer zooming performance has been improved by storing tile images in application cache memory.

  • Color mapping support have been provided for Bubbles.

  • Image icon type support has been provided for map marker.

  • #F138491 - Support has been provided to trim or hide the overlapping data labels.

  • Legend label customization, icon types support has been provided.

  • Support has been provided to render corresponding shape layer from layers collection by setting BaseMapIndex property.

  • ZoomLevelChanging event has been added for ImageryLayer.

SfMaskedEdit

Bug fixes

  • #211483: Now, the Mask property with empty value will show the typed text in Android

SfPdfViewer

Features

  • #168837, #177531, #178851, #F130579, #186863, #200533, #186360, #208016, #211024, #212751, #213719 - SfPdfViewer now supports bookmark navigation.

Bug Fixes

  • #206269 - Asset not found exception will no longer be thrown in Xamarin.Android graphics designer.

SfPicker

Bug Fixes

  • #212924, #213457: The ItemSource property will be updated properly when removing an item.

SfPopupLayout

Features

  • Support for loading control in the designer by drag and dropping from the tool box and setting properties using custom attributes from axml has been provided.

SfPullToRefresh

Features

  • Support for loading control in the designer by drag and dropping from the tool box and setting properties using custom attributes from axml has been provided.

SfSchedule

Bug Fixes

  • #138084 - The custom view will be rendered properly on Schedule inline view.

Features

  • Support to skip or change particular occurrences of a recurring appointment by setting exceptions for that recurring appointment.
  • Support to customize the selected date text color in month cell.

SfTabView

Bug fixes

  • #213367: Now, the SelectionChanging event works properly when insert a new TabItem dynamically in TabView.

SfTreeView Preview

TreeView is a data-oriented control displays data in a hierarchical structure with expanding and collapsing nodes. It is commonly used to illustrate a folder structure, or nested relationships in an application.

Key features

  • Binding and unbound mode - Support for binding hierarchical data or add unbound tree nodes.
  • Selection - Support for selection with different selection modes and keyboard navigation.
  • UI customization: Provides complete UI customization through adapter.

XlsIO

Features

  • #173702 - Provided support for hyperlinks in data import.
  • #52130, #56162, #135871, #166296, #178721, #180457, #180462, #197799, #198853 - Provided support to calculate external reference formula.
  • #180349 - Provided support for pivot table field sorting with direction.
  • Provided support for custom qualifier and record delimiter for CSV files.
  • #135243, #117497, #131343 - Provided support for worksheet to HTML conversion from .NETStandard 1.4.
  • #135243, #129497, #206936, #208400 - Provided support for worksheet to image conversion from .NETStandard 1.4.

Breaking changes

  • #207306 - DetectMixedValueType enumeration is added for detecting mixed data typed column values while exporting to DataTable.
  • #203029 – - TypeMismatchOnExport event and ExportEventArgs class are added in IApplication interface to notify users about the mismatch between cell type and property type while Exporting data to CLR Objects.
  • Calculate method is added in IWorksheet class to support worksheet formulas calculation.
  • #180349 - AutoSort method is added in IPivotField class.
  • CsvQualifier and CsvRecordDelimiter properties are added in IApplication interface.
  • RemoveAt() is added in WorksheetNamesCollection class to remove worksheet name at particular index.
  • #135243, #129497, #206936, #208400 - Added ExportImageOptions class with ExportImageFormat enumeration, Scaling mode and default constructor, and ConvertToImage method in IXlsIORenderer class.

Bug fixes

  • #209729 - Null reference exception thrown while adding marker variable with copy style argument is resolved.
  • #209443 - Null reference exception thrown while copying empty worksheet range is resolved.
  • #209443 - Shape is not copied properly to another range while clearing range is fixed.
  • #208554 - Application exception ambiguity conflict between Microsoft Common Object Runtime Library. and Syncfusion.Compression NuGet package is resolved.
  • #207203 – Random exceptions on accessing the RTFText property multiple times is resolved.
  • #208141 - Exception thrown while converting the chart with range collection is resolved.
  • #208122 - Exception thrown while opening a file with empty RTF text is resolved.
  • #207732 - Argument exception thrown while opening a workbook of strict XML type is resolved.
  • #207940 - Null reference exception raised while invoking auto fit columns on cells containing formulas is resolved.
  • #207176, #210642 - Issue with conditional formats on a newly created worksheet is fixed.
  • #207151 - Exception will no longer be thrown while saving the workbook created using AddCopy().
  • #206271 - Corruption issue while resaving the file with query table is resolved.
  • #206070 - Formats are preserved correctly while saving XML file as XLSX.
  • #205858 - Table formula with column name in dimension format can be set properly.
  • #204815 - Exception raised while opening an Excel file having the style count greater than maximum unique styles is fixed.
  • #204483 - XML exception raised while opening a binary file with duplicate schema is resolved.
  • #204511 - FindAll() returns expected value when ExcelFindOptions is not provided.
  • #204932 - Exception raised while setting the Fill property for un-supported chart types on opening Excel file is resolved.
  • #204742 - Data connection parameters tag is now serialized while resaving an Excel file.
  • #204130, #204484 - Exception thrown while parsing hyperlink in merged cells is resolved.
  • #203365 - Conditional formats are properly copied while adding a copy of worksheet using AddCopy().
  • #203557 - File corruption issue while generating worksheet from the data table is resolved.
  • #203396 - File corruption while removing comments with picture from the worksheet is resolved.
  • #202487 - Exception will no longer be raised while parsing invalid reference to the chart series name.
  • #204134 - Incorrect chart name retrieved for the binary file is fixed.
  • #207784 - Exception raised while copying custom functions to a different workbook is resolved.
  • #205835 - Exception raised while cloning the workbook with conditional formats is resolved.
  • Exception will no longer be thrown while applying template marker using the IWorksheet.Workbook property
  • Auto filter issue while setting IconSet conditional formatting with NoIcon is resolved.
  • #211514 - NullReferenceException thrown while opening a file in multi-thread environment is fixed.
  • #210082 - Exception thrown while copying an Excel to another document with the named range and saving is resolved.
  • #210172 - Conditional format formulas applied to the ConditionValue property are now properly updated in advanced conditional formats.
  • #210172 - Image protection in XLS documents will not be removed after resave.
  • #209739 - Exception thrown while parsing workbook with empty styles is resolved.
  • #209443 - Merged cells are now properly copied to another range during CopyTo() method.
  • #138492 - Issue with ListOfValues property in Data Validation is fixed.
  • Number formats are returned properly while parsing.
  • Print area is cleared properly when PrintArea is set to null.
  • Out of Memory exception thrown while parsing a CSV file with large number of rows is fixed.
  • Issue with clearing Rich-Text and its formatting is resolved.
  • #212859 - Conditional formats are applied properly in an Excel file generation using XlsIO.
  • #211941 - Row height value in GetRowHeightInPixels is different than Microsoft Excel for a particular document is fixed.
  • #210905 - Styles are preserved properly while resaving the document in Microsoft Excel.
  • #207242 - ArgumentException raised while parsing duplicate number formats in the workbook is fixed.
  • #212951 - XML exception raised while opening an Excel document with invalid chart properties is resolved.
  • #213480 - Data labels formula is properly updated on changing sheet name.
  • #213242 - Title and border color are properly set for the cloned charts in XlsIO.
  • Exception will no longer be thrown while creating GroupShape with VML shapes.
  • Issue with row height while parsing XML file is fixed.
  • Exception thrown while opening an Excel document in try catch block is resolved.
  • NullReferenceException will no longer be thrown during AddCopy of binary Excel worksheets with XML Excel worksheets.