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.v24.1.dll

NuGet Package: DevExpress.Win.Navigation

Declaration

C#

[DefaultValue(DefaultBoolean.Default)]
[DXCategory("Appearance")]
public DefaultBoolean AllowFormGlass { get; set; }

VB.NET

<DefaultValue(DefaultBoolean.Default)>
<DXCategory("Appearance")>
Public Property AllowFormGlass As DefaultBoolean

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	Return Value
True	The value is true.	0
False	The value is false.	1
Default	The value is specified by a global option or a higher-level object.	2

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.