Edit

Share via


WindowChrome.GlassFrameThickness Property

Definition

Gets or sets a value that indicates the width of the glass border around a window.

public:
 property System::Windows::Thickness GlassFrameThickness { System::Windows::Thickness get(); void set(System::Windows::Thickness value); };
public System.Windows.Thickness GlassFrameThickness { get; set; }
member this.GlassFrameThickness : System.Windows.Thickness with get, set
Public Property GlassFrameThickness As Thickness

Property Value

The width of the glass border around a window.

Remarks

Set the GlassFrameThickness property to specify the amount that the Windows Aero glass frame extends into the client area of a window. By default, the glass frame will use system values to emulate the look of a standard window. If Windows Aero is enabled, then the standard caption buttons (Maximize, Minimize, Close) are enabled and interactive. To make a custom window that does not have a glass frame, set this thickness to a uniform value of 0. This will disable the standard caption buttons.

To extend the glass frame to cover the entire window, set the GlassFrameThickness property to a negative value on any side. If the GlassFrameThickness property is set to a negative value for any side, its coerced value will be equal to GlassFrameCompleteThickness. The GlassFrameCompleteThickness property is provided as a utility to enable you to set the thickness of the glass frame to a named property that extends the glass over the entire window.

Windows Aero glass effects are not supported on all operating systems, and can be disabled on supported operating systems. If Windows Aero is not available, the glass frame will not be displayed regardless of the GlassFrameThickness property value. You should check the IsGlassEnabled property to verify that Windows Aero glass effects are available. If glass effects are not available, you should provide an alternate window style that does not use the glass frame.

Dependency Property Information

Item Value
Identifier field GlassFrameThicknessProperty
Metadata properties set to true None

Applies to