Essential Studio for Xamarin.Android Release Notes

v17.1.0.38

March 27, 2019

DocIO

Features

#225207 - Support has been added to preserve chart while converting a Word document to PDF.
#215654, #215551, #217709, #217596, #213468, #220078, #221808, #218691, #221806, #220279, #218691, #223653 - Improved text size calculation in Word to PDF conversion.
#219302, #224607, #224937 - Improved font retrieval and substitution algorithm in Word to PDF conversion.
#225752 – Provided support to update unknown type fields in a Word document.
#224654 – API has been added to set created date and time for Word document comments.
#223907 - API has been added to skip the Complex format is not supported exception while opening an incrementally saved DOC format Word document.

Bug Fixes

#221972 - Text is now highlighted properly while converting a Word document to tagged PDF.
#223350 - Table cell is now preserved properly while opening an HTML document.
#222922 - Image is now preserved properly while converting a Word document to PDF.
#222713 - The ArgumentException will no longer be thrown while adding a table.
#222608 - Font name is now preserved properly while converting an HTML document to Word document.
#222751 - The StackOverFlowException will no longer be thrown while converting a Word document to PDF.
#222670 - Inline content control text is now preserved properly while converting a Word document to PDF.
#222320 - Hyperlink is now preserved properly in inline content control while converting a Word document to PDF.
#222345 - The ArgumentOutOfRangeException will no longer be thrown while updating TOC in RTF format document.
#221260 - Line space preservation issue has been resolved While converting a Word document to PDF.
#221153 - Inline content control custom XML data is now preserved properly while converting a Word document to PDF.
#221725 - The ArgumentOutOfRangeException will no longer be thrown while cloning a Word document.
#221611 - The NullReferenceException will no longer be thrown while saving a Word document.
#220710 - Table row is now preserved properly while converting a Word document to PDF.
#220324 - Checkbox content control state is now preserved properly while cloning a Word document.
#221119 - List number is now preserved properly while opening an RTF format document.
#218943 - List bullet is now preserved properly while opening an RTF format document.
#221974 - Gray scale recoloring is now preserved properly while converting a Word document to PDF.
#219092 - Merge field before and after text is now preserved properly while executing mail merge.
#223340 - The IndexOutOfRangeException will no longer be thrown while converting a Word document to PDF.
#222852 - Footer content is now preserved properly while merging multiple RTF documents.
#223355 - Tab is now preserved properly while converting a cloned Word document to Image.
#223510 - Text overlapping issue has been resolved while converting a Word document to PDF.
#223931 - The ArgumentException will no longer be thrown while converting a Word document to PDF.
#222588 - Formula field result is now preserved properly while updating the Word document fields.
#224323, #225518, #225883 - The NullReferenceException will no longer be thrown while calling the GetText API.
#224412 - Tab is now preserved properly while converting a Word document to PDF.
#224287 - Image is now preserved properly while converting a Word document to PDF.
#223508 - Word document instance is now disposed properly while converting a Word document to PDF.
#225386 - Page field is now preserved properly while converting a Word document to PDF.
#225611, #225386 - Table content is now preserved properly while converting a Word document to PDF.
#218799 - Pagination issue has been resolved while converting a Word document to PDF.
#224351, #224561 - Inline content control’s text is now preserved properly while converting a Word document to PDF.
#224062, #226901 - Table border is now preserved properly while converting a Word document as RTF.
#226599, #226243, #220279 - Table is now preserved properly while converting a Word document to PDF.
#226599, #226243, #225970, #225679, #226352, #223713, #223959, #224412, #221455 - Hanging issue has been resolved while converting a Word document to PDF.
#226243 - Frame content is now preserved properly while converting a Word document to PDF.
#227112 - The NullReferenceException will no longer be thrown while updating the Word document fields.
#224637 - Picture preservation issue has been resolved while converting a Word document to PDF.
#225091 - Check box is now preserved properly while converting a Word document to PDF.
#225458, #223134 - Table row border is now preserved properly while converting a Word document to PDF.
#225091 - Underline is now preserved properly while converting a Word document to PDF.
#224701 - Univers 45 Light font is now preserved properly while converting a Word document to PDF.
#225176 - Image is now preserved properly while converting the RTF document to HTML.
#226725 - Embedded Microsoft Visio (VSDX) object is now preserved properly in DOCX to DOCX conversion.
#220362 - Picture watermark is now preserved properly while resaving the RTF document.
#225947 - Number format is now preserved properly while performing Mail merge.
#225062 - Image is now preserved properly while importing a Word document.
#218957, #220198 - The ArgumentException will no longer be thrown while converting a Word document to PDF.
#225481 - The NotSupportedException will no longer be thrown while opening an HTML document.
#225481 - Image size is now preserved properly while opening an HTML document.
#225481 - Table border is now preserved properly while opening an HTML document.
#218799 – Text format is now preserved properly while converting a Word document to PDF.
#218799, #225679 – Text box is now preserved properly while converting a Word document to PDF.
#225386 – Table cell is now preserved properly while converting a Word document to PDF.
#221089 – Picture watermark is now preserved properly while converting a Word document to PDF.
#227058 – Html contains not well formatted table will no longer be thrown while opening an HTML document with caption tag.
#223350 – Vertical merged cells are now preserved properly while opening an HTML document.
#217709, #231056 – Unicode character ‘€’ is now preserved properly while converting a Word document to PDF.

