Essential Studio for Windows Forms Release Notes (Beta)

v16.4.0.40
December 10, 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
Starting with version 16.4 (2018 Vol 4), Syncfusion has removed .NET Framework 2.0, 3.5 and 4.5.1 assemblies from the Windows Forms install. These assemblies are provided in a separate add-on install. Please refer to this help topic for more information.

Common

Breaking Changes

  • Starting with version 16.4 (2018 Vol 4), Syncfusion has removed the fewer NuGet packages from the Essential Studio. You can find the older NuGet packages and their equivalent new NuGet package details from the KB article.

BulletGraph

Bug fixes

  • # 212322 – The Interval calculation has been modified to position the maximum label at its respective position.

Features

  • # 212384 - Support has been provided to wrap or trim the Caption content to properly align the base of the bullet graph even the caption width changes.

  • # 213257 - Support has been provided to show or hide the bullet graph Labels and Ticks.

Calculate

Features

  • #F139434, #F138869 - Provided support for DATEDIF formula.

Bug Fixes

  • #216638 – While calculating 1/NAN and 1/ ∞ values, returns NAN and 0 respectively when the ExcelLikeComputations property is disabled.
  • #216638 – All formulas will throw exception instead of error message when enabling RethrowLibraryComputationExceptions.
  • #220195 – The IF formula returns the calculated value properly when the AllowShortCircuitIFs property is enabled and arguments are used as numeric values.

Chart

Features

  • #202797 - Support has been added to rotate the chart axis title.
  • #208004 - Support has been added to copy and save the chart without toolbar.
  • #162825, #215915 - Support has been added to disable auto-interval on zooming.
  • #183432, #F136102 - Support has been added to save the chart series as template with data points, without data points, and with series style.
  • The functionalities of user interactive features such as zooming, panning, and crosshair have been improved.

Bug fixes

  • #216850 – Now, the mouse can be moved over an empty series properly when trackball is enabled.
  • #215450 – Now, the axis labels outside the y-axis are not drawn.
  • #220974 - Now, the chart wizard is working properly without crash.
  • #221210 - Now, the tooltip can be set to the toolbar items in designer.

ComboDropDown

Bug Fixes

  • #217525 - Null exception will no longer thrown in ComboBoxDropDown.
  • #218796 - Drop Down Popup is now opening in ComboBoxAdv, when CheckedListBox control is used in Drop Down.

DateTimePickerAdv

Bug Fixes

  • #216133 – Anchoring now works properly for the parent control of DateTimePickerAdv when its style is changed.

Diagram

Features

  • #118940 - Support to define custom MeasurementUnit for diagram control is added.
  • #161571 - Support to find the nearest ConnectionPoint and HitTestPadding support for ConnectionPoint is added.

Bug fixes

  • #216111 - When disposing the diagram control, objects reference no longer persisted in the memory.
  • #213871 - Exception no longer appeared when two control points merged as single point when dragging a node.
  • #214339 - In ConnectorSourceChanging and ConnectorTargetChanging event, Point argument returns incorrect value is fixed now.

DocIO

Features

  • #114697, #132874, #133035, #153479, #167670, #212402 - Added support to show the revision marks in the generated PDF while converting Word documents with tracked changes or revisions.
  • #108879, #162848, #181644, #212631, #217405 - Added support to hyphenate text in a Word document while converting to PDF and Image.
  • #155259, #176052, #211046, #218374 - Added support to update Auto Number field in a Word document.
  • #216440 - Added support to update SET field in a Word document.
  • #211192, #216218 - Added API to access the external Excel file path for a chart in DOCX to DOCX conversion.
  • #214175 - Added API to auto detect the complex scripts in Word to PDF conversion.
  • #213984 - Added support to restart the list number while performing Mail merge.
  • #215528 - Added support to specify Encoding while converting a Word document to HTML.
  • #213040 - Added option to maintain information about imported list styles while importing Word document elements.

