Essential Studio for Xamarin.iOS Release Notes

v16.3.0.21
September 21, 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.
  • #214175 - Added support for complex script characters preservation 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.
  • #203618 - Word to PDF conversion will no longer hang while converting Word document containing text box with square wrapping style in header.
  • #206703 - Word to PDF conversion will no longer hang while converting Word document containing multiple sections with continuous break.
  • #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 no longer hang 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 to PDF conversion will no longer hang while converting DOC format Word document containing shape.
  • #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.
  • #211746, #212459, #214306, #214979 - NullReferenceException will be no longer thrown while importing HTML using AppendHTML() API of .NET Standard 2.0 assembly.
  • #207687 - Font is now embedded by default only for Unicode text to reduce the file size of generated PDF file while converting Word document as PDF.
  • #211746 - ArgumentException will be no longer thrown while performing Mail merge for multiple groups within a table.
  • #211746 - NullReferenceException will be no longer thrown while performing Mail merge for nested groups with empty commands.
  • #208292 - Word to PDF conversion will no longer hang while converting Word document with absolute positioned table extending to multiple pages.
  • #204167 - RTL text is now indented properly while converting Word document as PDF.
  • #204167 - Absolute positioned RTL table is now preserved properly while converting Word document as PDF.
  • #F138530 - Nested table with absolute position are now preserved properly while converting Word document as PDF.

PDF

Features

  • #113882, #114486, #124312, #124927, #133647, #136283, #163372, #174924, #166856, #199371, #210727 - Support for drawing complex script language text in the PDF document.
  • #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.
  • #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.
  • #212192 - AutoFontSize property is now working properly with multiline text box form field.
  • #210068 - Symbols are preserving properly when adding text to the PDF document.
  • #210539 - Throws proper exception when loading the password protected PDF document.
  • #203624 - “Argument out of range exception” will no longer occur when parsing PDF layer from the PDF document.
  • #211947 - Existing PDF document is now loading properly without exception.
  • #209974 - “Null reference exception” will no longer occur when importing pages from the specific PDF document.

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.

SfCalendar

Features

  • Support for loading the control in the designer by dragging and dropping from the tool box has been provided.

Enhancements

  • The loading and navigation performance of SfCalendar control have been improved. Now, the loading time is about 30% faster than previous versions.

Breaking Changes

  • The MonthChanged event will be raised initially 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, month cells view will only be animated based on forward or backward moves.

SfChart

Features

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

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

  • The SFChart can be added to storyboard from toolbox and preview the actual output in designer.

Enhancements

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

  • #I146902, #I146877 – The GetDataPoints method has been exposed in SFCartesianSeries 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 following obsolete APIs have been removed:

    • SFChartDelegate.DidAxisTrackballLabelsGenerate(SFChart, NSArray)

    • SFChartDelegate.DidTrackballLabelsGenerate(SFChart, NSArray)

    • SFChartTrackballBehavior.DrawTrackballGroupedLabels(NSMutableArray, CGPoint, CGRect)

    • SFChartTrackballBehavior.DidTrackballLabelsGenerate(NSArray)

SfCheckBox

Bug fixes

  • #213746 : Now, the tick will be rendered properly when the background color is set to transparent.

SfDataForm

Features

  • Support for loading the control in the designer by dragging and dropping from the tool box has been provided.

SfDataGrid

Features

  • Support for loading control in the designer by drag and dropping from the tool box has been provided.

SfDateTimeRangeNavigator

Features

  • The SfDateTimeRangeNavigator can be added to storyboard from toolbox, and the actual output can be previewed in designer.

SfDiagram

Bug Fixes

  • #211646 - System.ObjectDisposedException is properly handled while disposing SfDiagram instance.
  • #210679 - Annotation index is maintained properly when node/connector contains multiple annotations.

Features

  • Overview panel support has been added to easily navigate across the diagram area.
  • #206274 - Default appearance of the node, connector and stencil symbols can be modified now.
  • #206592 - User handle position can be moved or adjusted from its default position.
  • Hierarchy of automatic tree layout can be changed at runtime interactively by dragging and dropping over the node.
  • RTL support has been provided for diagram control.
  • Space between the nodes can be adjusted during automatic tree layouting.
  • Node can be excluded from automatic tree layouting.
  • #206732 - Now, Zoom factor can be set from 0.01 to infinite.
  • Now, Node can be aligned manually in mind map layout.

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.

  • #213018 - Support has been provided for getting original image size and actual rendered image size

SfMaps

Features

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

  • #200850, #202705 - The sublayer support has been provided to load multiple shape files in maps.

  • 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.

Breaking changes

  • SFShapeSettings's ColorMappings property type has been changed from NSMutableArray to ObservableCollection.

SfPdfViewer

Features

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

Bug Fixes

  • #204241 - Bottom toolbar will now be visible even when SfPdfViewer is used in UINavigationController.

SfPopupLayout

Features

  • Support for loading control in the designer by drag and dropping from the tool box has been provided.

SfPullToRefresh

Features

  • Support for loading control in the designer by drag and dropping from the tool box has been provided.

SfSchedule

Features

  • #208167 - Support to customize the selection circle color in month cell.
  • 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.
  • Support for loading the control in the designer by dragging and dropping from the tool box has been provided.

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.
  • Templating - Provides complete UI customization through template and template selectors.
  • Customization - Support to change expander width, indentation, item height.

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.
  • #212887 - Active cell is set properly after freeze panes.
  • #212629, #212683, #212610, #212926 - Unsupported exception thrown in Compression.Base while parsing an Excel document in XlsIO is resolved.
  • #212077 - Corruption issue due to incorrect named ranges is fixed.
  • #213412 - File corruption while applying the SubTotal function is fixed.
  • 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.
  • Incorrect seconds value for DateTime type exported from worksheet to DataTable is fixed.