Skip to main content
A newer version of this page is available. .

WindowsFormsSettings Members

Provides 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.
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.
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 DevExpress controls’ accessibility features (interaction with accessibility tools, e.g., MS Narrator) is 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 scroll bar thumb position is restored. This property is in effect in the RestoreThumbPosition mode. This is a static property.
FilterCriteriaDisplayStyle static Gets or sets the default display style of filter conditions in a control’s Filter Panel 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.
FormThickBorder static Gets or sets whether all XtraForm and RibbonForm forms in the application should display increased 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.

MdiFormThickBorder static Gets or sets whether all child MDI XtraForm and RibbonForm forms in the application should display increased borders.
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
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.
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.
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.
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 TokenEdit, 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).

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.
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.
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.
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.
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.
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