Essential Studio for Xamarin.Android Release Notes (Beta)
DocIO
Features
- #205783, #F138587 - Added
Rotation
property inWPicture
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 theFindAll()
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
asListRestartNumbering
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.
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 ofITextBody
interface. - The property
Style
has been added to theIPresentationChart
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 fromInlineEventToggledEventArgs
,DrawMonthCellEventArgs
, andDrawYearCellEventArgs
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 inCartesianSeries
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
andOffsetY
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 theOffsetX
andOffsetY
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 forImageryLayer
.
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 newTabItem
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 andExportEventArgs
class are added inIApplication
interface to notify users about the mismatch between cell type and property type while Exporting data to CLR Objects. -
Calculate
method is added inIWorksheet
class to support worksheet formulas calculation. - #180349 -
AutoSort
method is added inIPivotField
class. -
CsvQualifier
andCsvRecordDelimiter
properties are added inIApplication
interface. -
RemoveAt()
is added inWorksheetNamesCollection
class to remove worksheet name at particular index. - #135243, #129497, #206936, #208400 - Added
ExportImageOptions
class withExportImageFormat
enumeration,Scaling mode
and default constructor, andConvertToImage
method inIXlsIORenderer
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 whenExcelFindOptions
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.