Essential Studio for Universal Windows Platform Release Notes

v18.1.0.36

March 19, 2020

DocIO

Features

#260100, #F151648 - Provided support to replaces the fields with its most recent result as normal text in the generated Word document.
#F94716, #199229, #201461, #202031, #F137353, #210718, #231958, #234040, #256120, #256942 - Provided support to get the string that represent the appearance of the list value of the paragraph.

Bug Fixes

#249887, #257815 - The extra paragraph is now removed properly when replacing bookmark content by using the ReplaceBookmarkContent() method.
#257956 - The ArgumentOutOfRangeException will no longer be thrown while cloning picture in the Word document.
#257974 - Picture is now preserved properly when open and save the DOCX Word document.
#257472 - IF field is updated properly while calling updateDocumentFields() method.
#256459 - Frame is now preserved properly when open and save the DOCX Word document.
#255071 - Outline level for built-in heading styles are preserved properly while resaving the Word document.
#F142273 - The NullReferenceException will no longer be thrown while deleting bookmark content by using the DeleteBookmarkContent() method.
#255497 - Group shapes will be preserved properly when open and save the DOCX Word document.
#260062 - The NullReferenceException will no longer be thrown while calling the GetText() method.
#258741 - NumPages field is updated properly when using updateDocumentFields in the Word document.
#257671 - Nested group shapes are now preserved properly when open and save the DOCX format Word document.
#257135 - Track changes are now accepted properly while using the AcceptChanges() method.
#255497 - Text spaces are now preserved properly when open and save the DOCX Word document.
#F145154 - Bookmark is now preserved properly while removing table column in the Word document.
#F144828 - The NullReferenceException will no longer be thrown while replacing bookmark content by using the ReplaceBookmarkContent() method.
#264648, #263238 - The NullReferenceException will no longer be thrown while performing mail merge in a Word document.
#264646 - The ObjectReferenceException will no longer be thrown while cloning a Word document.
#264058 - Hanging issue has been resolved while updating document fields.
#263332, #F150503 - Cell width value is now retrieved properly while opening a DOC format document.
#263179 - Font size is now preserved properly while cloning and adding into a destination Word document.
#263210 - The KeyNotFoundException will no longer thrown while opening a Word document.
#262446 - Table Left Indent value is now preserved properly while opening a DOCX format Word document.
#257135, #263808 - Table is now preserved properly while opening a DOCX format Word document.
#F143774 - Empty paragraphs are now preserved properly while performing vertical cell merge by using ApplyVerticalMerge() method.
#F150653 - Number format is now preserved properly while performing Mail merge process.
#260712 - Cell shading color will be preserved properly when converting DOCX to RTF format document.
#260119 - Table is now preserved properly while resaving the Word document.
#127027, #242442 - Paragraph style is now preserved properly while replacing the paragraph text in the Word document.
#258487 - Picture content control is now preserved properly while resaving a DOCX format Word document.

PDF

Features

#255337, #255666 – Added support to substitute font for flattening form fields in an existing PDF document.
#256614 – Added support to set ForeColor in 2D barcodes.
#263279 – Added support to find extended features in an existing PDF document.
Added support for dash and dot line styles for line and line measurement annotations.

Bug Fixes

