Skip to main content

WindowsFormsSettings Members

Exposes appearance and behavior settings common to all DevExpress controls.

Fields

Name Description
DefaultSettingsCompatibilityMode static Modifies default values of various properties according to the selected DevExpress installation version.

Properties

Name Description
AllowArrowDragIndicators static Gets or sets whether dragging-and-dropping columns/fields is indicated using arrow indicators. This is a static property.
AllowAutoFilterConditionChange static Gets or sets whether or not Data Grid and TreeList automatic filtering rows should display buttons that allow end-users to change the filtering condition.
AllowDefaultSvgImages static Gets or sets whether or not automatically generated UI elements (e.g., Grid context menu items) should display vector icons.
AllowDpiScale static Gets or sets whether or not DevExpress Skins can be scaled on high-DPI devices.
AllowFormSkins static Gets whether the form title bar skinning feature is enabled. This is a static property.
AllowHoverAnimation static Gets or sets whether animation on hovering objects is enabled. This is a static property.
AllowOverpanApplicationWindow static Gets or sets whether the window bounce (panning feedback) is enabled when an end-user tries to pan (scroll with the finger) beyond a control’s pannable area. This is a static property.
AllowPixelScrolling static Gets or sets whether smooth pixel-based scrolling is enabled for controls. This is a static property.
AllowRibbonFormGlass static Gets or sets whether or not all RibbonForms used within this app should use the Windows 7 Aero effect.
AllowRoundedWindowCorners static Specifies whether forms, dialogs, panels and tooltips have rounded corners. When this option is enabled, the form’s borders, including shadows, are drawn by the operating system. This option is only in effect in Windows 11.
AllowSkinEditorAttach static Gets or sets whether or not you can use this application to preview custom skins in WinForms Skin Editor.
AllowWindowGhosting static Gets or sets whether the window ghosting feature is enabled for skinned XtraForm objects. This is a static property.
AnimationMode static Gets or sets whether DevExpress controls animate end-user operations (expand/collapse, tab switch, sorting, etc.). This is a static (shared in VB) property.
AutoCorrectForeColor static Gets or sets whether UI elements should automatically adjust their foreground colors when these elements use DX Skin Colors for backgrounds. This behavior ensures the foreground color has enough contrast against the background to improve readability.
BackgroundSkinningMode static Gets or sets whether colors assigned to AppearanceObject.BackColor or AppearanceObject.BorderColor properties can blend with skin element bitmaps.
ColumnAutoFilterMode static Allows you to restore default filtering conditions for all Data Grid auto-filter rows to their 16.2 versions.
ColumnFilterPopupMode static Gets or sets the default display mode of column filter dropdowns in all GridControls, TreeLists and PivotGridControls in the current application.
CompactUIMode static Reduces control paddings and margins to display more information on-screen in data-intensive applications. You can enable this mode at design time in the Project Settings Page.
CustomBehaviorPreferences static Gets or sets settings that change application behavior in edge cases.
CustomizationFormSnapMode static Gets or sets whether or not customization forms can stick to each other, parent forms or screen edges.
DefaultAllowHtmlDraw static Indicates whether HTML text formatting is enabled for controls by default. This is a static property.
DefaultFont static Gets or sets the default font for DevExpress controls (except menus and toolbars). This is a static property.
DefaultLookAndFeel static Gets the default UserLookAndFeel object which is used for painting controls. This is a static property.
DefaultMenuFont static Gets and sets the default font used to display text on menus, toolbars and popup menus (except Ribbon elements). This is a static property.
DefaultPrintFont static Gets or sets the default text font for printing. This is a static property.
DefaultRibbonStyle static Gets or sets the default style for all RibbonControls in the application.
DisableAccessibility static Gets or sets whether the accessibility features (interaction with accessibility tools such as Microsoft Narrator) of DevExpress controls are disabled. This is a static property, and thus it affects all controls in your application.
DockingViewStyle static Gets or sets the style for all DockManager and DocumentManager panels in this application.
DragScrollThumbBeyondControlMode static Gets or sets whether the scroll bar thumb restores its previous position or keeps the terminal position when it is dragged beyond a control. This is a static property.
DragScrollThumbBeyondControlThreshold static Gets or sets the threshold, in pixels, beyond which the previous vertical scroll bar thumb position is restored. This property is in effect in the RestoreThumbPosition mode. This is a static property.
EnableCodedUITestExtension static Gets or sets whether to enable the Coded UI Test Extension.
FilterCriteriaDisplayStyle static Gets or sets the default display style of filter conditions in a control’s Filter Panel, MRU Filter List, and built-in Filter Editor.
FindPanelBehavior static Gets or sets whether records that do not match a query in a find panel are hidden.
FindPanelCondition static Specifies the default comparison operator (Contains, Equals, StartWith, etc.) a control uses to search for words entered in a Find Panel. This setting is applied to all controls that have their OptionsFind.Condition properties set to Default.
FindPanelParserKind static Specifies the default behavior of a control’s Find Panel when it combines entered words to create a search query. This setting is applied to all controls that have their OptionsFind.ParserKind properties set to Default.
FocusRectStyle static Gets or sets the style of dashed lines to paint focus rectangles. This is a static property.
FontBehavior static Gets or sets the behavior specifying fonts used by DevExpress and standard .NET controls. This is a static property. Setting this property modifies the WindowsFormsSettings.DefaultFont property.
FontIconsStyle static Gets or sets the default icon font style.
FormatRuleColorScaleMinMaxBehavior static
FormThickBorder static Gets or sets whether all XtraForm and RibbonForm forms in the application should display thick borders.
InplaceEditorUpdateMode static

