Essential Studio for WinUI Release Notes

v19.2.0.44
June 30, 2021

Common

Features

The following controls are production ready for the desktop applications.

  • Linear Gauge
  • Circular Gauge
  • Badge
  • Calendar Date Picker
  • Calendar DateRange Picker
  • Barcode
  • Color Picker
  • DropDown Color Picker
  • Color Palette
  • DropDown Color Palette
  • TreeView

SfCalendar Preview

Features

  • High contrast theme appearance is improved.
  • Provided support to the show week numbers.
  • Provided support to customize the format of the week number.
  • Provided support to customize the format of the weekday names.

Breaking Changes

  • DateFormat property is renamed as DayFormat.

SfCalendarDatePicker Preview

Features

  • Provided support to show the week numbers in dropdown calendar.
  • Provided support to customize the format of the week number in dropdown calendar.
  • Provided support to customize the format of the weekday names in dropdown calendar.
  • Provided support to show or hide the clear button in the editor.

Breaking Changes

  • FormatString property is renamed as DisplayDateFormat.
  • DateFormat property is renamed as DayFormat.
  • PlaceHolderText property is renamed as PlaceholderText.
  • AllowNullValue property is renamed as AllowNull.
  • DateChanging event is renamed as SelectedDateChanging.
  • DateChanged event is renamed as SelectedDateChanged.

SfCalendarDateRangePicker Preview

Features

  • Provided support to show the week numbers in dropdown calendar.
  • Provided support to customize the format of the week number in dropdown calendar.
  • Provided support to customize the format of the weekday names in dropdown calendar.

Breaking Changes

  • DateFormat property is renamed as DayFormat.
  • FormatString property is renamed as DisplayDateFormat.
  • PlaceHolderText property is renamed as PlaceholderText.

SfChart Preview

Breaking changes

  • The SfChart control has been deprecated. Instead of that, SfCartesianChart, SfCircularChart, SfPolarChart, SfFunnelChart, and SfPyramidChart controls have been exposed.
  • The ChartDataMarker class name has been changed as ChartDataLabelSettings.
  • The ChartDataMarkerLabel class name has been changed as ChartDataLabel.
  • The SfChart properties AreaBackground, AreaBorderThickness, and AreaBorderBrush names have been changed as PlotAreaBackground, PlotAreaBorderThickness, and PlotAreaBorderBrush respectively.
  • The ChartSelectionBehavior properties SelectionCursor and SelectionType names have been changed as Cursor and Type respectively.
  • The ChartSelectionBehavior properties EnableSegmentSelection, EnableSeriesSelection and SelectionMode have been removed.
  • New enum values Point, Series, MultiPoint, and MultiSeries have been added in the enum SelectionType and also old enum values Multiple and Single are removed.
  • The SeriesSelectionBrush property has been moved from ChartSeriesBase to ChartSelectionBehavior.
  • The SeriesSelectedIndex property name has been changed as SelectedSeriesIndex.
  • The SegmentSelectionBrush property name has been changed as SelectionBrush.
  • The IconTemplate property name has been changed as LegendIconTemplate.
  • The SideBySideSeriesPlacement property name has been changed as EnableSideBySideSeriesPlacement.
  • The SegmentSelectedIndex property name has been changed as SelectedIndex.
  • The ExplodeOnMouseClick property name has been changed as ExplodeOnTap.
  • The ShowLabel property name has been changed as ShowDataLabels and moved from ChartDataMarker to ChartSeriesBase.
  • The ConnectorLinePosition property has been removed from the CircularSeriesBase.
  • The DataMarkerLabelPosition enum name has been changed as DataLabelPosition.
  • The DataMarkerPosition enum name has been changed as BarLabelAlignment.
  • The LabelContent enum name has been changed as LabelContext.

SfDataGrid Preview

Features

  • Provided the support to new data column that displays the DateTimeOffset type data and hosts the SfCalendarDatePicker for editor to edit and select date.