#266221 – The NullReferenceException no longer occurs while accessing URL form loaded annotation.
#263369 – The NullReferenceException no longer occurs while setting read only to form fields.
#262090 – The NullReferenceException on longer occurs while getting ForeBrush of PdfLoadedTextBoxField.
#263889 – A PDF document is no longer corrupted while adding the PdfHeader and PdfFooter.
#264777 – The NullReferenceException no longer occurs while importing pages from the PdfLoadedDocument.
#263914 – Form fields will be preserved properly while resaving an existing PDF document.
#263649 – Tab “\t” characters will be preserved properly in QRBarcode.
#263741 – Remove attachment will be working properly while saving a document in the same stream.
#263101 – 3D annotation with PRC files will be preserved properly in Bluebeam viewer.
#263304 – The NullReferenceException no longer occurs while saving the PDF document.
#263091 – Transparent color will be preserved properly while drawing an image to PDF document.
#261878 – ZUGFERD conformance will be validated properly while adding external attachments.
#262087 – Exception no longer occurs while validating a PDF document that contains multiple signatures.
#262622 – Exception no longer occurs while loading a particular PDF document.
#262133 – Exception no longer occurs while getting certificate from the store using Serial ID.
#251733 – PdfCodeUPCBarcode will be preserved properly while drawing it to PDF page.
#261206 – PdfGrid will be preserved properly with multiple nested grids.
#260536 – The NullReferenceException no longer occurs while getting author of PdfLoadedAnnotation.
#260893 – XPS to PDF conversion no longer generates PDF document without images from XPS document.
#257531 – Layers will be removed properly for merged PDF documents.
#257531 – The remove layer functionality performance has been optimized.
#260585 – The Invalid XML format exception no longer occurs while exporting annotations.
#256286 – Document no longer corrupted while adding an Image to PDF document.
#261841 – Text will be preserved properly with proper spacing in a PDF document.
#262644 – The NullReferenceException no longer occurs while flattening a PDF document.
#198270 – Text will be preserved properly while converting XPS to PDF.
#257443 – PDF page size will be preserved properly when appending two documents with different page size.
#256504 – Word to PDF conversion will be working properly with particular document.
#257413 – The NullReferenceException no longer occurs while enabling LTV for store certificates.
#257673 – The FileNotFoundException no longer occurs with XmlSerializer on XPS to PDF conversion.
#259787 – PdfAnnotation will be flattened with proper borders.
#259394 – PdfInkAnnotation will be flattened properly.
#256196 – The OutOfMemoryException no longer occurs while saving a large PDF document.
#256196 – Performance of remove layer functionality is optimized now.
#257531 – Layers will be removed properly in PDF documents.
#136014 – Paragraph inside the table cell will be preserved properly in Word to PDF conversion.
#257210, #257811 – Meta file (EMF) will be rendered properly in PdfDocument.
#255677, #257428 – EMF files will be rendered properly in PdfDocument on .NET Core 3.0.
#260424 – The NullReferenceException no longer occurs while saving a PDF document multiple times.
#252711 – Image will be preserved properly while drawing it to PDF document.
#255550 – The EndOfStreamException no longer occurs while drawing image to PDF document.
#260117 – PdfUriAnnotation will be preserved properly with provided string format in PdfGrid.
#251733 – PdfCodeUPCBarcode will be preserved properly with provided dimension.
#258668 – PDF to PDF A1B converted document will be opened properly in PDF readers without any issue.
#257221 – PdfTextBoxField will be preserved properly with AutoFontSize and Multiline options.
#256614 – BackColor will be preserved properly in PDF 2D barcodes.
#255136 – The DateTimeInvalidLocalFormat exception no longer occurs when creating a PDF A document.
#F144285 – PdfSignature appearance will be preserved properly based on the page rotation.
Exception no longer occurs while removing bookmarks from the PDF document.
Import from JSON file will now preserve the values properly.
Exception no longer occurs when saving a document multiple times.
The color properties will be preserved properly in PdfFreeTextAnnotation.

Presentation

Features

#248770, #175287 - Added support for header and footers in PowerPoint slides.
#234509, #249450 - Added a support to preserve the picture in PPTX to image conversion, that is cropped with preset shapes.

Bug Fixes

#257963 - The NullReferenceException will no longer be thrown while cloning a PowerPoint slide with hyperlink.
#264098 - The NullReferenceException will no longer be thrown while opening a PowerPoint document without a chart relation.
#266570 – Table cell margins are now preserved properly while resaving the PowerPoint document.
The ArgumentException will no longer be thrown while setting an invalid link or path as hyperlink.
The TransitionEffect.None will be applied properly for the PowerPoint slide.

SfCalendar

Features

Provided the SelectionRadius support used to customize the circle size of the selected date when the SelectionShape is Circle.

Breaking Changes

Highlighted the start and end date of range/multi range selection for both SelectionShape.
Changed the static view header for the horizontal swiping direction in MonthView.
Padding is added in between the dates selected for the SelectionMode as Multiple in MonthView.
Pointer over appearance for month date cell is changed as border. Previously square type appearance is used.
Disabled the Year and Month view grid lines, it can enabled by using the CellGridOptions.
The following API data type has been changed in SfCalendar. Refer to the following table,

Class name	API name	Existing type	New type
SfCalendar	SelectedDate	object	DateTime?
SfCalendar	DisplayDate	object	DateTime
SfCalendar	VisibleMinDate	object	DateTime
SfCalendar	VisibleMaxDate	object	DateTime

The following API’s default values have been changed, refer to the following table for the updated values,

Class name	API name	Old value	New value
SfCalendar	SelectedDate	Null	DateTime.Now
SfCalendar	CellGridOptions	HorizontalLines	None
SfCalendar	TodayCellBackground	DodgerBlue	White
SfCalendar	TodayCellForeground	White	DodgerBlue
SfCalendar	TodayCellBorderBrush	White	DodgerBlue

SfCircularGauge

Features

