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.v21.2.dll

NuGet Packages: DevExpress.Win.Design, 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
True	true. DefaultBoolean.True has a constant value of 0, while the standard true value corresponds to a value of 1. In Visual Basic, do not use implicit conversion of Boolean values to DefaultBoolean, and vice versa, as the conversion may produce incorrect results.
False	false. DefaultBoolean.False has a constant value of 1, while the standard false value corresponds to a value of 0. In Visual Basic, do not use implicit conversion of Boolean values to DefaultBoolean, and vice versa, as the conversion may produce incorrect results.
Default	The default behavior determined by the control’s logic.

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.