XtraForm.FormBorderEffect Property
Gets or sets the form’s border effect.
Namespace: DevExpress.XtraEditors
Assembly: DevExpress.Utils.v24.2.dll
Declaration
[DefaultValue(FormBorderEffect.Default)]
[DXCategory("Appearance")]
public FormBorderEffect FormBorderEffect { get; set; }
Property Value
Type | Default | Description |
---|---|---|
FormBorderEffect | Default | The form’s border adornment effect. |
Available values:
Name | Description |
---|---|
None | No adorning effect. |
Default | The default border adorning effect, applied as follows: For the XtraForm, a shadow is displayed in the “McSkin” skin. No adorning effect is applied in other skins. For the RibbonForm, a shadow is displayed in the following skins: “Office 2013”, “Office 2013 Dark Gray”, “Office 2013 Light Gray”, and “McSkin”. No adorning effect is applied in other skins. |
Shadow | Displays a shadow around the form. |
Glow | A glow effect. The default colors can be changed via the XtraForm.ActiveGlowColor and XtraForm.InactiveGlowColor properties. |
Remarks
The FormBorderEffect property allows you to apply a shadow and glow effects to the form’s border.
Border effects are not applied when the form uses the system border style. This occurs in the following cases:
- You call the WindowsFormsSettings.DisableFormSkins method, which disables title bar and border skinning, and enables the system border style.
- You set the form’s ControlBox property to false and the Text property to an empty string. The border effects are applied in this case if you set the FormBorderStyle property to None.
Custom form border effects are also disabled in Windows 11. In this OS version, all forms and dialogs display native Windows 11 shadows.
Related GitHub Examples
The following code snippet (auto-collected from DevExpress Examples) contains a reference to the FormBorderEffect property.
Note
The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.