Window.AllowsTransparency Property

 
System_CAPS_noteNote

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

Gets or sets a value that indicates whether a window's client area supports transparency.

Namespace:   System.Windows
Assembly:  PresentationFramework (in PresentationFramework.dll)

Public Property AllowsTransparency As Boolean

Property Value

Type: System.Boolean

true if the window supports transparency; otherwise, false.

Exception Condition
InvalidOperationException

AllowsTransparency is changed after a window has been shown.

InvalidOperationException

A window that has a WindowStyle value of anything other than None.

When the Background property of a window is set to a transparent color, using Transparent for example, the window remains opaque. This means that the desktop and any running applications "beneath" the window cannot be seen. To enable this type of transparency, AllowsTransparency must be set to true.

AllowsTransparency exists to facilitate the creation of non-rectangular windows, and, consequently, when AllowsTransparency is set to true, a window's WindowStyle property must be set to None.

Identifier field

AllowsTransparencyProperty

Metadata properties set to true

None

.NET Framework
Available since 3.0
Return to top
Show: