Essential Studio for WPF Release Notes

v18.4.0.30
December 17, 2020

Common

Breaking Changes

  • The SkinStorage based themes has been moved from Syncfusion.Shared.WPF and Syncfusion.Tools.WPF to Syncfusion.Shared.WPF.Classic and Syncfusion.Tools.WPF.Classic assemblies respectively. From this release, add Syncfusion.Shared.WPF.Classic and Syncfusion.Tools.WPF.Classic assemblies references to the application references if you are applying themes using SkinStorage. Its recommended to use skin manager based themes.

  • Please find the list of SkinStorage based themes which needs classic assembly reference.
    • Office2007Blue
    • Office2007Black
    • Office2007Silver
    • Office2010Blue
    • Office2010Black
    • Office2010Silver
    • Office2003
    • Office2013
    • Blend
    • Metro
    • VS2010
    • Transparent
    • SyncOrange
    • ShinyRed
    • ShinyBlue.

  • Please find the theme xaml path breaking changes from this reference.

  • Also, below controls which uses SkinStorage based themes for default appearence, You need to add classic assembly references to continue to use this controls.
    • OlapChart
    • OlapClient
    • OlapGrid
    • OlapGauge
    • SfSchedule (classic)
  • The below list of controls has been moved from Syncfusion.Tools.WPF to Syncfusion.Tools.WPF.Classic assembly. Add reference to Syncfusion.Tools.WPF.Classic assembly to the application references to use these controls.
    • NotifyIcon.
    • RangeSliderControl.
  • The below list of classic controls has been moved from Syncfusion.Shared.WPF to Syncfusion.Shared.WPF.Classic assembly. Add reference to Syncfusion.Shared.WPF.Classic assembly to the application references to use these controls.
    • SpellChecker.
    • SkinPicker.
    • VistaWindow.

Features

  • Syncfusion WPF Controls now support .NET 5.0.
  • New Office2019 high contrast white theme has been provided for both frameworks and Syncfusion controls.
  • The SystemTheme has been updated to generate from ThemeStudio for both frameworks and Syncfusion controls.

Bug fixes

  • #295423 - Now, ItemTemplateSelector property is working properly.

ComboBoxAdv

Bug fixes

  • #298908 - Now, bounded images are visible in ComboBoxAdv, when the ToolbarAdv state change to floating state.

DocIO

Features

  • #299656 - Added support to customize track changes revision bars and content colors in Word to PDF conversion.
  • #297755 - Added support to preserve simple markup track changes in Word to PDF conversion.
  • #281634, #268872 – Added support to access metadata properties in DOCX format Word document.
  • #291705, #295027 – Added support to preserve Spanish list numbering in Word to PDF conversion.

Breaking Changes

  • LocaleIDs enumeration is moved from Syncfusion.DocIO to Syncfusion.Office namespace.