#255480 - Provided support to adjust the radius and center of a circular gauge automatically based on the angle value.

SfDiagram

Bug Fixes

#245431 - In SDK version 1903 or higher, the System.IO.IOException will no longer be raised while trying to compile the project.
#262568 - The ItemDoubleTapped event is now triggered properly for DiagramPage.

Features

Provided the support to populate the collection set of symbols into stencil based on symbol’s category.
Provided the support to draw a connection from the Hit Padding region of Ports.
Provided the option to drag the node in single axis either horizontally or vertically.
The DockPort or Annotation’s location and boundaries with respect to the window can now be identified using the BoundingRectangle property of DockPort or AnnotationEditor.
The Custom shape and style can now be applied to group object using its Shape and ShapeStyle Properties.
The Undo/Redo functionality will now work properly for adding or removing Group objects either through a command or a program.

Behavior Changes

All Children of Groups such as nodes, connectors and nested groups that were basically a diagram element, will now be available in respective diagram’s Nodes, Connectors and Groups collection also.

Breaking Changes

The LayoutBase and TreeLayoutBase classes that were under the namespace Syncfusion.UI.Xaml.Diagram.Layout.Base was changed to Syncfusion.UI.Xaml.Diagram.Layout.

SfDockingManager

Bug Fixes

#261318 - When using the ActivateWindow method in nested SfDockingManager, Window is now activated appropriately.
#F149560 - Closed window in float or document mode is now reopen in SfDockingManager.

SfImageEditor

Features

#148752 - Support to specify file name for the saving image.

SfLinearGauge

Features

#254347 - LabelFormat support provided for linear gauge scale.

SfMaps

Features

#235463 - Provided support to reset the old marker view on marker tapped.
#25198 - Support to get maps tile layer bounds.
#256387,#151014 - Support to calculate zoom level based on map Geo-bounds (Northeast, Southwest) or distance (KM/miles) from the Geo-point center value.
#251256 - Horizontal and vertical alignment support provided to custom marker.

SfMaskedEdit

Bug Fixes

#252926- CornerRadius will now be updated properly for SfMaskedEdit

SfPdfViewerControl

Features

#263810 – Provided the support to enable and disable annotation selection.
#261532 – Improved the smoothness of ink annotation strokes.

Bug Fixes

#254829 - Text in the text box can now be copied using keyboard shortcut.
#255606 - Application will no longer crash while performing text search operation.
#250037 - Text markup annotation will now be added to the selected bounds while using touch.
#258354 - Text markup can now be selected when the text markup annotation mode is enabled.
#258375 - Text markup annotation can now be added using stylus.
#254569 - Export and import of ink annotations will now work properly when the ink is added beyond page bounds.
#254569 - The IsDocumentEdited API will now return true when ink annotations are added beyond page bounds.
#258389 - Text markup annotation can now be added properly in the PDF.
#149912 - Print operation will now work when called from the DocumentLoaded event handler.
#258855 - The KeyNotFoundException will no longer occur while loading the PDF.
#149912 - Page number will no longer be visible at the top of the page while printing.
#245868 - Border color of the free text annotation will no longer change when the PDF is saved and reloaded.
#260632 – Text markup annotation can be added properly to the PDF document.
#258389 – Text markup annotations can be added properly after clicking the URLs.
#150421 – Zoom operation now works properly.
#261685 – Text content in the PDF is now rendered properly.
#150422, #263063 – Page number will no longer be displayed over the page when the ShowPageNumber API is set to false.
#263159 – Annotations are now deleted properly after import and export.
#261176 – Annotations are now preserved while exporting the PDF page to image.
#261174 – Position of line annotations will no longer be changed after merging and loading the PDF document.
#264536 – Font files created in the local folder will now be removed.
#151686 - Strokes of ink annotations are now saved properly.

SfRichTextBoxAdv

Features

#263370 - Added IsUndoEnabled property in EditorSettings class to enable or disable the undo support for the RichTextBox control.
#263370 - Added CanUndoStyle property in EditorSettings class to enable or disable the undo support for the style in the RichTextBox control.
#263651 - Added shading support for the text inline elements in the RichTextBox control
#F150539 - Added option to change font families in the RichTextBox control.

Bug Fixes

#260204 - Null reference exception will no longer be thrown while drag and drop the image.
#260419 - Undo operation is now working properly for the formatting changes.
#255613 - All the references of a style in the document are now cleared properly while removing a style.
#262694 - Calling thread cannot access this object exception will be no longer thrown while opening document using asynchronous open method.
#F151513 - Document footer is now visible properly while setting new HeaderFooter instance.
#F151168 - Programmatically created bullet lists are now serialized properly in the exported documents.
#F150998 - The white spaces will be no longer added between two spans while importing HTML.