PDF

Features

#136187 - Added support to create the ZUGFeRD PDF invoice.
#135996, #179159, #124105 - Added support to create the PDF/A-2b and PDF/A-3b conformance level document.
#222759, #226015 - Added support to import and export a PDF annotation with FDF and XFDF formats.
Added support to rotate annotations.
#220871 - Added support to retrieve the acroform radio button option values.
#141170, #222335, #223048 - Added support to retrieve review status and comments from a PDF annotation.
#221779 - Added support to update the layout result.
#194410, #198765 - Added support to create an ink annotation with ink list collection.
#141253 - Added support to create multiple range of page labels.
#227357 - Added option value support to import and export the radio button field.

Breaking Changes

#223629 – Now, by default, EnableMemoryOptimization is set to false when append the PDF files, so close the existing PDF document after saving the new PDF document.
Free text annotation call-out line coordinate points are now changed to top to bottom.
Annotations are now rotating based on the page rotation in an existing PDF document.

Bug Fixes

#215133 - Performance has been improved when accessing the PDF document layers.
#210943, #216074 - String was not recognized as a valid DateTime exception will no longer occur while loading a PDF document.
#215941 - Barcode is now preserving with proper size when specifying the size of a barcode.
#215595 - The 1D barcode is now scanning properly with default width.
#215096 - FNC characters in the given input is now preserving properly for PdfGS1Code128Barcode.
#215166 - The Null-reference exception will no longer occur while loading a PDF document.
#214918 - Light table header is now preserving properly when providing the data source through IEnumerable.
#214401 - The ArgumentException will no longer occur when loading a PDF document.
#219778 - Object reference not set to an instance of an object exception will no longer occur when saving the PdfInkAnnotation.
#217829 - Index was outside the bounds of the array exception will no longer occur when loading the PDF document.
#220618 - “Object reference not set to an instance of an object exception will no longer occur when creating PDF signature..
#219990 - Text mark annotation is now preserving properly when flatten the PDF document.
#217865 - NullReferenceException will no longer occur while removing custom metadata entries.
#218695 - Bookmark destination is now preserving properly after reading the bookmark.
#218348 - Gap between barcode data sections is now preserving properly when drawing 1D barcode to PDF.
#218231 - The PdfCode128Barcode Size property is now working properly.
#218235 - Barcodes are now preserving properly with its default size.
#218230 - Exception will no longer occur when getting the size of the PdfCode128Barcode.
#217889 - The PDF document is now preserving properly when drawing a string with OTF font.
#219709 - Object reference not set instance of an object exception will no longer occur when drawing PdfGrid in a PDF.
#218192, #218299 - NullReferenceException will no longer occur when saving the document with EnableValidationAppearance.
#227081 – Row span is now applying properly in PdfGrid header.
#224992, #225719 – Argument out of range exception will no longer occurs when importing pages from a PDF document.
#227605 – Border width is now retrieving properly from the free text annotation.
#226916 – Documents will no longer be corrupted when creating PDF template from imported PDF document.
#226124 - PDF lexer issues are now thrown with PdfException.
#226167 – PDF documents will no longer be corrupted after modifying the PDF document information.
#221393, #221376 – Memory leaks will no longer occurs when converting Word document to PDF.
#225910 – The “PathException” will no longer occurs while retrieving custom metadata from an existing PDF document.
#225853 – Display date format is now preserving properly while filling the PdfLoadedXfaDateTimeField.
#225896 – “ArgumentOutOfRangeException” will no longer occurs while importing the PDF document.
#222797, #225325 – Vertical alignment of the Thai language text is now preserving properly.
#223629 – Performance of the PDF append method is now improved.
#224583 – Font size is now preserving properly in combo box field.
#224603 – Null reference exception will no longer occurs while merging certain PDF documents.
#223346 – Images are now preserving properly while encrypting the PDF document.
#224531 – Null reference exception will no longer occurs while saving the PDF document.
#224269 – Free text annotation’s properties are now retrieving properly.
#221805 – Fonts are now embedding properly in conformance enabled PDF document.
#141148 – Tool tip is now changing as expected for PdfSignatureField.
#219569 – Arithmetic overflow exception will no longer occurs while signing the PDF document.
#185722 – PDF document content is now preserving properly after merging the PDF files.
#224887 – Added PDF signatures are now valid.
#221808, #205098 – Text is now preserving properly while converting Word document to PDF.
#225055 – The bounds are now retrieving properly from PdfLoadedTextBoxField.
#225055 – RTL text is now preserving properly in PDF form fields.

