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

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	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.

C#

how-to-put-any-control-in-the-ribbonform-header-t236177/CS/Form1.cs#L24

{
    this.AllowFormGlass = toggleSwitch1.IsOn ? DefaultBoolean.True : DefaultBoolean.False;
}

VB.NET

how-to-put-any-control-in-the-ribbonform-header-t236177/VB/Form1.vb#L22

Private Sub toggleSwitch1_Toggled(ByVal sender As Object, ByVal e As EventArgs) Handles toggleSwitch1.Toggled
    Me.AllowFormGlass = If(toggleSwitch1.IsOn, DefaultBoolean.True, DefaultBoolean.False)
End Sub