SfTreeNavigator

Bug Fixes

#261476 - The license errors will no longer occur in the PDF control while adding SfTreeNavigator.

XlsIO

Features

#168970, #223685, #254445, #263325 - The inline formatting in pivot table cell range is now supported.
#168970, #223685, #254445, #263325 - Support has been provide for the tabular layout and outline layout in pivot table.
#263268 - TrimColumnNames option is provided to ignore the leading and trailing spaces with accounting format in export to data table.
Default font size is now set properly in shapes.

Breaking Changes

#168970, #223685, #254445, #263325 - The IPivotCellFormat interface, PivotCellFormat and PivotCellFormatWrapper classes are added to support inline formatting.
#168970, #223685, #254445, #263325 - The GetCellFormat() method in IPivotCellFormat interface gets the pivot cell format for a given range.
#168970, #223685, #254445, #263325 - The BackColor, PatternColor, FontColor, TopBorderColor, BottomBorderColor, RightBorderColor, LeftBorderColor, and DiagonalBorderColor properties in IPivotCellFormat interface gets or sets the background color, pattern background color, font color, top border color, bottom border color, right border color, left border color, and diagonal border color respectively from predefined colors.
#168970, #223685, #254445, #263325 - The BackColorRGB, PatternColorRGB, FontColorRGB, TopBorderColorRGB, BottomBorderColorRGB, RightBorderColorRGB, LeftBorderColorRGB, and DiagonalBorderColorRGB properties in IPivotCellFormat interface gets or sets the background color, pattern background color, font color, top border color, bottom border color, right border color, left border color, and diagonal border color respectively.
#168970, #223685, #254445, #263325 - The TopBorderStyle, BottomBorderStyle, RightBorderStyle, LeftBorderStyle, and DiagonalBorderStyle properties in IPivotCellFormat interface gets or sets the line style of top, bottom, right, left, and diagonal borders respectively.
#168970, #223685, #254445, #263325 - The Bold property in IPivotCellFormat interface specifies whether a bold text is present.
#168970, #223685, #254445, #263325 - The Italic property in IPivotCellFormat interface specifies whether Italic text is present.
#168970, #223685, #254445, #263325 - The IsStrikeThrough property in IPivotCellFormat interface specifies whether strike through is present.
#168970, #223685, #254445, #263325 - The PatternStyle property in IPivotCellFormat interface gets or sets the fill pattern style.
#168970, #223685, #254445, #263325 - The Underline property in IPivotCellFormat interface gets or sets the underline type for the conditional format.
#168970, #223685, #254445, #263325 - The HorizontalAlignment property is added to the IPivotCellFormat interface to represent the horizontal alignment.
#168970, #223685, #254445, #263325 - The VerticalAlignment property is added to the IPivotCellFormat interface to represent the vertical alignment.
#168970, #223685, #254445, #263325 - The IndentLevel property is added to the IPivotCellFormat interface to represent the indent level.
#168970, #223685, #254445, #263325 - The ReadingOrder property is added to the IPivotCellFormat interface to represent the text direction and the reading order for far east versions.
#168970, #223685, #254445, #263325 - The WrapText property in IPivotCellFormat interface indicates whether the text is wrapped at the right border.
#168970, #223685, #254445, #263325 - The ShrinkToFit property IPivotCellFormat interface indicates whether the contents are shrunk to fit into the cell.
#168970, #223685, #254445, #263325 - The Locked property in IPivotCellFormat interface indicates whether a cell with the XF is locked.
#168970, #223685, #254445, #263325 - The FormulaHidden property in IPivotCellFormat interface indicates whether the formula is hidden.
#168970, #223685, #254445, #263325 - The Rotation property is added to the IPivotCellFormat interface to represent the text rotation angle.
#168970, #223685, #254445, #263325 - The NumberFormatIndex property in IPivotCellFormat interface gets or sets the number format index of the conditional format rule.
#168970, #223685, #254445, #263325 - The NumberFormat property in IPivotCellFormat interface gets or sets the number format of the conditional format rule.
#263268 - The TrimColumnNames enum value is added to the ExcelExportDataOptions to ignore the leading and trailing spaces with accounting format in export to data table.

Bug Fixes