Bug Fixes

  • #295922 - Bookmarks are now added properly while converting a Word document to PDF.
  • #295809, #295808 - Pagination issue will no longer occur while converting a Word document to PDF.
  • #297287 - Improved the track changes balloons rendering algorithm in Word to PDF conversion.
  • #297451 - List numbering is now preserved properly while converting a Word document to PDF.
  • #297181 - Hanging will no longer occur while converting a Word document to PDF.
  • #294479 - Paragraph with deletion revision is now preserved properly while converting a Word document to PDF.
  • #294479 - Page border is now preserved properly while converting a Word document to PDF.
  • #295809 - Table is now preserved properly while converting a Word document to PDF.
  • #295917 - Gutter position is now used properly while converting a Word document to PDF.
  • #294479 - Shape is now preserved properly while converting a Word document to PDF.
  • #293792, #293746 - The NullReferenceException will no longer be thrown while converting a Word document to PDF.
  • #294683 - The System.FormatException will no longer be thrown while converting a Word document to PDF.
  • #297287 - The IndexOutOfRangeException will no longer be thrown while converting a Word document to PDF.
  • #293689 - Paragraph alignment is now preserved properly while converting a Word document to PDF.
  • #293366, #297796, #295118, #295806 - Hanging will no longer occur while converting a Word document to PDF.
  • #290028, #292914 - Table row is now preserved properly while converting a Word document to PDF.
  • #292975 - Chart is now preserved properly while converting a Word document to PDF.
  • #294253 - Table is now properly preserved while converting a Word document to PDF.
  • #253061 - Text is now preserved properly while opening an RTF format Word document.
  • #298703,#298816, #298598 - The KeyNotFoundException will no longer be thrown while open and saving a Word document.
  • #298174, #296029 - The ArgumentOutOfRangeException will no longer be thrown while opening a Word document.
  • #294479 - List numbering is now preserved properly while converting a Word document to PDF.
  • #260100 - Field is now unlinked properly while calling Unlink() method.
  • #295763 - The performance issue has been resolved while opening a RTF format document.
  • #293751 - Custom shape is now properly included in the unsupported element’s warning messages while converting a Word document to PDF.
  • #294603 - List numbering is now preserved properly while calling UpdateTableOfContents() method.
  • #295123 - List value is now preserved properly in WordPad while converting HTML to RTF format document.
  • #293261 - The screen tip text is now parsed properly while opening a DOCX format document.
  • Image color is now preserved properly while open and saving a Word document.
  • #294151 - Nested bookmarks contents are now preserved properly while removing a bookmark contents.
  • #293447 - Revision details are now cloned properly while importing a Word document.
  • #293895 - The FormatException will no longer be thrown while opening a Word document.
  • #293580 - Hyperlink display text is now preserved properly while opening a RTF format document.
  • #293578 - Merge field names are now retrieved properly while calling GetMergeFieldNames() method.
  • #293338 - The hanging issue will no long be occur while calling AcceptChanges() method.
  • #293610 - GridBefore value is now calculated properly while opening a RTF format document.
  • #288073 - Field is now preserved properly while resaving Word2003 Open XML format document.
  • #292280 - Table is now preserved properly while converting RTF to DOCX format document.
  • #291705 - List numbering is now preserved properly while converting a Word document to Text file.
  • #290028 - Table border size is now preserved properly while resaving a DOCX format document.
  • #290664 - Paragraph text is now preserved properly while converting DOC format document to PDF.
  • #291306 - Custom document properties are now updated properly while calling UpdateDocumentFields() method.
  • #290352, #297287 - The InvalidOperationException will no longer be thrown while opening a word document.
  • #288916 - Table width is now preserved properly while converting Word document to PDF.
  • #298598 - Table width is now preserved properly while converting a HTML to DOCX format document.
  • #305899 – Picture with delete revision is now preserved properly in balloon while converting a Word document to PDF.
  • #305867 - Paragraph is now aligned properly while converting a Word document to PDF.
  • #305899 - TOC navigation is now working properly while converting a Word document to PDF.
  • #297287 - The IndexOutOfRangeException will no longer be thrown while converting a Word document to PDF.
  • #304601 - Group shape is now preserved properly while converting a Word document to PDF.
  • #301700 - Image is now preserved properly while converting a Word document to PDF.
  • #301409, #300989 - Bullet list is now preserved properly while converting a Word document to PDF.
  • #301645 - Shape is now preserved properly while converting a Word document to PDF.
  • #F159386 - Transparent text color is now preserved properly while converting a Word document to PDF.
  • #F159392 - Image is now preserved properly while converting a Word document to PDF.
  • #292280 - Table is now aligned properly while converting a Word document to PDF.
  • #300367 - Image is now preserved properly while converting a Word document to PDF.
  • #298337 - Textbox is now preserved properly while converting a Word document to PDF.
  • #299037 - Image is now preserved properly while converting a Word document to PDF.
  • #295809 - Text is now preserved properly while converting a Word document to PDF.
  • #298337 - Hanging issue has been resolved while converting a Word document to PDF.
  • #283819, #303971 - Table is now preserved properly while converting a Word document to PDF.
  • #305693 - Symbol is now preserved properly while resaving a DOCX format document.
  • #305525 - Reject changes is now working properly while calling RejectChanges() method.
  • #303649, #304097 - Comments are now preserved properly while resaving a Word document.
  • #304462 – The IndexOutOfRangeException will no longer be thrown while resaving a Word document.
  • #303677 - Shape is now preserved properly when resaving the Word document.
  • #301989 – Textbox is now preserved properly while resaving a Word document.
  • #301989 – Image is now preserved properly while resaving a DOCX format document.
  • #301621 – Text is now preserved properly while converting a DOCX format document to HTML file.
  • #299649 – The ArgumentOutOfRangeException will no longer be thrown while opening the RTF format document.
  • #300525 – The InvalidOperationException will no longer be thrown while opening Word document with comments.
  • #298582 - Alternate chunk content is now preserved properly while converting a Word document to PDF.
  • #295016 - Text is now preserved properly while converting a HTML file to DOCX format document.
  • #298707 - Bullet list is now preserved properly while converting a Word document to PDF.
  • #298409 - Table column is now preserved properly while converting a Word document to PDF.
  • #294151, #300732 - Nested bookmarks are removed properly while calling Remove(Bookmark) method.
  • #291877 - Heading numbering is now preserved properly while converting a Word document to PDF.
  • #283819 - Table is now preserved properly while converting a Word document to PDF.

DockingManager

Features

  • Provided header less AutoHide window support when ‘GetNoHeader’ property is enabled similar to dock windows.