Gets or sets edit value update mode for BarEditItems which display inplace editors in bars (see Bar Manager) and Ribbon controls. This property is supported for a limited set of inplace editors. See the Remarks section for more information.

IsAllowPixelScrolling static

Gets whether smooth pixel-based scrolling is enabled for controls. This is a static property.

KeyboardNavigationExtensions static Gets or sets additional keyboard navigation options that you can enable for all controls within the application.
MdiFormThickBorder static Gets or sets whether all child MDI XtraForm and RibbonForm forms in the application should display increased borders.
OptimizeRemoteConnectionPerformance static Gets or sets whether the application should disable various visual effects to enhance the performance when accessed over slow remote connections.
PopupAnimation static Gets or sets the animation effects that follow expanding and collapsing popup menus.
PopupMenuStyle static Gets or sets whether the DevExpess controls’ built-in context menus are displayed in the classic rectangular or radial style. This is a static property.
PopupShadowStyle static Specifies the shadow style applied to all popup menus in this application.
PreferredDateTimeCulture static Gets or sets the culture settings used by date-time (calendar, scheduler, etc.) controls for month names, day abbreviations, and the first day of week.
PrioritizeIListSourceInDiagramDataBinding static
RibbonItemPanelStyle static
RightToLeft static Gets or sets whether visual elements of DevExpress controls are aligned to support locales using right-to-left fonts. This is a static property.
RightToLeftLayout static Gets or sets whether right-to-left mirror placement is turned on.
ScrollUIMode static Gets or sets whether scroll bars are optimized for desktop or touch applications. This is a static (Shared in VB.NET) property. Set this property at application startup.
ShowTouchScrollBarOnMouseMove static Gets or sets whether a control’s scroll bars appear on screen when an end-user moves the mouse pointer over the scrollable content. This is a static property.
SmartMouseWheelProcessing static Gets or sets whether the mouse wheel scrolls the control that is currently hovered over with the mouse pointer or the control that is currently focused. This property is in effect for controls that reside within an XtraForm or RibbonForm. This is a static property.
SuppressExcessiveAccessibilityNotifications static Gets or sets whether to suppress accessibility events on mouse hover. This is a static property.
SvgImageRenderingMode static Gets or sets the rendering quality of vector images.
ThickBorderWidth static Gets or sets the width of XtraForm and RibbonForm “thick” borders. Forms use thick borders when you enable the WindowsFormsSettings.FormThickBorder and\or WindowsFormsSettings.MdiFormThickBorder properties.
TouchScaleFactor static Gets or sets a scale factor used to calculate the size of controls and distance between their elements in touch UI mode. This is a static (Shared in VB.NET) property.
TouchUIMode static Gets or sets whether controls increase their size and the distance between their elements according to a scale factor. This is a static (Shared in VB.NET) property.
TrackSystemHighContrastMode static If this property is enabled, your application automatically applies the DevExpress “High Contrast” skin when Windows high contrast mode is on, and disables UI selectors that allow users to change skins and skin palettes. Otherwise, if this property is disabled, the active application skin does not depend on the actual state of Windows high contrast mode, and users can select any skin or skin palette. Windows high contrast mode is configured in the “Personalize | High contrast settings” screen.
TrackWindowsAccentColor static Gets or sets whether to use the Accent Color setting in Windows OS and apply it to all color palettes of vector skins except the High Contrast skin.
TrackWindowsAppMode static Gets or sets whether your application tracks the Default App Mode setting in Windows OS and displays only light or dark color palettes in a Skin gallery. This setting works only in “WXI”, “Basic”, and “The Bezier” skins.
UseAdvancedFilterEditorControl static Specifies whether WinForms data-aware controls should use the advanced Filter Editor Control that features a single-tab interface and enhanced text criteria builder.
UseAdvancedTextEdit static Switches all TextEdit-based editors (except for RepositoryItemHypertextLabel and HyperLinkEdit) to Advanced Mode. See this property for more information about this mode: RepositoryItemTextEdit.UseAdvancedMode.
UseDXDialogs static Gets or sets whether DevExpress controls and components that display Open File, Save File and Folder Browser dialogs should display standard WinForms dialogs or their DevExpress counterparts (XtraOpenFileDialog, XtraSaveFileDialog, and XtraFolderBrowserDialog).
UseEditorTextAsAccessibleName static Gets or sets whether to use the editor’s value (text) as accessible name (AccessibilityObject.Name).
UseUIAutomation static Gets or sets whether DevExpress controls should use legacy Microsoft Active Accessibility (MSAA) or UIAutomation. See this link for more information on both technologies: Microsoft Active Accessibility and UI Automation Compared.

