Log In
Home
Support
Demos
Documentation
Blogs
Training
Webinars
[Expand]General Information
[Collapse]WinForms Controls
  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
  [Expand]Filtering UI Context
  [Expand]High DPI Support
  [Expand]Scaffolding Wizard
  [Expand]Formatting Values
   HTML Text Formatting
  [Expand]Menus
  [Expand]Tooltip Management
  [Expand]Saving and Restoring 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]Document Server
[Expand]Reporting
[Expand]Report Server
[Expand]Dashboard
[Expand]eXpressApp Framework
[Expand]CodeRush
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation

Version Compatibility: Default Property Values

DevExpress version updates introduce new features that may change particular controls' default behavior. When you migrate to a newer DevExpress controls and components version, you have an option to revert these features to the previous version using the static WindowsFormsSettings.DefaultSettingsCompatibilityMode property.

All the latest changes are in effect if the WindowsFormsSettings.DefaultSettingsCompatibilityMode property equals Latest.

Expanded Version 16

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

Control
Affected properties
Behavior
v16
Latest
GridControl
TreeList
VGridControl
ColumnViewOptionsBehavior.UnboundColumnExpressionEditorMode
TreeListOptionsBehavior.UnboundColumnExpressionEditorMode
VGridOptionsBehavior.UnboundColumnExpressionEditorMode
End-users invoke the standard Expression Editor dialog. End-users invoke the advanced Expression Editor dialog that supports auto-completion and syntax highlighting.
GridControl
TreeList
XlsExportOptionsEx.GroupState
XlsxExportOptionsEx.GroupState
In Data-Aware Export Mode (when the XlsExportOptionsEx.ExportType / XlsxExportOptionsEx.ExportType property equals DataAware), the XlsExportOptionsEx.GroupState and XlsxExportOptionsEx.GroupState properties do not depend on the current GridOptionsPrint.ExpandAllGroups and TreeListOptionsPrint.PrintAllNodes property values. GroupState properties are set to Default by default, and groups within an exported Excel document are expanded or collapsed depending on their current state within a Data Grid or Tree List. In Data-Aware Export Mode, if the GridOptionsPrint.ExpandAllGroups and TreeListOptionsPrint.PrintAllNodes properties equal true, the XlsExportOptionsEx.GroupState and XlsxExportOptionsEx.GroupState properties' Default value is equivalent to ExpandAll. Otherwise, the Default setting checks the current group (node) state within a control (same as in legacy behavior).
GridControl
TreeList
GridOptionsFilter.AllowAutoFilterConditionChange
OptionsColumnFilter.AutoFilterCondition
TreeListOptionsFilter.AllowAutoFilterConditionChange
TreeListOptionsColumnFilter.AutoFilterCondition
WindowsFormsSettings.ColumnAutoFilterMode
WindowsFormsSettings.AllowAutoFilterConditionChange
End-users cannot modify filtering conditions when utilizing the Data Grid and TreeList automatic filtering rows. As a developer, you can manually select the desired condition by utilizing the OptionsFilter.AutoFilterCondition property for a Data Grid or Tree List column. Automatic filtering rows for Data Grid and TreeList control display buttons that allow end-users to change the filtering expression operator. End-users are limited to a particular 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 like "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.
GridControl GridOptionsView.BestFitMode Best fit operations prefer calculation precision. Best fit operations prefer calculation speed.
GridControl GridOptionsCustomization.AllowMergedGrouping Grouping by multiple columns at once is disabled. Grouping by multiple columns at once is enabled.
TreeList TreeListOptionsFind.AllowFindPanel Find panel is not available by default; the Ctrl+F shortcut does not invoke this panel. Find panel is available.
TreeList TreeListOptionsBehavior.EnableFiltering Filtering in Tree List is disabled by default. Filtering in Tree List is enabled by default.
TreeList TreeListOptionsFilter.FilterMode The Default filter mode is equal to FilterMode.Standard.
The Default filter mode is equal to FilterMode.Extended.
PropertyGridControl PropertyGridControl.AutoGenerateRows Rows do not generate automatically. Rows generate automatically.
GridControl
TreeList
OptionsColumnFilter.FilterPopupMode
TreeListOptionsColumnFilter.FilterPopupMode
Controls display standard filter dropdown menus. Controls display Excel-style filter dropdown menus
GridControl
TreeList
OptionsColumnFilter.ShowEmptyDateFilter
TreeListOptionsColumnFilter.ShowEmptyDateFilter
In Excel-style filter dropdowns, the "Show Empty" items are hidden. In Excel-style filter dropdowns, the "Show Empty" items are visible.
RibbonControl RibbonControl.RibbonStyle The Default style applies the RibbonControlStyle.Office2007 style. The Default style applies the RibbonControlStyle.Office2013 style.
RibbonControl RibbonControl.TransparentEditorsMode When focused, certain in-place editors (CheckEdit, RadioGroup, TrackBarControl and PictureEdit) do not have a transparent background.
When focused, these editors have a transparent background.
DevExpress Forms none To enable form title bar skinning, you need to call the SkinManager.EnableFormSkins method manually before the form is created. The SkinManager.EnableFormSkins method is called automatically, and you need to call the SkinManager.DisableFormSkins method to revert it.

Expanded Version 17.1

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

Control
Affected properties
Behavior
v17_1
Latest
RepositoryItemPopupContainerEdit
RepositoryItemLookUpEditBase
RepositoryItemBlobBaseEdit
classes and their descendants
RepositoryItemPopupContainerEdit.PopupWidthMode
RepositoryItemLookUpEditBase.PopupWidthMode
RepositoryItemBlobBaseEdit.PopupWidthMode
The Default property value is equal to the ContentWidth value. The Default property value is equal to the UseEditorWidth value.
TreeList TreeListColumn.Width A column width does not exactly match the Width property value. The Width property specifies the exact column width.
TreeListColumn.MinWidth Columns' MinWidth property values change dynamically when the TreeList.BestFitVisibleOnly setting is enabled. The MinWidth property has a constant value that depends only on the maximum available node indent.
TreeListOptionsView.BestFitMode Best fit operations prefer calculation precision. Best fit operations prefer calculation speed.
TreeListOptionsNavigation.UseTabKey The default property value is false. The default property value is true.
VGridControl VGridOptionsFilter.AllowFilter The VGridControl cannot filter its data. The VGridControl can filter its data. The VGridOptionsFilter.AllowFilter property equals true by default.
VGridOptionsMenu.EnableContextMenu The VGridOptionsMenu.EnableContextMenu property equals false by default. The VGridOptionsMenu.EnableContextMenu property equals true by default.
RibbonForm RibbonForm.AllowFormGlass You can manually enable Aero glass effects for a RibbonForm that contains a Ribbon, whose RibbonControl.RibbonStyle property equals Default. 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.

How would you rate this topic?​​​​​​​