Presentation

Features

#220046 - Support has been added to convert PowerPoint presentation to Image in Xamarin applications.
#220046 - Support has been added to convert PowerPoint presentation to PDF document in Xamarin applications.
#227243 - Support has been added to add the OLE Object into PowerPoint slide as link.

Bug Fixes

#224226 - Application will no more hang while adding an image to a PowerPoint slide.
#225390 - PowerPoint file will no longer get corrupted while resaving multiple times with charts.
#222440 - Notes in a PowerPoint slide can now be cloned and added to another slide.
#228231 - Application will no more hang while opening the PowerPoint document with empty field tag.

SfCalendar

Features

In MonthViewSettings, TodaySelectionTextColor and TodaySelectionBackgroundColor properties have been implemented to change the today selection text color and background color.
#203221- The Circle selection feature has been implemented in SfCalendar.
#211133 - Hide trailing dates and leading dates support has been provided.

Breaking Changes

In SfCalendar, circle RangeSelection will be drawn as in iOS.
The selection range will be drawn based on the touch movement in RangeSelection and MultiRangeSelection of SfCalendar.
In MonthViewSettings, the default InlineBackgroundColor has been changed from E6E6E6 to F7F7F7.
In MonthViewSettings, the default DateSelectionColor has been changed from E9E9E9 to ECECEC.
In SfCalendar MonthHeader, , has been removed between the Year and Month title.
In SfCalendar, the default month cell text size has been changed from 10 to 15.
The default SelectionRadius value has been changed to render the selection circle based on the available height of month cell without overlapping appointment indicator.
In MonthViewSettings, the default DateTextAlignment has been changed from Default to Center.
In MonthViewSettings, the default DayLabelTextAlignment has been changed from Left to Center.
In SfCalendar, the boldness of the header has been reduced from Bold to None.
In SfCalendar, the default header arrow height and width has been changed from 25, 12 to 20, 10.
The navigation arrows will be shown on right side of the SfCalendar header.
The DayHeader default values have been changed from Sun, Mon, Tue, Wed, Thu, Fri, Sat to S, M, T, W, T, F, S.
In MonthViewSettings, the default CellGridOptions has been changed from Horizontal to None.
Now, the default DayHeader height has been changed from 50 to 30.
In MonthViewSettings, the default SelectionShape has been changed from Fill to Circle.
In SfCalendar, MonthView, InlineLayout, MonthArray, and ViewRender classes access modifiers have been changed from public to internal.
MonthHeight, MonthWidth properties has been removed from MonthView class in SfCalendar.
In SfCalendar, MonthHeader class has been removed.
In InlineTappedEventArgs, the ViewRenderer property has been removed.
In MonthCell, IsCurrentMonth and Date properties setter access modifiers have been changed from public to internal.
MonthLayoutBackgroundColor will not be applied on YearView when setting custom YearView in SfCalendar.
In MonthLabelSettings, DateFormat has been marked as Obsolete.
In ViewRenderer, GetYearView method access modifier has been changed from public to private.
In ViewRenderer, GetCalendarIndex method access modifier has been changed from public to internal.
In ViewRenderer, DrawMultipleMonthSelectionRectangle and GetCell coordinates methods have been removed.
In SfCalendar, CalendarWidth and CalendarHeight properties access modifiers have been changed from public to internal.
In SfCalendar, VisibleDates and DisplayDate properties setter access modifiers has been changed from public to internal.
In SfCalendar, CalendarDateHeaderSize property has been marked as Obsolete.
AddDatesInPast method marked as Obsolete from SfCalendar. Use EnableDatesInPast instead.
SetShowHeader and get_IsShowHeader methods marked as Obsolete from SfCalendar. Use ShowHeader instead.
UpdateCalendar, RefreshHeader methods marked as Obsolete from SfCalendar.
In MonthViewSettings, DayCellFontAttribute has been marked as Obsolete.
In YearViewSettings, SelectionPressedBackground has been marked as Obsolete.
In SfCalendar, TransitionMode and CalendarDateHeaderSize properties has been marked as Obsolete.
In SfCalendar, Forward arrow will be disabled when it reaches MinDate and Backward arrow will be disabled when it reaches MaxDate.

