Windows apps
Collapse the table of content
Expand the table of content
Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

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 bool AllowsTransparency { get; set; }

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:
© 2017 Microsoft