Bug Fixes

  • #218957 - The IndexOutOfRangeException will no longer be thrown while updating TOC in RTF format document.
  • #218795 - The XMLException will no longer be thrown while resaving a DOCX format document.
  • #210586 - The NotSupportedException will no longer be thrown while converting a HTML document to Word document.
  • #210586 - Page break preservation issue has been resolved in HTML to Word conversion.
  • #210586 - Text is now aligned properly while converting an HTML document to Word document.
  • #210586 - Tab is now preserved properly while converting a document to HTML.
  • #217440 - Image is now preserved properly while converting a Word document to PDF.
  • #217259 - Nested paragraphs are now preserved properly while opening a Word document.
  • #215506 - RTL text is now preserved properly while converting a Word document to PDF.
  • #213770 - Hanging issue has been resolved while updating a Word document fields.
  • #208452 - Table content is now preserved properly while converting a Word document to PDF.
  • #216566 - The file will no longer be corrupted while adding Chart into a Word document (DOCX).
  • #215421 - Paragraph list is now preserved properly while merging a cloned paragraph with ImportOptions.KeepSourceFormatting.
  • #F139944, #215539 - Custom UI is now preserved properly while opening and saving a Word document (DOCX).
  • #214749 - The FormatException will no longer be thrown while opening a Word document.
  • #214664 - Table cell content is now preserved properly while converting a Word document to PDF.
  • #214435 - Hanging issue has been resolved while converting a Word document to Image.
  • #213886 - List number is now preserved properly while opening and saving a Word document (DOCX).
  • #F139508 - Page border position is now preserved properly while converting a Word document to PDF.
  • #213327 - Shape is now preserved properly while converting a Word document to PDF.
  • #213151 - Bullets are now preserved properly while merging the Word documents.
  • #213042 - Unexpected frame preservation issue has been resolved while calling the WordDocument.Replace API for Word document.
  • #212593 - Text wrapping issue has been resolved while converting a Word document to PDF.
  • #212502 - Textbox is now preserved properly while converting a Word document to PDF.
  • #182512 - The OutOfMemoryException will no longer be thrown while opening a Word document.

DockingManager

Bug fixes

  • #220479 – The null reference exception will no longer be thrown when restoring the closed auto hide window in Docking Manager.

Features

  • #195590, #217957, #220751 – Visual studio-like document tab interface has been provided in Docking Manager. Document windows can be added in Docking Manager using the EnableDocumentMode and invoking the DockAsDocument method for corresponding child view in the NewDockStateEndLoad event.

GridControl

Bug fixes

  • #220136 – The FillSplitterPane property is not generated in designer when it has default value.

GridGroupingControl

Bug fixes

  • #F140810 – The ExcelLikeFilter popup will not be closed by pressing Alt key, if the search box is in edit mode.
  • #218817 – The ConditionalFormatting is working properly while programmatically adding conditional formats for invalid column or a column which is not bind to grid.
  • #218566 – The grid is exported to PDF document properly when disabling the ShowCaption property.

ImageStreamer

Bug fixes

  • #220249 – Rendering problem will no longer occur when setting BackgroundImageLayout to stretch in ImageStreamer.

MultiSelectionComboBox

Bug Fixes

  • #217150– Autocomplete filtering items will now update correctly.

PDF

Features

  • #130495, #131138, #136165, #136511, #99972, #174605, #175254, #196824, #205109, #209482, #218456, #217889 - Added support for OpenType font (OTF).
  • #140012, #216188 - Added support for retrieving certificate details from an existing PDF document.
  • #216464 - Added support to parse ForeColor and BackColor from PdfLoadedFormFields.
    Added support to identify the secured document signed by user or owner password.

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.
  • #213436 - The ArgumentException will no longer occur while loading a PDF document with Spanish culture settings.
  • #217131 - File size has been decreased while redacting a PDF document.
  • #215998 - Performance has been improved when converting XPS to PDF document.
  • #215977 - Text is now redacting properly when redact with annotation.
  • #215817 - “A Graphics object cannot be created from an image that has an indexed pixel format.” exception will no longer occur when redacting a PDF document.
  • #213910 - Text is now preserving properly when converting a PDF document to PDF/A-1b document.
  • #214354 - The Hebrew text is now preserving properly in EMF to PDF conversion.
  • #213566, #213951 - Text is now preserving properly when converting word document to PDF in azure function app.
  • #212556 - The OutOfMemory exception will no longer occur when converting PDF to PDF/A-1B.
  • #217007 - The Null-reference exception will no longer occur when importing pages from the 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.
  • #219468 - RTL texts are now preserving properly in Word when converting to PDF.
  • #220618 - “Object reference not set to an instance of an object exception will no longer occur when creating PDF signature.
  • #220403 - PDF page contents are now preserving properly when redacting the PDF document twice.
  • #219421 - EMF images are now preserving properly when converting Excel to PDF document.
  • #219990 - Text mark annotation is now preserving properly when flatten the PDF document.
  • #219079 - “Couldn’t find information about the character exception will no longer occur when flattening the XFA document.
  • #217865 - NullReferenceException will no longer occur while removing custom metadata entries.
  • #218695 - Bookmark destination is now preserving properly after reading the bookmark.
  • #218417 - Text is now preserving properly when converting EMF to PDF.
  • #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.
  • #218036 - Digital signatures are now preserving properly when appending the PDF document.
  • #218192, #218299 - NullReferenceException will no longer occur when saving the document with EnableValidationAppearance.

PdfViewerControl

Features

  • #216460 - Exposed events to track the document printing process.
  • #220032 - Exposed events to track the document saving process.
  • #140413 - Exposed events to track the text search process.
  • #140413, #220032 - Exposed HorizontalScrollOffset and VerticalScrollOffset APIs to get and set horizontal and vertical scroll offset respectively.

Bug Fixes

  • #215454 - The FindText method is now working properly for non-breaking space characters.
  • #203168 - The searched text is now highlighted properly after the page content is displayed.
  • #216845, #217721 - The System.IO.IOException will no longer be thrown while saving PDF documents.
  • #212974, #213119 - The FindText method is now working properly for vertical text.
  • #140413 - The GoToPageAtIndex method is now working properly after performing text search.
  • #217301 - The date format is now preserved when printing the document using Pdfium.

PivotGrid

Bug fixes

  • #217106 - Pivot schema designer gets refreshed while changing the data source at runtime.
  • #217249 - Control renders properly while dragging and dropping pivot fields to filter axis in group bar.
  • #218272 – The underlying raw items besides each value gets displayed correctly for all scenarios.
  • #218893 - Items in filter header are exported properly in PivotTable mode.
  • #F140318 - Control renders properly when we drag and drop fields from pivot table field list into the values section.
  • #219941 – Pivot table field list header values are localized properly.
  • #218749 - Cells are merged correctly while exporting the control to an Excel document in cell mode.

Presentation

Features

#213426 - Added support to create, edit, and remove connectors in PowerPoint files.
#208190, #173950, #213995 - Added support for ShrinkTextOnOverflow property while creating and editing the text in a PowerPoint file.
#214420 - Added support to clone and insert paragraphs.

Breaking Changes

The FitTextOption property has been added to ITextBody interface.
The Insert(int, IParagraph) method has been added to IParagraphs interface.
The Clone() method has been added to IParagraph interface.
The AddConnector(ConnectorType, IShape, int, IShape, int) method has been added to IShapes interface.
The AddConnector(ConnectorType, double, double , double , double) method has been added to IShapes interface.
The ConnectionSiteCount property has been added to IShape interface.

Bug Fixes

#205041 - PowerPoint files will no longer be corrupted while inserting a cloned picture.
#214098 - Chart axis labels are now preserved properly with default label bounds while converting a PowerPoint slide to image.
#213387 - Slide background is now preserved properly while converting a PowerPoint slide to image.
#213409 - Picture fill is now preserved properly in portable PDF conversion.
#207078 - The FormatException will no longer be thrown while resaving a PowerPoint document with formulated path points.

RibbonControlAdv

Features

  • Standard layout support has been provided for Ribbon. Controls in Ribbon can be arranged without additional settings like margin, padding, or any customization, similar to Office UI. This layout arrangement can be enabled using the boolean property AutoLayoutToolStrip.
  • Accessibility support has been provided for ribbon items.
  • Support has been provided to manage QAT based on selected form in menu merging.
  • Serialization support has been provided for the newly added ribbon tabs and ToolstripEx using Customize Ribbon dialog.

Bug Fixes

  • #209207 - Scaling issue related with size and space will no longer occur.
  • #214236 – The InvalidCastException will no longer be thrown when OfficeSplitButton is added as RibbonTabItem.

Breaking Changes

In DropDown button, arrow position has been changed as like below

  • When multiline text has been used, arrow is placed to right of the text as like in Microsoft Office.
  • When single line of text is given, arrow is placed below the text as like in Microsoft Office.

SfComboBox

Features

  • Provided support to display the custom suggestion list in drop-down, on typing the text in editor portion.

Bug fixes

  • #217784 – Performance is improved when changing the data source with more number of records at runtime.

SfDataGrid

Features

  • #206047, #216189 - Provided support for paging with SfDataPager. Allows you to manipulate data using the SfDataPager control to view records in multiple pages. Supports on-demand data loading.
  • #217642 - Provided support for data binding with BindingSource when multiple DataTable are in DataSet.
  • #214394 - Provided support to enable or disable Tab key navigation.
  • #214005 - Provided support to navigate the focus to the next control by pressing TAB key when the current cell is placed in the last cell of DataGrid.
  • #213824 – Provided support to customize the selected row marker in the RowHeader.
  • #213279 – Provided support to change the outer border color.
  • #F139190 - Provided support to autofit content for the grouped item in GroupDropArea.
  • Provided support to improve the performance of summary calculation of GroupSummary and CaptionSummary with SummaryCalculationMode.
  • Provided support for Does Not Contain option in UI filtering.