Bug fixes

  • #294927 - DockingManager.ActivateWindow now working properly while splitting the tab using ‘New horizontal tab group’ and ‘New vertical tab group’.
  • #287190 - Now, DockingManager properly loads the saved states.
  • #F157936 - Now, nested window in DockingManager activate when focus is lost and set in the same.
  • #297610 - Now, Tabs aligned properly after removes some tabs in DockingManager.
  • #295316 - WindowsFormsHost used inside DockingManager on any state will loaded properly.
  • #299264 - DockingManager.IsDisableUnloadTabItemContent now works properly.
  • #301632 - Now, the nested DockingManager window properly modified combobox value.
  • #305556,#F159774 - NestedDocking Manager content is shown correctly.
  • #304666 - The InvalidOperationException will no longer be thrown when using multiple threads.
  • The NullReferenceException will no longer be thrown when header value is null.
  • Now, client control displayed when DockingManager.ItemsSource is empty collection.

DocumentContainer

Bug fixes

  • #296079 - Now, DocumentContainer items rendered properly when Material theme is applied.

DoubleTextBox

Bug fixes

  • Now, DoubleTextBox decimal digits are updated properly when binding the Value.
  • #297467 - DoubleTextBox display text is now updated correctly when value is set as Double.Nan.

EditControl

Features

  • #F156673 - Exposed the CaretPositionChanged event to notify the users when caret position is changed.

Bug fixes

  • #299357 - Exception will no longer exist in the Syntax Editor while select decrease/increase indent.
  • #299326, #299912 - Now, Find dialog is working properly while finding the selected text in Edit Control.
  • #299326 - Now, Undo is working properly when DocumentLanguage is HTML.

GroupBar

Bug Fixes

  • #F158207 - Now, the themes have been applied to the GroupBarItem Header properly.
  • #F158650 - Exception will no longer occurs when select the item in stack mode of the GroupBar.

NotifyIcon

Breaking Changes

  • The NotifyIcon control has been moved from Syncfusion.Tools.WPF to Syncfusion.Tools.WPF.Classic respectively. Add reference to Syncfusion.Tools.WPF.Classic assembly in application references to use this control.

OlapClient

Breaking changes

We’ve moved ChromelessWindow control theme files, except for the Metro theme, to the classic theme project. So, add the following libraries to the sample project in order to avoid any exceptions in OlapClient.

  • Syncfusion.Shared.WPF.Classic.dll
  • Syncfusion.Tools.WPF.Classic.dll

PDF

Features

  • #89583, #179673, #254148 ,#F155343 – Added support for adding/modifying the JavaScript action in existing PDF document.
  • #140911, #229773, #277893 – Added support for Ean13 and Ean8 barcode in PDF library.
  • #198566 – Added support to get the page index of bookmark.
  • #292446 – Added support for scaling option in HTML to PDF conversion with Blink rendering engine.
  • #291878 – Added support for BoundsCollection for PdfTextMarkupAnnotation.
  • #295115 – Added support for text direction in PdfFreeTextAnnotation.
  • Added appearance support for PdfPolylineAnnotation.

Bug Fixes

  • #305321 – NullReferenceException will no longer occurs when getting PdfForm from particular PDF document.
  • #304513 – Invalid cross reference table exception will no longer occurs when loading particular PDF document.
  • #304959 – Label from meta data will be preserved properly when adding security to the PDF document.
  • #304340 – Text will be redacted properly in tagged PDF document.
  • #301374, #304610 – PdfDocument will no longer corrupted when flatten the PdfForm.
  • #293563, #304898 – Contents will be preserved properly while converting PPTX to PDF.
  • #300098 – Font will be replaced properly in particular PDF document.
  • #302381 – Exception will no longer occurs while OCR with latest tesseract binaries.
  • #301843 – PdfAnnotation thickness will preserved properly when export and import annotations.
  • #301942 – Exception no longer occurs while importing pages from particular PDF document.
  • #302269 – Signature details will be updated properly in PDF document.
  • #301776 – Signature validation mark will be preserved properly.
  • #301370 – PdfDocument will no longer corrupted when converting PDF to PDF A1B conformance.
  • #295864 – Exception no longer occurs when converting Word document to PDF in multithreading.
  • #300643, #297535 – Contents will be preserved properly when converting EMF to PDF.
  • #296508 – Hyperlinks will be added properly when adding inside the PdfGrid with different page size.
  • #300185 – PdfGridLayout will be return proper bounds when adding PdfGrid to the PdfPage.
  • #291934 – Memory will be disposed properly when adding and removing PdfRubberStampAnnotation.
  • #299509 – File path will be added properly in PdfFileLinkAnnotation.
  • #298059 – Contents will be preserved properly while adding PdfRedactionAnnotation to the PdfPage.
  • #299187 – PDF conformance will be preserved when converting PDF to PDF A3B conformance.
  • #298968 – PdfLayers will be preserved properly when adding layers to PDF document.
  • #298568 – Annotations will be preserved properly when export, import and flattening it.
  • #297943 – ArgumentOutofRangeException will no longer occurs when converting Word to tagged PDF.
  • #262648 – Contents will be preserved properly when creating PDF in multi-threading.
  • #294252 – PdfMetafile will be preserved properly with the specified bounds.
  • #295920 – Page number will be preserved properly when merging PDF documents.
  • #294988 – PdfRubberStampAnnotation appearance will not change when editing with PDF viewer.
  • #292489 – PdfHTMLTextElement will return proper PdfLayoutResult.
  • #294252 – Images will be preserved properly when converting EMF to PDF.
  • #292865 – PDF/UA complaint will be validated properly in PAC3 tool.
  • #293788 – PdfCheckBoxField will be preserved properly when resaving the document.
  • #293316 – DataMatrix barcode will be preserved properly.
  • #293249, #293784 – PdfGridCell text will be preserved properly when exporting DataGrid to PDF.
  • #291767, #292452 – Images will be preserved properly in HTML to PDF conversion.
  • #296815 – PDF document will be OCRed properly for large PDF document.
  • #291177 – Exception no longer occurs when converting PDF to PDF A1B.
  • #294944 – Annotations will be preserved properly when export and import.
  • #293701 – NullReferenceException no longer occurs when getting the text from PdfLoadedTextBoxField.
  • #294353, #291232 – Bookmark text will be preserved properly when saving the PDF document.
  • #296895 – ArgumentNullException no longer occurs when merging PDF document.
  • #294995 – InkAnnotation will be exported properly in German culture.
  • #295703 – NullReferenceException no longer occurs when decrypt the PDF document.
  • #294723 – PdfComboBoxField value will be flatten properly in a PDF document.
  • #295148 – PdfXfaForm will be filled properly with given data.
  • #293908 – NullReferenceException no longer occurs when merging the PDF documents.
  • #293401 – PdfRectangleAnnotation will be preserve properly while flatten the annotations.
  • #291957 – Content will be preserved properly when compressing the PDF documents.
  • #F158748 – ArgumentOutOfRangeException no longer occurs while saving particular PDF document.
  • #F159147 – Signature will be validated properly with particular PDF document.
  • Text size will return properly when getting text size from PdfLoadedFreeTextAnnotation.
  • Exception will no longer occurs when adding custom metadata to PDF document.

