WindowChrome.GlassFrameThickness Property

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

Namespace:  Microsoft.Windows.Shell
Assembly:  Microsoft.Windows.Shell (in Microsoft.Windows.Shell.dll)

Syntax

'Declaration
Public Property GlassFrameThickness As Thickness
public Thickness GlassFrameThickness { get; set; }
public:
property Thickness GlassFrameThickness {
    Thickness get ();
    void set (Thickness value);
}
member GlassFrameThickness : Thickness with get, set
function get GlassFrameThickness () : Thickness
function set GlassFrameThickness (value : Thickness)

Property Value

Type: System.Windows.Thickness
The width of the glass border around a window.

Dependency Property Information

Identifier field

GlassFrameThicknessProperty

Metadata properties set to true

None

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.

.NET Framework Security

See Also

Reference

WindowChrome Class

Microsoft.Windows.Shell Namespace