AcrylicBrush Class


Paints an area with a semi-transparent material that uses multiple effects including blur and a noise texture.

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 327680)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class AcrylicBrush : XamlCompositionBrushBase
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 327680)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class AcrylicBrush : XamlCompositionBrushBase
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 327680)]
public class AcrylicBrush : XamlCompositionBrushBase
function AcrylicBrush()
Public Class AcrylicBrush
Inherits XamlCompositionBrushBase

Windows requirements

Device family
Windows 10 Fall Creators Update (introduced in 10.0.16299.0)
API contract
Windows.Foundation.UniversalApiContract (introduced in v5.0)



For more info, design guidance, and code examples, see Acrylic material.

If you have the XAML Controls Gallery app installed, click here to open the app and see Acrylic in action.


Version history

Windows version SDK version Value added
1903 18362 TintLuminosityOpacity



Initializes a new instance of the AcrylicBrush class.



Gets or sets a value that specifies whether the brush is forced to the solid fallback color.


Identifies the AlwaysUseFallback dependency property.


Gets or sets a value that specifies whether the brush samples from the app content or from the content behind the app window.


Identifies the BackgroundSource dependency property.


Gets or sets the CompositionBrush used by this XAML brush.

Equivalent WinUI property: Microsoft.UI.Xaml.Media.XamlCompositionBrushBase.CompositionBrush.

(Inherited from XamlCompositionBrushBase)

Gets the CoreDispatcher that this object is associated with. The CoreDispatcher represents a facility that can access the DependencyObject on the UI thread even if the code is initiated by a non-UI thread.

Equivalent WinUI property: Microsoft.UI.Xaml.DependencyObject.Dispatcher.

(Inherited from DependencyObject)

The color to use for rendering in case the CompositionBrush can't be rendered.

Equivalent WinUI property: Microsoft.UI.Xaml.Media.XamlCompositionBrushBase.FallbackColor.

(Inherited from XamlCompositionBrushBase)

Gets or sets the degree of opacity of a Brush.

Equivalent WinUI property: Microsoft.UI.Xaml.Media.Brush.Opacity.

(Inherited from Brush)

Gets or sets the transformation that is applied to the brush using relative coordinates.

Equivalent WinUI property: Microsoft.UI.Xaml.Media.Brush.RelativeTransform.

(Inherited from Brush)

Gets or sets the color tint for the semi-transparent acrylic material.


Identifies the TintColor dependency property.


Gets or sets the brightness amount between the TintColor and the underlying pixels behind the Acrylic surface.


Identifies the TintLuminosityOpacity dependency property.


Gets or sets the degree of opacity of the color tint.


Identifies the TintOpacity dependency property.


Gets or sets the length of the automatic transition animation used when the TintColor changes.


Identifies the TintTransitionDuration dependency property.


Gets or sets the transformation that is applied to the brush.

Equivalent WinUI property: Microsoft.UI.Xaml.Media.Brush.Transform.

(Inherited from Brush)



Clears the local value of a dependency property.

Equivalent WinUI method: Microsoft.UI.Xaml.DependencyObject.ClearValue.

(Inherited from DependencyObject)

Returns any base value established for a dependency property, which would apply in cases where an animation is not active.

Equivalent WinUI method: Microsoft.UI.Xaml.DependencyObject.GetAnimationBaseValue.

(Inherited from DependencyObject)

Returns the current effective value of a dependency property from a DependencyObject.

Equivalent WinUI method: Microsoft.UI.Xaml.DependencyObject.GetValue.

(Inherited from DependencyObject)

Invoked when a brush is first used on screen to paint an element.

When implemented in a derived class, you can create a CompositionBrush instance and provide it to the framework by setting the CompositionBrush property.

OnDisconnected will be called when the brush is no longer being used to paint any elements.

Equivalent WinUI method: Microsoft.UI.Xaml.Media.XamlCompositionBrushBase.OnConnected.

(Inherited from XamlCompositionBrushBase)

Invoked when the brush is no longer being used to paint any elements.

When implemented in a derived class, you can safely dispose of the compostion brush and other composition resources.

OnConnected will be called again if the brush is later used to paint any elements after being disconnected.

Equivalent WinUI method: Microsoft.UI.Xaml.Media.XamlCompositionBrushBase.OnDisconnected.

(Inherited from XamlCompositionBrushBase)
PopulatePropertyInfo(String, AnimationPropertyInfo)

Defines a property that can be animated.

Equivalent WinUI method: Microsoft.UI.Xaml.Media.Brush.PopulatePropertyInfo.

(Inherited from Brush)
PopulatePropertyInfoOverride(String, AnimationPropertyInfo)

When overridden in a derived class, defines a property that can be animated.

Equivalent WinUI method: Microsoft.UI.Xaml.Media.Brush.PopulatePropertyInfoOverride.

(Inherited from Brush)

Returns the local value of a dependency property, if a local value is set.

Equivalent WinUI method: Microsoft.UI.Xaml.DependencyObject.ReadLocalValue.

(Inherited from DependencyObject)
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback)

Registers a notification function for listening to changes to a specific DependencyProperty on this DependencyObject instance.

Equivalent WinUI method: Microsoft.UI.Xaml.DependencyObject.RegisterPropertyChangedCallback.

(Inherited from DependencyObject)
SetValue(DependencyProperty, Object)

Sets the local value of a dependency property on a DependencyObject.

Equivalent WinUI method: Microsoft.UI.Xaml.DependencyObject.SetValue.

(Inherited from DependencyObject)
UnregisterPropertyChangedCallback(DependencyProperty, Int64)

Cancels a change notification that was previously registered by calling RegisterPropertyChangedCallback.

Equivalent WinUI method: Microsoft.UI.Xaml.DependencyObject.UnregisterPropertyChangedCallback.

(Inherited from DependencyObject)

Applies to

See also