PdfViewerControl

Breaking Changes

  • The keyboard shortcut Ctrl + S will perform “Save” instead of “Save as” in the PDF document (if the “Save” option is enabled). You can use the keyboard Shift + Ctrl + S to perform “Save as” in the PDF document.

Features

  • Provided the option in the toolbar to “Save” the PDF document silently without the “Save As” dialog.
  • #I251472, #I277246, #I277022 - Provided the option in the toolbar to add custom stamps.
  • #I292480 – Provided the BeginSave and EndSave events to track the save progress of PDF document.
  • #I292847 – Exposed the DocumentUnloaded event to notify the users when the document is unloaded.

Bug Fixes

  • #I296922 – Form data are now preserved when exporting the PDF pages as images.
  • #I299261 – Memory consumption is now optimized when extracting text from the PDF document.
  • #I298521 – The System.NullReferenceException is no longer thrown when extracting text in a multithreading environment.
  • #I292330 – Thumbnail images are now rendered quickly when scrolling.
  • #I296610 – Text in the PDF document is now displayed properly.
  • #I295029 – The Stamp cursor effect is now preserved properly when the toolbar is hidden.
  • #I296886 – Custom stamps are now added properly when the toolbar is hidden.
  • #I291934 – The System.OutOfMemoryException is no longer thrown when loading the PDF document that contains custom stamps.
  • #I301474 – Memory consumption is now optimized for finding a text from the PDF document using the PdfLoadedDocument.
  • #I301547 – Memory leak is no longer occurs when finding a text from the PDF document using the PdfLoadedDocument.
  • #I302362 – The System.ArgumentException is no longer thrown when extracting images from the PDF document in a multithreading environment.
  • #I301760 – Contents of the PDF document are now rendered properly using the SfPdf rendering engine.
  • #I297378 – Text is now extracted properly from the PDF document.
  • #I304849 – Text bounds are now obtained properly from the PDF document.
  • #I294666 – Images are now exported properly from the PDF document.
  • #I300790 – All the text occurrences are now properly found in the PDF document.
  • #I300309 – The System.NullReferenceException is no longer thrown when exporting the PDF pages as images.
  • #I297417 – The application is no longer crashes when loading the PDF documents continuously.
  • #I237648 – The PDF content overlapping is no longer occur with different zoom values.
  • #I294264 – Text lines are now extracted properly from the PDF file.
  • #I293205 - The images present in the PDF pages are now extracted properly.
  • #I293030 – The scrollbars are now displayed properly in the PdfDocumentView after the ZoomMode is changed.
  • #F157886, #F155706 – The fill color opacity is now applied properly for the annotations.
  • #I294395 – The Marquee zoom cursor mode is now working properly.
  • #I295451 – The text selection is now working properly when the cursor modes are changed.
  • #I290969 – The file size is not increased every time whenever a PDF file is saved even without any modifications.
  • #I294572 - The System.ArgumentNullException is no longer thrown when localizing the control.
  • #I292477 – The IsDocumentEdited property is now updated properly when a popup note is edited.
  • #I292334 – The Delete key operation is now working properly for the popup notes.
  • #I294258 – The System.NullReferenceException is no longer thrown when extracting the text from the PDF pages using the PdfLoadedDocument.
  • #I294666 – Images are now extracted properly from the PDF pages in a multithreading environment.

