Essential Studio for Universal Windows Platform 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

Common

Breaking Changes

  • Starting with version 16.3 (2018 Vol 3), we have changed the names of a few NuGet packages to better reflect their functionality on various platforms. The list of packages and their new names can be found in this KB article.

DocIO

Features

  • #205783, #F138587 - Added Rotation property in WPicture class.
  • #209664 - Added the preservation support for signature line element in DOCX to DOCX conversion.

Bug Fixes

  • #208268 - Paragraph spacing is now preserved properly when replacing content in table cell for Word document.
  • #207657 - Word document will be no longer corrupted when inserting image in Word document.
  • #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.
  • #205919 - Image size is now preserved properly while converting Word document as RTF.
  • #205633 - NullReferenceException will be no longer thrown while parsing Word document.
  • #205250 - InvalidOperationException will be no longer thrown while parsing RTF format document.
  • #204774 - NullReferenceException will be no longer thrown while deleting bookmark content in Word document.
  • #204774 - Bookmark content is now deleted properly in Word document.
  • #202253 - OutOfMemoryException will be no longer thrown while parsing Word document.
  • #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.
  • #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.
  • #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.
  • #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.
  • #211709 - Style attribute is now preserved properly while converting Word document as HTML.
  • #211192 - External Workbook relation for chart is now preserved properly while resaving DOCX document.
  • #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 - 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.

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

  • #205737 - Text orientation in SmartArt nodes are preserved properly while converting a PowerPoint slide to an image.
  • #205502 - Application will no longer hang while re-saving the PowerPoint presentation.
  • #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.
  • #209572 - Text orientation in SmartArt nodes are preserved properly while converting a PowerPoint slide to an image.
  • #211236 - Title text character spacings are now preserved equivalent to the PowerPoint document while converting a slide as image
  • StringFormatException will no longer be thrown while creating animations in Afrikaans culture.
  • AccessViolationException will no longer be thrown while re-saving a PowerPoint document with same file name.

SfCalendar

Breaking Changes

  • The MonthChanged event will be raised initially in SfCalendar.

SfCellGrid

Bug Fixes

  • #211056 - Overlapping issue of the scroll bars in last row and column has been fixed.

SfDataGrid

Feature

  • The performance has been improved when calculating caption summary and group summary. Now, the datagrid can be scrolled vertically much faster. The performance can be improved using OnDemandCaptionSummary and OnDemandGroupSummary options in the SummaryCalculationMode API.

SfDiagram

Bug Fixes

  • #211111 – Exception will not be thrown when the DataSource is type of List.
  • #211895 – Radial tree layout can be updated in a tab control.
  • #206296 – Radial tree layout will be loaded with empty collection.
  • #209029 – Hierarchical tree layout can be loaded about 1000 nested elements when RefreshFrequency is set as RefreshFrequency.ArrangeParsing.
  • #208446 – Connector’s source and target reference will be serialized properly when they are dropped from the palette.
  • #213693 – Interaction with Node and DiagramThumb will not throw any BindingExpression exception.
  • #205957 – Access violation exception will no more be raised after interacting with diagram.

Features

  • Deletion of a connector when its dependent node is deleted can be decided using the ItemDeletingEvent.
  • #204359 - ArcSegment can be created programmatically.
  • Diagram provides theme support for shapes.
  • #207501 - Equal space distribution support has been provided for connectors in layout when multiple connections to the node.
  • Node and Connector can be brought into viewport or center of viewport using BringIntoViewport and BringIntoCenter methods from its Info property.

Breaking Changes

  • The ThemeStyleId property is added in INode and IConnector.
  • The Theme property is added in IGraph.

SfGantt

Bug Fixes

  • #212079 – Now, the thumbs will be positioned properly when the start and finish dates of a task are changed in the TaskBarResizeCompleted event.

Features

  • #197233 – Support has been provided to highlight critical tasks in the project.
  • #197233 – Support has been provided to auto scroll to a visible task region while vertical scrolling occurs in the Gantt chart.
  • #197233, #211953 – Support has been provided to customize the default view of the tasks in the Gantt chart view.
  • #197233 – Constraints support has been provided in the Gantt control.

SfImageEditor

Bug fixes

  • #214416 - Now, ToggleCropping will work properly after reset the image

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.

  • #209778 - Support has been provided to disable the resizing option for shapes, text, and custom view.

  • #209778 - Support has been provided to reset the zoom.

  • #209778 - Serialization support has been provided to custom view.

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

SfKanban

Bug Fixes

  • #208647 – The kanban control will be refreshed properly when navigating between the pages.

Features

  • #206053 – Virtualization support has been provided to the kanban control.
  • #161241 – The CardDoubleTapped event has been added to recognize the double tap gesture in the kanban card.

SfNavigationDrawer

Bug Fixes

  • #211976: The NavigationDrawer is working properly when clicking the back button without closing the navigation window.

SfNumericUpDown

Bug Fixes

  • #213657: Now, the buttons will properly adapt to themes.

SfPdfViewer

Features

  • #209677 - Provided support to track the printing status when printing the PDF document.
  • #208693 - Provided support to enable and disable pinch zoom in the annotation mode.
  • #208699 - Provided support to use either SfColorPicker or SfColorPalette in SfPdfViewer for changing the annotation color.
  • #207321 - Implemented the behavior to save the content only when the OK button is tapped in the same pop-up annotation.
  • #207767, #165474, #F126233, #170519, #176192, #171123, #196115 - Exposed events to track the changes in the annotation properties in PDF viewer.
  • #208694, #208503 - Provided visual cue support for detecting long press in the annotation.

