Skip to main content

XtraForm.FormBorderEffect Property

Gets or sets the form’s border effect.

Namespace: DevExpress.XtraEditors

Assembly: DevExpress.Utils.v24.1.dll

NuGet Packages: DevExpress.Utils, DevExpress.Wpf.Core

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.

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.

See Also