Presentation

Features

  • #229361, #290868, #293563 - Provided support to preserve a gradient line while converting a PowerPoint presentation to PDF/Image.
  • #290868 - Provided support to preserve a gradient fill with transparency while converting a PowerPoint presentation to PDF.
  • #291946 - Provided support to add and edit a language of PowerPoint TextPart.

Bug Fixes

  • #281066 - Justification is now applied properly while converting a PowerPoint presentation to PDF.
  • #294617 - Placeholder text color is now preserved properly while converting a PowerPoint presentation to Image.
  • #293204 - PowerPoint document is no longer corrupted while removing a master slide.
  • #299090 - The NullReferenceException will no longer be thrown while opening the PowerPoint presentation with vertical curved list SmartArt.
  • #299498 - The ArgumentException will no longer be thrown while opening the PowerPoint presentation in parallel thread.
  • #301380 - Line width is now applied properly while converting a PowerPoint presentation to Image.
  • SlideSizeType property is now working properly, when PowerPoint slide size type is Wide Screen.

PropertyGrid

Features

  • Provided Support to search items in nested properties that are in expanded state.
  • Provided DescriptionTemplate support for PropertyGrid control.

Bug Fixes

  • #295295 - Now, PropertyGrid control load when used inside the user control.
  • #300894 - Detach method of all the CustomEditors are invoked when RefreshPropertyGrid method is called in PropertyGrid.

Ribbon

Features

  • Provided support to open or close the BackStage when the Ribbon control is positioned within normal window or placement target. Also, provided support to open the BackStage under the Ribbon tab or occupy the whole client area of the window or placement target.
  • Provided various types of animation such as fade, scale, and zoom, when opening or closing the BackStage and also provided support for customizing the duration of the animation.
  • Provided the application menu support that contains standard commands based on the Windows Explorer. The menu will open when an user clicks the file or backstage button.
  • Icon template support provided for SimpleMenuButton in which any form of images like path data, font icons, etc. can be added.

Bug Fixes

  • #296036 - Now, the RibbonButton and DropDownButton controls will align properly in Material and Office2019 themes.
  • #292809 - The background of the RibbonWindow title is now properly applied.
  • #294456 - Now, the selected foreground of the checkable RibbonButton will be properly applied in the Material and Office2019 themes.
  • #293915 - In Ribbon, the BackstageButton visibility is now properly updated.
  • #290658 - When users open the More Commands window, an exception will no longer occur.
  • #296968 - For RibbonToggleButton, the SizeMode property now works properly.
  • #296630 - In Ribbon, now the merge and unmerge works correctly.
  • #298624 - The XamlParseException would no longer occur while minimizing the ribbon.
  • #299236 - The QAT items have been properly serialized when changing localization at runtime.
  • #301888 - When setting ResizeMode as the CanMinimize property, the system buttons are properly maintained.
  • #301437 - By using the RibbonCombobox for theme switching, the binding error will no longer occur.
  • #305176 - Binding error will no longer occur in the DropDownButton when used inside the Ribbon.
  • #F159671 - Now, SplitButtons are properly rendered with the latest themes in Ribbon.

SfAccordion

Bug Fixes

  • #298189, 302484 - For all the elements, the width of the Accordion is now set properly.

SfChart

Features

  • The chart control now supports the contrast color for the Adornment label foreground based on the label background.
  • Now, the chart control supports to enable or disable the outlier symbol in BoxAndWhiskerSeries.
  • Exposed CreateSegment method in chart series to customize the series rendering.

Bug fixes

  • #159917 - Now, the axis labels will be updated properly, while using the CategoryAxis as X-axis with DateTimeAxis as primary axis.

Breaking Changes

  • The default appearance of chart elements such as header, axis label, gridline, legend, color model, trackball, annotation, and stripline has been changed for better UI.
  • The default value of UseSeriesPalette and HighlightOnSelection properties has been changed as true.
  • The default value of LegendIcon property has been changed from Rectangle to SeriesType.

SfCircularProgressBar

Features

  • Corner Radius - Support provides the rounded edges at the corner in the circular progress bar.

  • Animation duration - Support allows to customize the duration for completing one animation cycle.

  • Animation Easing - Support allows to customize the easing function to apply for circular progress bar.

SfDataGrid

Features

  • #289451 - Support has been provided to apply filtering and sorting in runtime for ListCollectionView.