SfDatePicker Preview

Features

  • Provided support to show or hide the clear button in the editor.

Breaking Changes

  • DropDownFormatString property is replaced by DayFormat, MonthFormat, YearFormat properties to customize the format of day, month and year column respectively.
  • FormatString property is renamed as DisplayDateFormat.
  • PlaceHolderText property is renamed as PlaceholderText.
  • AllowNullValue property is renamed as AllowNull.
  • DateChanging event is renamed as SelectedDateChanging.
  • DateChanged event is renamed as SelectedDateChanged.

SfNumberBox Preview

The Syncfusion WinUI NumberBox control is a editor control that allows user to enter numerical input with any number of decimal digits. It also supports features such as data binding, showing watermark text and formatting etc..

Key Features

  • Input restriction - Provided support to restrict the input value within minimum and maximum range.
  • Formatting - Provided support to apply different custom formats.
  • UpDown button - Provided support to change the value using the UpDown button.
  • Watermark - Provided support to show watermark text when null value is set.
  • Disable value editing - Provided support to disable the value editing in editor.

SfRangeSlider Preview

Features

  • Provided the vertical orientation support for the range slider.

Breaking Changes

  • Divisors related API names such as ShowDivisors, DivisorHeight, DivisorWidth, DivisorStrokeThickness, DivisorStroke, DivisorFill, DivisorTemplate are changed to ShowDividers, DividerHeight, DividerWidth, DividerStrokeThickness, DividerStroke, DividerFill, DividerTemplate.

SfScheduler Preview

Features

  • #F149216 - The scheduler supports customizing the appointment display count control DataTemplate by using the MoreAppointmentsIndicatorTemplate property of the MonthViewSettings in the month view and the AllDayMoreAppointmentsIndicatorTemplate of the DayViewSettings in the all day panel of day, week and work week views.

  • #I308965 – The scheduler provides support to set an appointment background and foreground colors using the color editors in the built-in scheduler appointment editor control.

  • #I312366, #I315666, #I325514 - Provided the ISO Standard support for week number in the scheduler.

  • The scheduler provides view navigation support by using the AllowViewNavigation property. The current view of the scheduler should navigate to the respective day or timeline day view on clicking a month cell or a date in the view header.

  • The span recurrence appointment support has been provided for a duration less than 24 hours for different days.

  • Improved the keyboard interaction on scheduler for appointments and view type changes.

Breaking Changes

  • In the previous, if the monthly recurrence rule is added for the 31st day, an appointment is added on the last day of the month if the 31st date is not availed (Feb, Apr, Jun, Sep, Nov). But, now the occurrence is only added for the months that have the 31st date.

  • The ByDay support is removed from the daily recurrence type, but the same support is applicable in the weekly recurrence rule type.

SfSlider Preview

Features

  • Provided the vertical orientation support for the slider.

Breaking Changes

  • Divisors related API names such as ShowDivisors, DivisorHeight, DivisorWidth, DivisorStrokeThickness, DivisorStroke, DivisorFill, DivisorTemplate are changed to ShowDividers, DividerHeight, DividerWidth, DividerStrokeThickness, DividerStroke, DividerFill, DividerTemplate.

SfTimePicker Preview

Features

  • Provided support to show or hide the clear button in the editor.

Breaking Changes

  • FormatString property is renamed as DisplayTimeFormat.
  • PlaceHolderText property is renamed as PlaceholderText.
  • AllowNullValue property is renamed as AllowNull.
  • TimeChanging event is renamed as SelectedTimeChanging.
  • TimeChanged event is renamed as SelectedTimeChanged.

SfTreeView

Features

  • #I312165 - Provided the support to select the nodes on loading or at run time by binding the HierarchyPropertyDescriptor.IsSelectedPropertyName property to ViewModel.
  • Provided the support to get the TreeViewNode at the specified point using TreeView.GetNodeAt method.