Bug Fixes

  • #221302 – Check box items in the filter drop-down will not be duplicated after filtering using DataTable.
  • #220564 – Filter drop-down will not be closed by pressing Alt key when editing in Search textbox.
  • #219272 – Performance of opening filter drop-down with large number of records is improved.
  • #219915 – Text in the combobox will not be selected automatically when begin editing.
  • #219511 – Flickering of edit element in edit mode will not occur when adding WS_EX_COMPOSITED to the CreateParams.
  • #219552 – The NullReference exception will no longer be thrown when clicking check box in AddNewRow before it is initiated.
  • #218996 – Columns can be hidden when initializing column width as zero.
  • #218703 – The NullReference exception will no longer be thrown when binding a list of string to GridComboBoxColumn.
  • #217784 – Performance of loading the edit element in GridComboBoxColumn when bound with large number of records is improved.
  • #218255 – Filter drop-down will be opened properly on clicking the filter icon of spanned header cell.
  • #216274 – DataGrid will be deserialized properly when busy indicator is enabled.
  • #220771 – The NullReference exception will no longer be thrown when SelectedIndex is initialized and begin editing the same row.

SfForm

Features

  • Provided support to set padding for TitleBarTextControl in the title bar.
  • Support has been provided to add image in title bar and customize the back color of form icon.

Bug fixes

  • #216424 – The ActiveBorderColor is displayed properly when form gets activated again.
  • #216519 – The dragging and resizing of form are worked properly when resizing the form to minimum size (only title bar is in view).

SfListView

Features

  • Provided support to customize the outermost border.

Bug fixes

  • #217211 – The scrollbar styles are applied properly when programmatically setting the custom scrollbar style to default scrollbar.

Spreadsheet

Bug Fixes

  • #218716 - The caret position of text is updated properly when double clicking that cell. The HorizontalAlignment is working properly in the RichTextBox cell.

SuperToolTip

Bug Fixes

  • #222199 – SuperToolTip will work properly when mouse over on the NumericUpDownExt

SyntaxEditor

Features

  • Zoom capability has been added through mouse wheel and touch gestures in syntax editor. It also supports to change the zoom factor in a programmatic way.

TabbedMDIManager

Bug fixes

  • #219153 – The close button was displayed for every tab even when enabling ShowCloseButtonForActiveTabOnly in TabbedMDIManager has been fixed.

TextBoxExt

Bug Fixes

  • #217172, #219233 – The performance issue has been fixed while disposing.
  • #217524 – The null reference exception will no longer be thrown in NCPaint.

TreeNavigator

Bug Fixes

  • #209207 – Header height is now serialized when scaling is changed.
  • #209207 – Scaling issue related with size and space will no longer occur.

TreeViewAdv

Feature

  • #215412 - Support has been provided to detect how node editing has been entered either through mouse, touch, keyboard or programmatic.

Bug Fixes

  • #209207 –The node image will no longer overlap with another node.

XlsIO

Breaking Changes

  • #217605 - UseStringDelimiter has been added in IApplication interface to support string delimiter in CSV document.
  • #218001 - SkipAutoFitRow has been added in IApplication interface to skip autofit for rows.
  • CustomPaperSize has been added in ExcelToPdfConverterSettings class to support setting custom paper size while converting Excel document to PDF.