Bug Fixes

  • #276296 - Record in the custom sort comparer is proper while adding new records when grouped.
  • #301164 - InvalidOperationException will no longer be thrown while selecting records from two different DataGrid placed within TabControl.
  • #288973 - When using ItemsSourceSelector and the underlying property is an integer, GridComboBoxColumn values are now properly loaded while printing.
  • #267192 - Null reference exception will no longer be thrown in DataGrid when used in windows server.
  • #297242 - Now, cells are selected properly using SelectCells method while the Shift key is pressed.
  • #F156752 - Now, appearance of the print preview window is proper while changing themes at runtime.

SfDiagram

Bug Fixes

  • #296645 - Now, the selection rectangle will no longer be rendered when the RubberBandSelection mode is disabled.
  • #297081 - Now, the InvalidOperationException will no longer be thrown when applying a theme to a class that inherits from the SfDiagram.
  • #303873 - The performance is improved for rendering the groups under the virtualization mode.
  • #F158090 - Now, the ArgumentOutOfRangeException will no longer be thrown when adding the diagram control as a content of the docking manager.
  • #F158090 - Now, the TargetInvocationException will no longer be thrown when binding the SnapSettings to the SfDiagram control.
  • #F158840 - Now, the node will be resized properly for all the available measurement units.

Features

  • Provided the support to add a ready-to-use ribbon control that contains the most common features and settings of the SfDiagram.
  • Provided the command support for canceling the currently performing action such as annotation editing, item selection and keyboard focus.
  • Provided the command support for formatting annotation such as bold the text, italicizing, strikethrough, and underlining it.
  • The command support for applying the specified style for the selected elements has been provided.
  • Provided the command support for enabling the annotation editing for the selected shape.
  • Support to draw the Rectangle, Ellipse and TextNode using the drawing tool has been provided.
  • The command support for selecting a specified diagram tool has been provided.
  • Appearance and fonts of the annotation can be customized using its font formatting properties.
  • Stencil can now be rendered in a compact view using its DisplayMode property.
  • Support to search a shape by its name in the stencil has been provided which can be enabled using its ShowSearchTextBox property.
  • Provided the support to display the Stencil’s symbol filter in the ListView mode.
  • The custom title for the Stencil can now be set using its Title and TitleTemplate property.
  • Support to clear the existing Undo or Redo entries have been provided.

Behavior Changes

  • The default PageWidth and PageHeight of the diagram will now be A4 (1123 * 794 px) size and also the MultiplePage is enabled by default.
  • By default, the TextBox to search a shape and button to toggle between the Expand and Compact modes will now be visible in the Stencil.
  • The default font size of the Symbol groups header is now reduced to 14px.

Breaking Changes

  • Shortcut key for the UnGroup, SendToBack, BringToFront, and FitToPage commands was changed to Ctrl+Shift+U, Ctrl+Shift+B, Ctrl+Shift+F and Ctrl+Shift+W.
  • The Direction property of the IRotate interface was renamed as RotationDirection.
  • The classic version of printing will no longer available for the Net5.0 projects.

SfLinearProgressBar

Features

  • Animation duration - Support allows to customize the duration for completing one animation cycle.

  • Animation Easing - Support allows to customize the easing function to apply for linear progress bar.

SfMultiColumnDropDownControl

Features

  • #300751 - Support has been provided to diacritic sensitive filtering.
  • #F146098 - Support has been provided to notify auto generation of columns with AutoGeneratingColumn event support.

SfNavigationDrawer

Features

  • The DisplayMode support has been implemented and can populate the drawer using Items and ItemsSource collections.

SfRichTextBoxAdv

Features

  • #293261 - Added support to set ScreenTip for hyperlink.
  • #279822 - Implemented automatic suggestion functionality for @mention.

Breaking Changes

  • As a part of .NET 5 upgrade, we have modified the dependent assemblies as mentioned below.
Old dependent assemblies New dependent assemblies
Syncfusion.Compression.Base Syncfusion.Compression.Portable
Syncfusion.DocIO.Base Syncfusion.DocIO.Portable
Syncfusion.OfficeChart.Base Syncfusion.OfficeChart.Portable
  • Please find the modified dependent NuGet packages for .NET 5 framework from below.
Old dependent NuGet packages New dependent NuGet packages
Syncfusion.Compression.Base Syncfusion.Compression.Net.Core
Syncfusion.DocIO.WPF Syncfusion.DocIO.Net.Core
Syncfusion.OfficeChart.Base Syncfusion.OfficeChart.Net.Core

Bug Fixes

  • Style defined in div element is now applied properly while importing HTML.
  • #293488 - Horizontal scrollbar is now properly updated when the document contains different size pages.
  • #293655 - Character format is now applied properly when the selection is empty.
  • #297664 - Calling thread cannot access this object exception will be no longer thrown while opening document using asynchronous open method.
  • #295349 - Last paragraph in the clipboard is now not merged with the destination paragraph while pasting content.
  • #294954 - Merged table cells are now preserved properly while importing word document.
  • #293487 - Auto fit tables are now rendered properly while importing the word document.
  • #282558 - Right to left text, which contains tab is now preserved properly.
  • #297968, #297314 - Skipped writing unused document styles while exporting as HTML.
  • #294125 - Deleting text is now working properly when spell checking enabled.
  • SplitButton in built-in mini toolbar is now preserved properly.