#250513, #261295 - Performance of opening the XLS file with comments is improved.
#257403 - Cells in the Excel output are properly formatted when importing plain old CLR object with nullable fields.
#256142 - Shapes are positioned properly after hiding the rows.
#250406 - Exception will no longer be thrown on parsing the named range.
#250406 - Exception will no longer be thrown on parsing the chart series text.
#245527 - Accounting format is now set properly for the cell when number is set to 0.0.
#257296 - Creating a chart with double values in German culture no longer gives corrupted output.
#257771 - Conditional formatting formula is now set properly for XLSX versions.
#257476 - Exception is no longer raised while opening an Excel document with large number of rows and columns.
#257356 - Exception is no longer thrown while copying the worksheet using the AddCopy() method with ParseOnDemand option.
#258536 - Formatting in output file is now proper while copying all the worksheets to another workbook using the AddCopy() method.
#258419 - Page break is now correct when page setup has FitToPage in Excel to PDF conversion.
#255317 - RTF alignment is now proper in text boxes.
#257864 - Chart legend with Arabic text is now rendered properly in Excel to PDF conversion.
#249446 - Page content is no longer cropped while converting an Excel document into PDF with custom scaling.
#259825 - Table style options are now preserved properly while resaving the Excel document.
#258600 – XlsIO generated HTML files are now showing properly in Microsoft Edge browser.
#252205 - Column width is now preserved properly in Excel to PDF conversion.
#258534 – Excel file will no longer hang on parsing the conditional formats.
#258419 - Borders are now preserved properly in Excel to PDF conversion when different line styles are applied in the same cell.
#258722 - The issue with Font size that is getting changed while copying the worksheet is fixed.
#255781 - Excel file is no longer corrupted when resaving the document with extension list.
#257358 - Issue with applying the tabular row layout to pivot fields layout is fixed.
#260561 - Refer to range no longer throws exception after getting the display text.
#256286 - Chart axis line and label are now rendered separately in chart to image conversion.
#258419 - Custom scaling is now proper in Excel to PDF conversion.
#259026 - Excel files containing the pivot table gives proper values in the converted PDF.
#261861 - Login failed exception is no longer thrown on refreshing the list object.
#261344 - German characters in CSV file are now parsed properly.
#263640 - Additional characters are no longer trimmed on setting the cell text with more than 32767 characters.
#263354 - Chart legend entries are no longer aligned to the left of the legend element in chart to image conversion.
#263198 - Italian text in the input pivot table is no longer changed to English during Excel to PDF conversion.
#262501 - Exception is no longer thrown while copying the worksheet using the AddCopy() method.
#261038 - Formats are no longer removed when inserting a row above the formatted cell.
#263254 - Chart series cache will now be serialized only when IsChartCacheEnabled is true.
#263438 - Sheet views are now preserved properly while saving the Excel document.
#264163 - Fonts in comment shape is now preserved properly while copying a range from one worksheet to the other.
#264154 - Name index is now properly referred in array formula while copying the worksheet to another workbook using the AddCopy() method.
#255064 - Performance is improved for refreshing the query table.
#249466 - Page content is no longer cropped on converting the Excel document into PDF with custom scaling.
#F149527 - Conditional format is now preserved properly in the newly added worksheet when saving the workbook twice.
#F149617 - Vertical page break for Arial font is now correct in Excel to PDF conversion.
#F149617 - Chart data label alignment is preserved properly in Excel to PDF conversion.
Issue with incorrect cell value in Excel to PDF conversion is fixed.
Starting page number is now correct in Excel to PDF conversion.
Split text starting position is now correct in Excel to PDF conversion.
AutoShape border is rendered properly in Excel to PDF conversion.
Shape text is now proper in Excel to PDF conversion.
Conditional format icon for discontinuous ranges is now proper in Excel to PDF conversion.
White font color for cells is now applied properly in Excel to PDF conversion.
Text box fill and border colors are now preserved properly while resaving the Excel document.
Range intersection works properly for the entire row and column.
Conditional format icon is now proper for negative cell values in Excel to PDF conversion.
CF number format is properly applied in Excel to PDF conversion.
Strike through is properly applied for header in Excel to PDF conversion.
Excel file having conditional format with negative priority is now properly converted to PDF.
Shrink to fit is now working for numbers in Excel to PDF conversion.
Exception is no longer thrown while accessing a range that contains multiple cell references.
The CopyTo() method is now working properly for the range that contains merged cells.
Resaving the zip no longer throws exception.
The DateTime format is now working fine in Excel to PDF conversion.
Number format is now working fine for Sinhala Unicode.
Arabic Unicode texts are now rendered properly with number formats in Excel to PDF conversion.
Image background color is now rendered properly in Excel to PDF conversion.
Exception will no longer be thrown while refreshing the external connection table.
When the cell contains accounting number format, icon set is no longer overlapped on cell value in Excel to PDF conversion.