Bug Fixes

  • #139653 - Issue with VLOOKUP formula while setting custom separators in German culture is fixed.
  • #204947 - Exception thrown while opening Excel document with duplicate attributes is resolved.
  • #212300 - Null reference exception is no longer thrown while add copying the workbook with invalid sheet references.
  • #212300 - File corruption issue while copying a range having named range formula referring to External workbook is resolved.
  • #213242 - Chart default axis title area text settings and text box properties are now cloned properly in XlsIO.
  • #213274 - StandardHeight is now properly set for XlsIO generated Excel documents.
  • #213608 - Incorrect Rich-Text format while saving the Excel document is fixed.
  • #213658 - Null reference exception thrown while getting ListOfValues property of Data Validation is fixed
  • #213658 - NumberFormatSettings returning null value while accessing particular range is fixed.
  • #213658 - Issue with FirstFormula property of Data Validation in binary Excel files is fixed.
  • #213819 - DeleteColumn method works properly for CSV file.
  • #214495 - Issue with slicer getting removed on saving the file in Excel 2007 version is fixed.
  • #214638 - Excel file with incorrect anchor type for shapes is resaved properly without any corruption.
  • #214638 - Excel file with text box is resaved properly in Excel 2007 version without any corruption.
  • #214879 - Exception thrown while parsing the named range formula without worksheet reference is resolved.
  • #214915 - Enabling WrapText property will no longer throw exception during BeginUpdate().
  • #214924 - Excel file with conditional formats is resaved properly without any corruption.
  • #215001 - Issue with horizontal alignment for textbox is resolved.
  • #215030 - Null reference exception thrown on casting chart data label as text area on parsing Excel file is fixed.
  • #215185 - Text box color and macro link are properly resaved in the Excel document.
  • #215197 - Issue with changing legend position from manual layout is fixed.
  • #215350 - Special characters (Ampersand and less-than symbols) can be used in HTMLString property without any exception.
  • #215591 - Issue with copying borders in merged cells is fixed.
  • #215649 - Date format is now preserved properly when creating Excel from data table.
  • #216094 - ArgumentException thrown while assigning “/” as cell value is fixed.
  • #216187, #214895 - Performance issue while inserting rows is resolved.
  • #216305 - AutoFitColumn now works properly for currency values.
  • #217511 - Object reference exception thrown while converting Excel file with icon set in conditional formats to PDF is fixed.
  • #214098 - Issue in setting maximum labels count for chart numeric axis in chart to image conversion is fixed.
  • #214895 - Alignment issue in Excel to PDF conversion for cells with conditional formats applied is fixed.
  • #211036 - Performance issue while converting chart with formulas to PDF is resolved.
  • #215896 - ArgumentException thrown while converting Excel file having background color set for text box to PDF is fixed.
  • ArgumentException thrown while accessing used range having styles alone is fixed.
  • Border set to a cell through BordersAround method is now applied properly.
  • Unhandled exception thrown while opening an Excel file with duplicate shape attribute is fixed.
  • #210172, #218493 – Protected document with objects is resaved properly without unlocking the objects.
  • #214445 - Exception thrown in Table.Refresh() with ODBC connection using XlsIO is fixed.
  • #216939 - ArgumentOutOfRangeException is no longer thrown while saving the workbook with shapes, after deleting rows.
  • #217119 - Performance delay while applying multilevel subtotal is fixed.
  • #217178 - XML exception thrown while opening XML document with invalid attribute value is fixed.
  • #217348 - Exception thrown while setting font for empty text has been resolved.
  • #217365 - Issues with inserting new rows in table and add copying the worksheets with table formulas is fixed.
  • #217695 - Exception will no longer be thrown while opening Excel file with duplicate custom XML relations.
  • #218001 - Autofit row enhancement is implemented for Calibri and Tahoma fonts.
  • #218655, #218656, #220908 - Line breaks are now properly retrieved for cells with Rich-Text.
  • #218676 - Chart legend border value is properly retrieved while resaving the Excel file.
  • #218730 - Manual layout is preserved properly while resaving the Excel document.
  • #218730 - XML error thrown while parsing Excel document with charts is fixed.
  • #218869 - Color formatting issue due to comma cell style is fixed.
  • #218983 - Null reference exception thrown while opening the Excel document without theme.xml file is resolved.
  • #219575 - Conditional formats are now properly serialized for an empty document.
  • #219606 - Format exception is no longer raised while opening the Excel file in German culture.
  • #220197 - Excel file is properly converted to PDF without any blank page.
  • #217780 - Conditional formats are now preserved properly in Excel to PDF conversion.
  • #217800, #140395 – Issue with bubble chart sizing in Chart to Image conversion is fixed.
  • #218016 - Text cropping issue in Excel to PDF conversion when text length exceeds the cell width is fixed.
  • #218648 - Issue with Time being incorrectly preserved while converting Date1904 enabled workbook to PDF is fixed.
  • #217198 - Issue with image being cropped while converting Excel to PDF has been resolved.
  • Exception thrown while accessing UsedRange of worksheet in an Excel workbook opened with ExcelParseOptions.ParseWorksheetsOnDemand is resolved.
  • DisplayText is retrieved properly after getting CalculatedValue.
  • Issue with secondary value axis for different chart types is fixed.
  • Next available column ID is properly updated while refreshing the query table in existing workbook.