SfComboBox

Bug fixes

#I227144, #I227948 - The SelectedValue property works properly in Token mode.
#I226374 - CustomView of the dropdown button is displayed properly.
#I229266 - The IsEnabled property works properly when using combobox inside the SfDataForm control.

SfDataForm

Bug Fixes

#219892 – Now, DataFormItems renders properly when DataFormItemManager updates asynchronously from services.

Features

#140080 – Provided ValidationCompleted event support to get invalid DataFormItems details when dataform ValidationMode is set to explicit. Support has also been provided to scroll to the specific editor using ScrollTo method available by passing the property name.

Breaking Changes

The base class of DataFormTextItem has been changed from DataFormItem to DataFormTextItemBase. The DataFormTextItem keyboard type settings have been moved to DataFormTextItemBase.
The IList< DataFormItemBase > interface implementation has been removed from DataFormItems class, and interface members have also been removed. Now, DataFormItems class is directly inherited from the List<DataFormItemBase>. All existing IList< DataFormItemBase > interface members behavior works as it is, except the foreach loop that returns grouped items as a single DataFormGroupItem. Each dataform grouped item can be retrieved by using the DataFormItems property of DataFormGroupItem, or else use the for loop to get each DataFormItem in the DataFormGroupItem.
The DataFormsItems property setter has been changed to internal from public in SfDataForm class.

SfDataGrid

Features

#I210389, #I213091 - Support has been provided for notification of scroll state changes via the ScrollStateChanged event.
Support has been provided to scroll a row or column to a particular position in data grid using programmatic scrolling.
Support has been provided to cancel auto scrolling during the drag-and-drop operation of a row or column.

Bug Fixes

#I225015, #I227676,# I230137 - Scrolling vertically in SfDataGrid in Samsung Galaxy Note 8 and S8 devices works properly.

SfDiagram

Features

#214069 - Padding support for save as image has been provided.
#214099 - Now, SfDiagram supports connector’s constraints.

SfPdfViewer

Bug Fixes

#142673 – Free text annotation edit popup will now be displayed properly in landscape mode.
#226750 – InkAdded event will now be triggered while adding signature to a PDF document.
#226742 – More options button will now work properly.
#230786 – Application will no longer crash when loading the PDF document.
#228578 – Form field values will now be preserved in the saved PDF document.
#227860, #228012 – Form field data in a PDF will now be visible directly in Adobe Reader which is saved using SfPdfViewer.
#142476 – The FreeTextPopupDisappeared event will now be triggered when the free text edit popup disappears.
#226089 – Large PDF documents are now loaded in SfPdfViewer with minimal time.
#226089 – Pages are now navigated in SfPdfViewer with minimal time using TOC.
#218383 – Application will no longer crash while unloading the SfPdfViewer control.
#225495 – Application will no longer crash while editing an existing ink annotation in the loaded PDF document.
#225516, #225331, #223565 – PDF document will now be displayed properly and application will no longer crash on unload when SfPdfViewer is added to ContentPage.

Features

#224597 – Provided support to remove page number label while scrolling using scroll head.

SfPicker

Features

#I207554, #I207803, #F132375, #F136839, #I218035, #I226541 - Support has been provided to customize the text color and background color of the OK and Cancel buttons in footer view.

SfPopupLayout

Features

Support has been provided to change the flow of text to the right-to-left direction.

Bug Fixes

#I224985 - By default, PopupView fits within the screen bounds when it is launched in Android_Emulator_x_86_Oreo.
#I226296, #I226867, #I226868 - Exception will no longer be thrown when displaying the pop-up in devices running less than API 21(Lollipop).
#F143132 - Pop-up will no longer be shown at a different position when opening it second time inside a navigation page.

SfSegmentedControl

Enhancements

Layout and UI have been improved in SfSegmentedControl. Now, selection strip is drawn inside the segment border.

SfTreeView

Features

