RibbonForm.AllowFormGlass Property
Gets or sets whether the form’s title and border are painted according to the native Windows theme or with a skin.
Namespace: DevExpress.XtraBars.Ribbon
Assembly: DevExpress.XtraBars.v20.2.dll
NuGet Package: DevExpress.Win.Navigation
Declaration
[DefaultValue(DefaultBoolean.Default)]
[DXCategory("Appearance")]
public DefaultBoolean AllowFormGlass { get; set; }
Property Value
Type | Default | Description |
---|---|---|
DefaultBoolean | **Default** | A DefaultBoolean value that specifies whether the form’s title and border are painted according to the native Windows theme or with a skin. |
Available values:
Name | Description |
---|---|
True | Corresponds to a Boolean value of true. |
False | Corresponds to a Boolean value of false. |
Default | The value is determined by the current object’s parent object setting (e.g., a control setting). |
Remarks
The AllowFormGlass property enables and disables frame transparency for RibbonForms on Windows OS’s that support the Aero Glass theme (Windows Vista and Windows 7). The following images show a sample RibbonForm run in Windows 7 with the AllowFormGlass property set to True and False respectively:
Note
Frame transparency can be enabled for RibbonForms via the AllowFormGlass property only if the Windows Aero Glass theme is active.
Note
The frame transparency feature is disabled for RibbonForms, regardless of the AllowFormGlass property’s value, in the following cases:
- The RibbonControl.RibbonStyle property is set to Office2013.
- Any of the following skins are applied: Office 2013, Office 2013 Dark Gray or Office 2013 Light Gray.
By default, the AllowFormGlass property is set to DefaultBoolean.Default. This is equal to True for the Microsoft Windows OS’s that support the Windows Aero interface.
For Microsoft Windows OS’s that do not support the Aero interface, the window frame is painted as follows:
- according to the OS’s visual settings, if the AllowFormGlass property is set to Default or True;
- using a skin, if the AllowFormGlass property is set to False.
To enable the form glass effect for all Ribbon Forms at once, utilize the static WindowsFormsSettings.AllowRibbonFormGlass setting.
Related GitHub Examples
The following code snippet (auto-collected from DevExpress Examples) contains a reference to the AllowFormGlass 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.