SfSchedule

Breaking Changes

  • Since the SkinStorage (Classic) based themes are moved from Syncfusion.Shared.WPF assembly to Syncfusion.Shared.WPF.Classic, add the Syncfusion.Shared.WPF.Classic assembly reference to sample application to avoid the application crashing issue.

SfScheduler New

Features

  • Appointment reminder – The Scheduler alerts you with reminders at the specified time periods before an appointment’s start time.

  • Load on demand – Load appointments on demand for the visible date range with the loading indicator. Loading appointments on demand improves the loading performance ranging from multiple years.

  • Timeline views – Use the timeline day, timeline week, timeline workweek, and timeline month views without dynamically switching among the day, week, workweek, and month views on the timeline.

  • Recurrence helper methods – Get the appointment occurrence of a specific date from the pattern of appointments and get the pattern of appointments from a specific appointment occurrence.

  • Merge adjacent views of special time regions – Merges the adjacent special time regions and show them as a single region instead of showing them separately for each day in the week and workweek views.

  • Touch support – Performs selection, drag and drop using touch.

  • Theme color support – Appointment’s background, foreground, and dragging time indicator colors can be customized based on the theme.

  • The Id property in the ScheduleAppointment is used to set the ID for a scheduled appointment. The Id has mapping support for custom appointment data binding.

  • Update edited appointment values when the INotifyPropertyChanged and CollectionChanged do not inherit in the custom appointment class.

Breaking Changes

  • The RecurrenceId property in the ScheduleAppointment needed to be set as a pattern appointment object in the previous versions to create the recurrence exception appointment. Now, the RecurrenceId property needs to be set to the Id of the pattern recurrence appointment for the exception appointments only.

  • The ScheduleAppointment is set to the DataContext in the AppointmentTemplate and AppointmentTemplateSelector properties for both ScheduleAppointment and the custom data object in the ItemsSource. The custom data objects can be bound using the Data property in the ScheduleAppointment.

  • The SchedulerResource is set to the DataContext in the ResourceTemplate and ResourceTemplateSelector properties for both SchedulerResource and custom data object in the ResourceCollection. The custom data object can be bound using the data in SchedulerResource.

  • The BlackoutDates property in MonthViewSettings is deprecated. The BlackoutDates property in SfScheduler can be used to disable the interaction for certain dates in month, and timeline month views.

  • The TimeIntervalHeight property is deprecated. The TimeIntervalSize property can be used to customize the height and width of time intervals.

  • The TimeInterval property has been removed from the CellTappedEventArgs for CellTapped. The CellDoubleTapped, CellLongPressed, and TimeInterval class accessibility have changed from the public to internal.

  • The MaximumAllDayAppointmentsCount has been removed from the DaysViewSettings class.

SfSpellChecker

Features

  • Provided support to Enable/Disable SpellChecker and its ContextMenu option using EnableSpellCheck property and EnableContextMenu property.
  • Provided support to configure SpellChecker through xaml.

SfSpreadsheet

Breaking Changes

  • Now, the default UI appearance has been changed. So, set the Office2019White theme using the SkinManager in the sample project to avail the existing appearance.

Bug Fixes

  • #298981 – The data validations feature now working properly for the time values and the data validation dialog window shows proper time values.

SfStepProgressBar

Features

  • Right to Left(RTL) - Right to Left(RTL) support displays the content from right-to-left direction by setting the FlowDirection property to RightToLeft.

  • Secondary content - Support allows to set the secondary content for the step view item by using the secondary content template property.

  • MarkerClicked event - Support allows to get the step view item when the marker of the step view item is clicked.

SfTimePicker

Bug Fixes

  • #F157429 - Textbox in SfTimePicker will now get focus when pressing tab key.

SfTreeView

Bug Fixes

  • #296224 - Items are now displayed properly in TreeView when placed within ScrollViewer with HorizontalScrollBarVisibility.

SkinStorage

Breaking Changes

  • The SkinStorage based themes has been moved from Syncfusion.Shared.WPF and Syncfusion.Tools.WPF to Syncfusion.Shared.WPF.Classic and Syncfusion.Tools.WPF.Classic assemblies respectively. Hence we need to attach Syncfusion.Shared.WPF.Classic and Syncfusion.Tools.WPF.Classic assemblies in application references to apply styles using SkinStorage for controls residing in Syncfusion.Shared.WPF and Syncfusion.Tools.WPF assembly..

TabControlExt

Features

  • #128538 - Selected TabItem will now be updated with a check mark in the context menu of TabControlExt.

Bug fixes

  • #296585 - FontSize will now updated properly for TabItem on TabStripPlacement as left and RotateTextWhenVertical as True.
  • #F158605 - NewButton hover background and NewButtonClick event now work properly.