Methods

Name Description
ApplyDemoSettings() static This method is called by DevExpress demos to apply specific settings. This is a static method.
DisableFormSkins() static Disables the title bar skinning feature for DevExpress forms and message boxes.
DisableMdiFormSkins() static Disables the title bar skinning feature for MDI child DevExpress forms.
DisableWindowShadows() static Disables window shadows for XtraForm, XtraMessageBox, and XtraDialog.
EnableFormSkins() static Enables the title bar skinning feature for DevExpress forms and message boxes.
EnableFormSkinsIfXP() static Enables the title bar skinning feature for DevExpress forms and message boxes, if the application is running under Microsoft Windows XP.
EnableMdiFormSkins() static Enables the title bar skinning feature for MDI child DevExpress forms.
EnableWindowShadows() static Re-enables form, message and dialog shadows that have been turned off with the WindowsFormsSettings.DisableWindowShadows() method call. Can also be used to display shadows through remote connections when the WindowsFormsSettings.OptimizeRemoteConnectionPerformance property is enabled.
Equals(Object, Object) static Determines whether the specified object instances are considered equal. Inherited from Object.
Equals(Object) Determines whether the specified object is equal to the current object. Inherited from Object.
ForceAPIPaint() static Enables the mixed use of the DevExpress text rendering library and System.Windows.Forms.TextRenderer class functionality.
ForceDirectXPaint() static Turns the DirectX Hardware Acceleration on.
ForceGDIPlusPaint() static Enables the use of the System.Drawing.Graphics class for text rendering.
ForcePaintApiDiagnostics(PaintApiDiagnosticsLevel, PaintApiTraceLevelResolver) static Allows you to trace all outdated APIs that are not recommended for use with DirectX-rendered and Per-Monitor DPI-aware applications. Starting with version 18.2, also traces Appearance.BackColor properties modified for skinned UI elements.
ForceTextRenderPaint() static Enables the use of the System.Windows.Forms.TextRenderer class for rendering text.
GetAccentColor() static Returns a custom accent color.
GetAccentColor2() static Returns the second accent color.
GetAllowDefaultSvgImages() static Returns the actual value of the WindowsFormsSettings.AllowDefaultSvgImages property.
GetAllowHoverAnimation(ISkinProvider) static Returns whether animation on hovering objects is enabled. This is a static method.
GetAllowRoundedWindowCorners() static
GetAllowSkinEditorAttach() static Returns whether this application can serve as an External Preview Application in WinForms Skin Editor. See the WindowsFormsSettings.AllowSkinEditorAttach property for the details.
GetAutoCorrectForeColor() static Returns the current WindowsFormsSettings.AutoCorrectForeColor property setting.
GetFormatRuleColorScaleMinMaxBehavior() static
GetHashCode() Serves as the default hash function. Inherited from Object.
GetIsRightToLeft(Control) static Returns a Boolean value that indicates whether the specified control is actually aligned to support locales using right-to-left fonts. This is a static method.
GetIsRightToLeft(RightToLeft) static Returns a Boolean value that specifies whether DevExpress controls are aligned to support locales using right-to-left fonts. The method parameter allows the default behavior to be specified. This is a static method.
GetIsRightToLeftLayout(Boolean) static Returns a Boolean value that indicates whether right-to-left mirror placement is turned on. The method parameter allows the default behavior to be specified. This is a static method.
GetIsRightToLeftLayout(Control) static Returns a Boolean value that indicates whether right-to-left mirror placement is turned on for the specified control or form. This is a static method.
GetPopupShadowStyle(UserLookAndFeel) static
GetRightToLeft(Control) static Returns a RightToLeft enumeration value that indicates whether the specified control is actually aligned to support locales using right-to-left fonts. This is a static method.
GetRightToLeft(RightToLeft) static Returns a RightToLeft enumeration value that specifies whether DevExpress controls are aligned to support locales using right-to-left fonts. The method parameter allows the default behavior to be specified. This is a static method.
GetType() Gets the Type of the current instance. Inherited from Object.
LoadApplicationSettings() static Loads application settings and updates the corresponding CLR properties accordingly.
MemberwiseClone() protected Creates a shallow copy of the current Object. Inherited from Object.
ReferenceEquals(Object, Object) static Determines whether the specified Object instances are the same instance. Inherited from Object.
RegisterUserSkin(SkinBlobXmlCreator) static Registers the specified skin stored as a BLOB for runtime use. This method replaces the previously used SkinManager.RegisterSkin(SkinCreator) method that did not affect splash screens and required that you call the additional SplashScreenManager.RegisterUserSkins(Assembly) method.
RegisterUserSkins(Assembly) static Registers all skins from the target assembly, allowing you and your users to apply them. This method replaces the previously used SkinManager.Default.RegisterAssembly method that did not affect splash screens and required that you call the additional SplashScreenManager.RegisterUserSkins(Assembly) method.
SetAccentColor(Color) static Specifies a custom accent color. The custom accent color overrides the accent color setting in Windows OS (if the TrackWindowsAccentColor option is enabled).
SetAccentColor2(Color) static Specifies the second accent color. “The Bezier” skin supports the second accent color. Other skins do not support the second accent color.
SetDPIAware() static Enables system DPI awareness mode for the current process.
SetPerMonitorDpiAware() static Enables “Per-Monitor (v2)” DPI awareness mode for the process if it runs on versions greater than Windows 10 Creators Update (build 1703). On older Windows OS versions, enables system DPI awareness mode.
ToString() Returns a string that represents the current object. Inherited from Object.
See Also