[Expand]General Information
[Collapse]WinForms Controls
  .NET Core Support
  Prerequisites
 [Expand]What's Installed
 [Expand]Build an Application
 [Expand]Controls and Libraries
 [Collapse]Common Features
  [Expand]Data Binding Common Concepts
  [Expand]Data Source Wizard
  [Expand]Expressions
  [Expand]Behaviors
  [Expand]Application Appearance and Skin Colors
  [Expand]Filtering UI Context
   Find Panel Syntax
  [Expand]Graphics Performance and High DPI
  [Expand]Scaffolding Wizard
  [Expand]Formatting Values
   HTML-inspired Text Formatting
  [Expand]Menus
  [Expand]Tooltips
  [Expand]Save and Restore Layouts
   Clipboard - Copy and Paste Operations. Data Formatting
   Version Compatibility: Default Property Values
  Get More Help
 [Expand]API Reference
[Expand]ASP.NET Controls and MVC Extensions
[Expand]ASP.NET Bootstrap Controls
[Expand]ASP.NET Core Bootstrap Controls
[Expand]WPF Controls
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Office File API
[Expand]Reporting
[Expand]Report and Dashboard Server
[Expand]Dashboard
[Expand]eXpressApp Framework
[Expand]eXpress Persistent Objects
[Expand]CodeRush
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation
View this topic on docs.devexpress.com (Learn more)

Version Compatibility: Default Property Values

DevExpress version updates introduce new features that may change control default behavior. When you migrate to a new version, you can revert these changes to the previous version using the static WindowsFormsSettings.DefaultSettingsCompatibilityMode property. This option should be set at application startup.

All recent changes are in effect if the WindowsFormsSettings.DefaultSettingsCompatibilityMode property is set to Latest.

Expanded Version 19.1

The table below illustrates the properties and behaviors that change if you set the WindowsFormsSettings.DefaultSettingsCompatibilityMode property to v19_1 (in comparison to the Latest mode).

ImageUri icon type

  • Affected controls: all controls that support context-dependent images.
  • Related properties ImageOptions.ImageUri properties.
  • "v19_1" Behavior: when you specify the ImageUri property, the control receives a raster icon.
  • "Latest" Behavior: when you specify the ImageUri property, the control receives a vector icon.

Data Grid FindPanel location

Set the GridViewOptionsFind.FindPanelLocation property to Panel to revert to two separate elements.

ProgressBarControl - Custom Display Text

Text Editors - Display of Null Value Prompt

Tree List Node Menu

  • Affected control: TreeList
  • Related property: TreeListOptionsMenu.ShowExpandCollapseItems
  • "v19_1" Behavior: When a user right-clicks a node in v19.1 and prior versions, the node menu is created without commands. Since the TreeList control does not display empty menus, the node menu is hidden by default.
  • "Latest" Behavior: The node menu now contains commands that expand/collapse nodes.

You can hide these commands for individual Tree List controls via the TreeListOptionsMenu.ShowExpandCollapseItems property.

Report and Dashboard Designers

Expanded Version 18.2

The table below illustrates the properties and behaviors that change if you set the WindowsFormsSettings.DefaultSettingsCompatibilityMode property to v18_2 (in comparison to the Latest mode).

Custom Functions in Filters

  • Affected controls: FilterControl (see FilterControl), FilterEditorControl (see FilterEditorControl)

  • Related properties and features: display custom functions (registered with the CriteriaOperator.RegisterCustomFunction or CriteriaOperator.RegisterCustomFunctions method) as nodes in a filter control's visual tree, when underlying criteria contain these functions.

  • "v18_2" Behavior: a filter control's visual tree does not display nodes for the registered custom functions.

  • "Latest" Behavior: a filter control's visual tree displays nodes for the registered custom functions.

DateTime functions in Filters

Multiple words in data-aware control's Find Panels

Control appearance inside disabled PanelControls

  • Affected controls: PanelControl and its descendants
  • Related property: PanelControl.UseDisabledStatePainter
  • "v18_2" Behavior: an additional semi-transparent gray layer is painted above disabled Panel Controls to accentuate this disabled state.
  • "Latest" Behavior: all controls inside a disabled Panel Control are painted with the standard "disabled" appearance.

FilterEditor menus embedded in Data Grid

The appearance of caption buttons in a disabled layout group

  • Affected control: LayoutControl
  • Related property: none
  • "v18_2" Behavior: buttons are not grayed out in a disabled layout group.
  • "Latest" Behavior: buttons are grayed out in a disabled layout group.

Expanded Version 18.1

The table below illustrates the properties and behaviors that change if you set the WindowsFormsSettings.DefaultSettingsCompatibilityMode property to v18_1 (in comparison to the Latest mode).

Excel Filters

  • Affected controls: all controls that support Excel-style filters
  • Related property: ExcelFilterOptions.Default.PreferredDateTimeValuesTreeFilterType (static property)
  • "v18_1" Behavior: the default value is TreeView: filters embed the default VS TreeView control.
  • "Latest" Behavior: the default value is TreeListBox - filters embed the templated ListBoxControl control that provides a more solid appearance, yields better performance on large data sources, and supports features like Scrollbar Annotations.