TabNavigationControl

Bug Fixes

  • #298189 - While using SfAccordion in TabNavigation control, an exception will no longer occur in ExpandableContentControl.

ThemeStudio

Features

  • New Office2019 high contrast white theme has been provided for both frameworks and Syncfusion controls.
  • The SystemTheme has been updated to generate from ThemeStudio for both frameworks and Syncfusion controls.

Bug fixes

  • #299709 - Now, setting custom theme colors on Material theme is applied properly for Ribbon and TabControlExt.

TileView

Bug fixes

  • #292833 - KeyNotFound exception will no longer occur in TileView control while closing the TileViewItem.
  • TileViewItem content is now loaded correctly for the maximized item when material theme is applied for the TileViewControl.
  • #288608 - TileViewItem will now update properly when ‘ItemState’ for any of the TileViewItem is set as maximized.

TreeViewAdv

Bug fixes

  • #303854, #298060 - Now, item is selected properly while clicking the tree node in TreeViewAdv.
  • #298060 - Application crash will no longer occur when clicking on items that are not highlighted.

UpDown

Bug fixes

  • #299492 - Now, Binding to the ‘IsReadOnly’ property is working properly.
  • #291046 - Now, UpDown control FontSize property is working properly for material themes.

XlsIO

Features

  • #299160 - Support has been provided to export data from Excel worksheet to data table with an event.
  • #F158836 - Support has been provided to preserve value types while importing data from a data table to an Excel worksheet.

Breaking Changes

  • #283371 - LongDash, LongDashDot, and LongDashDotDot line patterns are added in the ExcelChartLinePattern enum.
  • #F158836 - The ImportDataColumn() method supports importing DataColumn from DataTable into a worksheet with preserve type option.

Bug Fixes

  • #292282, #F157287 - CopyTo method now copies Excel table styles if copied from second row or more.
  • #292271 - Exception is no longer thrown if all the table rows are deleted.
  • #293903 - Exception is no longer thrown when converting the Excel file to PDF.
  • #295621 - Defined name value with more characters is now working proper without exception.
  • #294651 - Exception is no longer thrown while converting Excel file to PDF with conditional formats.
  • #287586 - Name of a pivot table data field is now correct in Excel to PDF conversion.
  • #293247 - Inserting a new row preserves the number format in the existing table.
  • #292312 - Exception is no longer thrown while inserting rows above sparklines.
  • #296469 - Conditional format is now correct while changing thread culture.
  • #291424 - Column width is now set correctly while updating styles to entire column.
  • #294893 - Exception is no longer thrown while parsing the Excel document with pivot table.
  • #293348 - DateTime format is now proper when accessing Range.DateTime property.
  • #293903 - Exception is no longer thrown when formula contains an unknown name in Excel to PDF conversion.
  • #292625 - Page numbers are now rendered in the correct format when header/footer text contains page number and plus sign.
  • #292241 - Rich-text is now applied to tables during Excel to PDF conversion.
  • #292697 - Exception is no longer thrown while converting Excel chart to image with polynomial trend line series.
  • #294223 - Axis line is now rendered correctly in chart to image conversion.
  • #279738 - Image position is no longer changed while inserting more rows.
  • #295748 - Exception is no longer thrown while resaving the Excel document to HTML.
  • #297992 - Comments are now cleared properly while using clear option.
  • #295301 - Corruption no longer occurs on resaving the Excel file that contains invalid pivot item value.
  • #298342 - Performance on saving a big file with pivot table is now improved.
  • #299505 - Conditional format is now applied properly when using copy style in template marker.
  • #301859 - ApplicationName in Built-in document properties is now parsed and serialized properly.
  • #298772 - Conditional format formula is now correct while saving the Excel document.
  • #292312 - Corruption no longer occurs while opening the file using Excel 2013.
  • #283371 - Provided long dash line types in chart line pattern enum.
  • #292360 - Excel file with incorrect active cell is no longer corrupted on resaving.
  • #304378 - Exception is no longer thrown while converting the Excel file with conditional formats to PDF.
  • #303693 - Vba project’s sheet objects are now cleared properly when removing the worksheets.
  • #301367 - Hyperlink is now correct while changing the system culture in Excel to PDF conversion.
  • #294378 - Cell border under the image is no longer missed in Excel to PDF conversion.
  • #300422 - DataPoint font size and value axis alignment are now proper in chart to image conversion.
  • #F157299 - Mixed data type values are exported with proper format while exporting worksheet to data table.
  • #F157772 - Line series are no longer missed in Excel to PDF conversion.
  • #F157287 - Corruption no longer occurs when copying worksheets from multiple workbooks.
  • #F158875 - Data is now correct while importing nested object collection.
  • Category axis label text is now rendered properly in chart to image conversion.
  • Hyperlinks in shapes are no longer removed while resaving the Excel document.
  • Chart title area rendering is now proper in Excel to PDF conversion.