Bug Fixes

  • #207403 - Application will no longer crash when semantic zoom changes with the PDF document.
  • #207672 - Annotations will be placed in the right position in the PDF document loaded in SfPdfViewer.
  • #210249 - The IsDocumentEdited property issue now set properly when editing the annotation and unloading the PDF document.
  • #208404 - Text markup annotations are now working properly in the PDF document.
  • #204748 - The text search highlight is now cleared when scrolling through the pages of the PDF document.
  • #207672 - Annotations are now in the right position when the attached PDF is loaded.
  • #212180 - Line annotations will now be saved properly for the rotated document.
  • #210250 - NullReference exception will no longer be thrown when access the properties of PdfLoadedDocument in SfPdfViewer.
  • #209237 - Horizontal and vertical scroll values are now set properly.
  • #205656 - PDF pages in SfPdfViewer will fit properly when loading the document in portrait mode.
  • #206604 - ZoomTo method in SfPdfViewer now works as expected.
  • #206604 - Application will no longer crash when navigating from one page into another page in SfPdfViewer.
  • #204748 - NullReferenceException will no longer be thrown when searching text in the newly loaded PDF document.
  • #209577 - Text extraction for the PDF document is now working properly.
  • #212344 - SearchPrevText method is now navigating to the appropriate search instance present in the previous page of PDF document
  • #190186 - PageNumber property is now bindable in SfPdfViewerControl

SfRadialSlider

Bug Fixes

  • #213693 - Binding error will no longer exist on SfRadialSlider even when used inside SfRadialMenu.

SfReportViewer

Features

  • #206928 - Provided ReportServiceRequestBegin event to add custom authentication headers.
  • #194662 - Provided CsvSettings option to specify CSV device information while exporting report.

Bug Fixes

  • #207809 - Integer parameter values with datetime format now returns correct values.
  • #207710 - Now, tablix child report items’ visibility is working properly in RDL processing mode.
  • #206516 - Now, varbinary database images are rendered properly in preview when placed inside tablix.
  • #210753 - Invalid value formatting on concatenating numeric and date time expressions has been resolved.
  • #212588 - Now, multi-value parameter is loaded with values properly in RDL processing mode.
  • #214182, #214365 - Resolved, default value selection problem in boolean parameter when multiple parameter added to report.

SfRichTextBoxAdv

Features

  • #206599 - Added support for page break.
  • Added support for Right-to-left flow direction in control.

Breaking Changes

  • The table cell and image are now refreshed to new size after the resizing operation is finished. To retain the live resizing behavior of previous versions, set the value ResizingMode.Live to EditorSettings.ResizingMode property of SfRichTextBoxAdv class.

Bug Fixes

  • #209136 - The Right to left contents are selected properly using Ctrl + A key.
  • #209136 - New paragraphs are now added properly after the Right to left paragraph.
  • #208668 - The font size is now properly preserved while importing the HTML document.
  • #208668 - The document background and image size are now properly preserved while importing the HTML document.
  • #208668 - The nested tables with center/right alignment are now properly rendered while loading the HTML document.
  • #208578 - Pasted punctuation marks from google translator are now properly rendered with respect to Right to left layout.
  • #208270 - IndexOutOfRangeException will be no longer thrown while adding space before the Arabic text of Right to left paragraph.
  • #208739 - Scrolling to highlighted text position is now working properly.
  • #206562 - Nested tables are now displayed properly within its parent cell bounds.
  • #206475 - The content viewer is now scrolled properly when selecting image.
  • #208266 - Right to left text copied from the google translator are now properly pasted.
  • #202878 - Improved the performance on deleting the selected contents using Backspace/Delete key.
  • #202878 - Improved the cell resizing performance by refreshing the UI to new size after the resizing operation is completed.
  • #210724 - The blinking cursor (caret) is now properly updated based on the selection format.
  • #208578 - Pasted punctuation marks from google translator are now properly rendered with respect to Right to left layout.
  • #211809 - HTML documents with wrong file extension (*.docx, *.doc, *.rtf) are now opened properly.
  • #211307 - The performance of text editing and opening documents are now improved.
  • #211833 - The contents are now properly wrapped in Block layout, while changing the control size.
  • #210501, #211833 - The FontWeight property of the control is now properly applied for the displayed text.
  • #212569, #213966 - System.Exception will be no longer thrown while performing the asynchronous operations like importing the document, invoking printing in multiple view application.

SfSchedule

Bug Fixes

  • #213254 - The NullReferenceException will no longer be thrown when clicking the appointment if the Button is loaded in the appointment template.
  • #214571 - The SelectedAppointment property value will be updated properly when clicking the appointment if the Button is loaded in the appointment template.

SfTabControl

Bug Fixes

  • #213693 - Binding error will no longer exist for HeaderTemplate and ContentTemplate of SfTabItem.

SfTreeGrid

Features

  • #191084 – Added support for async and await to dynamically populate the child nodes.

SfSpreadsheet

Bug Fixes

  • #211805,#211808,#211813 - Exception thrown when loading the Excel file has been fixed.

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

  • 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 document to another document with named range and saving is resolved.
  • #210172 - Conditional format formulas applied to 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.
  • #209863 - Exception is no longer thrown while loading Excel document with EMF images in UWP platform.
  • 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.