Printing and exporting editors that show SVG images

  • Affected controls: data editors that use vector images.
  • Related images:
  • "v18_1" Behavior: vector images are converted to regular raster images when printing or exporting Grid data.
  • "Latest" Behavior: vector images are printed/exported as is.

Default filter type in Pivot Grid

Skin\Appearance priority

Expanded Version 17.2

The table below illustrates the properties that may change if you set the WindowsFormsSettings.DefaultSettingsCompatibilityMode property to v17_2 (in comparison to the Latest mode).

FilterEditorControl embedded in data-aware controls

LookAndFeel inheritance

  • Affected controls: controls whose LookAndFeel settings are handled by the BarAndDockingController component:
  • Related properties: XtraForm.LookAndFeel properties of affected controls.
  • "v17_2" Behavior: controls do not take into account the form's look-and-feel settings (XtraForm.LookAndFeel). To specify the look-and-feel settings for these controls within a certain form, place a BarAndDockingController component onto the form.
  • "Latest" Behavior: controls inherit form look-and-feel settings without a BarAndDockingController component.

Editor and gallery scaling in Bars and Ribbon

AutoScaleFactor in Layout and Data Layout Controls

Expanded Version 17.1

The table below illustrates which properties may change if you set the WindowsFormsSettings.DefaultSettingsCompatibilityMode property to v17_1 (compared to the Latest mode).

Popup menu width

Tree List column width

  • Affected control: TreeList
  • Related property: TreeListColumn.Width
  • "v17_1" Behavior: a column width does not exactly match the Width property value.
  • "Latest" Behavior: the Width property specifies the exact column width.

Minimal Tree List column width

  • Affected control: TreeList
  • Related property: TreeListColumn.MinWidth
  • "v17_1" Behavior: a Column MinWidth property values change dynamically when TreeListOptionsView.BestFitNodes is set to Visible.
  • "Latest" Behavior: the MinWidth property has a constant value that depends only on the maximum available node indent.

Tree List best fit operations

  • Affected control: TreeList
  • Related property: TreeListOptionsView.BestFitMode
  • "v17_1" Behavior: best fit operations take more time, but calculate the width more accurately.
  • "Latest" Behavior: best fit operations prefer calculation speed.

Tab Key behavior in Tree List

Default filter availability in Vertical Grid

  • Affected control: VGridControl
  • Related property: VGridOptionsFilter.AllowFilter
  • "v17_1" Behavior: the default property value is false (the VGridControl cannot filter its data).
  • "Latest" Behavior: the default property value is true.

Vertical Grid context menu availability

AeroGlass effect in Ribbon Forms

  • Affected control: RibbonForm
  • Related property: RibbonForm.AllowFormGlass
  • "v17_1" Behavior: you can manually enable Aero glass effects for any RibbonForm.
  • "Latest" Behavior: if a RibbonForm contains a Ribbon with the Default RibbonControl.RibbonStyle property value (which is interpreted as Office2013), you cannot enable Aero glass form effects.

Expanded Version 16

The table below illustrates the properties and behaviors that change if you set the WindowsFormsSettings.DefaultSettingsCompatibilityMode property to v16 (in comparison to the Latest mode).

Embedded Expression Editor type

AutoFilterRow conditions

  • "v16" Behavior: end-users cannot modify filter conditions when utilizing the Data Grid and TreeList automatic filter rows. As a developer, you can manually select the desired condition using the OptionsFilter.AutoFilterCondition property for a Data Grid or Tree List column.
  • "Latest" Behavior: in Data Grid and TreeList controls, automatic filter rows display buttons that allow end-users to change the filter expression operator. End-users are limited to a specific set of conditions, depending on the column data type and filter mode (the GridColumn.FilterMode and TreeListColumn.FilterMode properties). For instance, end-users cannot select conditions such as "Begins with..." for numeric columns by default.

The same limitations apply to developers. If you switch the OptionsFilter.AutoFilterCondition option to BeginsWith for a numeric column, it has no effect unless you change this column's filtering mode to DisplayText.

Data-Aware Export

BestFit operations

Merged Grouping

Default Find Panel availability

  • Affected control: TreeList
  • Related property: TreeListOptionsFind.AllowFindPanel
  • "v16" Behavior: find panel is not available by default; the Ctrl+F shortcut does not invoke this panel.
  • "Latest" Behavior: find panel is available.

Default Filtering availability

Default filter mode

Automatic row generation

Default filter type

  • "v16" Behavior: controls display standard filter dropdown menus.
  • "Latest" Behavior: controls display Excel-style filter dropdown menus

Empty date items

Default Ribbon style

Transparent editor background

  • "Latest" Behavior: when focused, these editors have a transparent background.

Form title bar skinning

Is this topic helpful?​​​​​​​