The ExpanderPosition support has been provided to change the expander icon position in SfTreeView.
Animation support has been provided to expand or collapse nodes in SfTreeView.
The Hierarchy adapter support has been provided to SfTreeView.
The Load on Demand support has been provided to add child nodes when the expander is tapped in SfTreeView.
Support has been provided to update the ChildItems when the property in underlying model is changed in SfTreeView.
Support has been provided for Real-time updates when binding ItemsSource for both Bound and Unbound modes in SfTreeView.

XlsIO

Features

#F99670, #185459, #194756, #197860 - Added support for custom table styles in Excel.
#128585, #132019, #224861 - Provided support to format unique and duplicate values in conditional formatting.
#199594, #199992, #206375, #206374, #209766, #F139259, #218497, #225207 - Provided support for chart to image/PDF conversion in .NET Standard.
#222797 - Added support for complex script rendering in Excel to PDF conversion.
Provided support for PDF conformance level in Excel to PDF conversion.
Added support for Excel 2019 version in XlsIO.

Breaking Changes

#F99670, #185459, #194756, #197860 - The TableStyles property is added in IWorkbook interface to get the table styles collection for adding custom table styles.
#128585, #132019, #224861 - The Unique and Duplicate types are included in ExcelCFType enumeration to highlight the cells with unique and duplicate values using conditional formatting feature.
#199594, #199992, #206375, #206374, #209766, #F139259, #218497, #225207 - Added ExportChartImageOptions property and ConvertToPDF() and ConvertToImage() methods in IXlsIORenderer class and SaveAsImage() method in IChart interface.
#222797 - AutoDetectComplexScript has been added in ExcelToPdfConverterSettings class to support complex script rendering in Excel to PDF conversion.
Enumeration PdfConformanceLevel is added in ExcelToPdfConverterSettings class to set conformance level in PDF document that is converted from Excel.
Type Xlsx is added in ExcelVersion enumeration to represent Excel version 2019 and above.

Bug Fixes

#224892 - Unlocked cells are unlocked while moving range from protected worksheet to another worksheet.
#226242 - Display text return improper value in French culture issue is resolved.
#225272 - Exception is no longer thrown while converting CSV document to PDF with NULL character.
#222397, #222732 - Table with query is now preserved properly on invoking Table.Refresh().
#223856, #224976 - File will no longer be corrupted while copying a range with multiple list objects.
#226454 - The IndexOutOfRange exception will no longer be thrown while converting Excel document into PDF with header and footer.
#224770 - Exception will no longer be thrown while exporting worksheet data into data table.
#223667 - Exception will no longer be thrown if chart’s data range column is deleted.
#225065 - Currency number format is now properly detected in XlsIO generated Excel file.
#224023 - Exception thrown while opening an XlsIO re-saved document with group shape has been resolved.
#223946 - Conditional format is now preserved properly while saving the workbook multiple times.
#223839 - Infinite recursive loop on modifying and saving Excel document with improper chart series indices has been resolved.
#224024 - Not implemented exception thrown while opening an Excel document with external formula range in check box has been fixed.
#223448 - Pivot table field settings are now preserved properly on resaving the Excel file.
#223167 - Custom time format [h]:mm:ss is now detected automatically.
#223376 - Exception occurs while saving the Excel document with OLE object has been resolved.
#223226 - The NullReferenceException thrown when converting an Excel file to HTML has been fixed.
#223041 - Data validation formula is now preserved properly while saving the Excel document as XML.
#221229 - Issue with pivot field values due to improper pivot field data format has been resolved.
#214445 - Table.Refresh() is now working properly with ODBC connection.
#223918 - Conditional format is now preserved properly on converting Excel document to PDF.
#223859 - Hyperlink is now set properly in Excel to PDF conversion.
#221079 - Exception thrown if print-title row height is higher in Excel to PDF conversion has been fixed.
#221693 - The Parameter invalid exception thrown while converting Excel document to PDF has been fixed.
#222797 - Incorrect Thai font in Excel to PDF conversion has been fixed.
#222156 - Improper number detection with invariant culture has been fixed.
#F142414 - Show all item is not enable issue is fixed while resaving the file with pivot table.
#F141101 - Issue with incorrect parsing of comments has been resolved.
Worksheet LastRow will be properly working when inserting rows beyond used range.
Issue with incorrect conditional formatting operator type in resaved Excel document has been fixed.
Setting a table column header name will no longer corrupt the Excel document.
DataBar color is now applied properly for negative values.
External formula is now applied properly in .NET Standard.
Shapes rendering issue for curved shapes in Presentation to Image conversion has been fixed.