AcrylicBrush Clase

Referencia

Definición

Espacio de nombres:: Windows.UI.Xaml.Media

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Editar

Pinta un área con un material semitransparente que usa varios efectos, como el desenfoque y una textura de ruido.

Api de WinUI 2 equivalente para UWP: microsoft.UI.Xaml.Media.AcrylicBrush (para WinUI en ladel SDK de aplicaciones de Windows de , consulta los espacios de nombres del SDK de aplicaciones de Windows ).

/// [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)]
[WebHostHidden]
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)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public class AcrylicBrush : XamlCompositionBrushBase

function AcrylicBrush()

Public Class AcrylicBrush
Inherits XamlCompositionBrushBase

Herencia: Object IInspectable DependencyObject Brush XamlCompositionBrushBase AcrylicBrush

Atributos: ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisitos de Windows

Familia de dispositivos	Windows 10 Fall Creators Update (se introdujo en la versión 10.0.16299.0)
API contract	Windows.Foundation.UniversalApiContract (se introdujo en la versión v5.0)

Ejemplos

Propina

Para obtener más información, instrucciones de diseño y ejemplos de código, consulta material de Acrylic.

Si tienes instalada la aplicación Galería de WinUI 2, haz clic aquí para abrir la aplicación y ver Acrílico en acción.

Para agregar un pincel acrílico, defina los tres recursos para temas oscuros, claros y de contraste alto. Tenga en cuenta que, en contraste alto, se recomienda usar un SolidColorBrush con el mismo x:Key que el acrílico oscuro/claro.

Nota

Si no especifica un valor TintLuminosityOpacity, el sistema ajustará automáticamente su valor en función de TintColor y TintOpacity.

<ResourceDictionary.ThemeDictionaries>
    <ResourceDictionary x:Key="Default">
        <AcrylicBrush x:Key="MyAcrylicBrush"
            BackgroundSource="HostBackdrop"
            TintColor="#FFFF0000"
            TintOpacity="0.8"
            TintLuminosityOpacity="0.5"
            FallbackColor="#FF7F0000"/>
    </ResourceDictionary>

    <ResourceDictionary x:Key="HighContrast">
        <SolidColorBrush x:Key="MyAcrylicBrush"
            Color="{ThemeResource SystemColorWindowColor}"/>
    </ResourceDictionary>

    <ResourceDictionary x:Key="Light">
        <AcrylicBrush x:Key="MyAcrylicBrush"
            BackgroundSource="HostBackdrop"
            TintColor="#FFFF0000"
            TintOpacity="0.8"
            TintLuminosityOpacity="0.5"
            FallbackColor="#FFFF7F7F"/>
    </ResourceDictionary>
</ResourceDictionary.ThemeDictionaries>

En este ejemplo se muestra cómo crear un AcrylicBrush en el código. Si la aplicación admite varios destinos del sistema operativo, asegúrese de comprobar que esta API está disponible en el equipo del usuario antes de usarla.

if (Windows.Foundation.Metadata.ApiInformation.IsTypePresent("Windows.UI.Xaml.Media.AcrylicBrush"))
{
    Windows.UI.Xaml.Media.AcrylicBrush myBrush = new Windows.UI.Xaml.Media.AcrylicBrush();
    myBrush.BackgroundSource = Windows.UI.Xaml.Media.AcrylicBackgroundSource.HostBackdrop;
    myBrush.TintColor = Color.FromArgb(255, 202, 24, 37);
    myBrush.FallbackColor = Color.FromArgb(255, 202, 24, 37);
    myBrush.TintOpacity = 0.6;

    grid.Fill = myBrush;
}
else
{
    SolidColorBrush myBrush = new SolidColorBrush(Color.FromArgb(255, 202, 24, 37));

    grid.Fill = myBrush;
}

Comentarios

Historial de versiones

Versión de Windows	Versión del SDK	Valor añadido
1903	18362	TintLuminosityOpacity

Constructores

AcrylicBrush()

Inicializa una nueva instancia de la clase AcrylicBrush.

API de WinUI 2 equivalente para UWP: Microsoft.UI.Xaml.Media.AcrylicBrush.-ctor (para WinUI en Windows App SDK, consulta los espacios de nombres de Windows App SDK ).

Propiedades

AlwaysUseFallback	Obtiene o establece un valor que especifica si el pincel se fuerza al color de reserva sólido. Api de WinUI 2 para UWP: Microsoft.UI.Xaml.Media.AcrylicBrush.AlwaysUseFallback (para WinUI en lade Windows App SDK , consulta los espacios de nombres de Windows App SDK ).
AlwaysUseFallbackProperty	Identifica la propiedad de dependencia AlwaysUseFallback. Api de WinUI 2 equivalente para UWP: Microsoft.UI.Xaml.Media.AcrylicBrush.AlwaysUseFallbackProperty (para WinUI en el del SDK de aplicaciones de Windows, consulta los espacios de nombres de Windows App SDK ).
BackgroundSource	Obtiene o establece un valor que especifica si los ejemplos de pincel del contenido de la aplicación o del contenido detrás de la ventana de la aplicación. Api de WinUI 2 equivalente para UWP: microsoft.UI.Xaml.Media.AcrylicBrush.BackgroundSource (para WinUI en elde Windows App SDK de , consulta los espacios de nombres de Windows App SDK ).
BackgroundSourceProperty	Identifica la propiedad de dependencia BackgroundSource. Api De WinUI 2 equivalente para UWP: Microsoft.UI.Xaml.Media.AcrylicBrush.BackgroundSourceProperty (para WinUI en Windows App SDK, consulta los espacios de nombres del SDK de aplicaciones de Windows ).
CompositionBrush	Obtiene o establece el compositionBrush usado por este pincel XAML. (Heredado de XamlCompositionBrushBase)
Dispatcher	Obtiene el CoreDispatcher al que está asociado este objeto. El coreDispatcher de representa una instalación que puede acceder al DependencyObject de en el subproceso de la interfaz de usuario incluso si el código lo inicia un subproceso que no es de interfaz de usuario. (Heredado de DependencyObject)
FallbackColor	El color que se va a usar para la representación en caso de que no se pueda representar el compositionBrush de . (Heredado de XamlCompositionBrushBase)
Opacity	Obtiene o establece el grado de opacidad de un Brush. (Heredado de Brush)
RelativeTransform	Obtiene o establece la transformación que se aplica al pincel mediante coordenadas relativas. (Heredado de Brush)
TintColor	Obtiene o establece el tono de color del material acrílico semitransparente. API de WinUI 2 equivalente para UWP: Microsoft.UI.Xaml.Media.AcrylicBrush.TintColor (para WinUI en Windows App SDK, consulta los espacios de nombres de Windows App SDK de ).
TintColorProperty	Identifica la propiedad de dependencia TintColor. Api de WinUI 2 equivalente para UWP: Microsoft.UI.Xaml.Media.AcrylicBrush.TintColorProperty (para WinUI en eldel SDK de aplicaciones de Windows , consulta los espacios de nombres Windows App SDK).
TintLuminosityOpacity	Obtiene o establece la cantidad de brillo entre TintColor y los píxeles subyacentes detrás de la superficie acrílico. Api WinUI 2 equivalente para UWP: Microsoft.UI.Xaml.Media.AcrylicBrush.TintLuminosityOpacity (para WinUI en eldel SDK de aplicaciones de Windows , consulta los espacios de nombres del SDK de aplicaciones de Windows ).
TintLuminosityOpacityProperty	Identifica la propiedad de dependencia TintLuminosityOpacity. API de WinUI 2 equivalente para UWP: Microsoft.UI.Xaml.Media.AcrylicBrush.TintLuminosityOpacityProperty (para WinUI en ladel SDK de aplicaciones de Windows , consulta los espacios de nombres del SDK de aplicaciones de Windows ).
TintOpacity	Obtiene o establece el grado de opacidad del tono de color. API de WinUI 2 equivalente para UWP: Microsoft.UI.Xaml.Media.AcrylicBrush.TintOpacity (para WinUI en eldel SDK de aplicaciones de Windows , consulta los espacios de nombres de Windows App SDK ).
TintOpacityProperty	Identifica la propiedad de dependencia TintOpacity. API de WinUI 2 equivalente para UWP: Microsoft.UI.Xaml.Media.AcrylicBrush.TintOpacityProperty (para WinUI en Windows App SDK, consulta los espacios de nombres de Windows App SDK ).
TintTransitionDuration	Obtiene o establece la longitud de la animación de transición automática utilizada cuando cambia TintColor. Api de WinUI 2 equivalente para UWP: Microsoft.UI.Xaml.Media.AcrylicBrush.TintTransitionDuration (para WinUI en el windows App SDK, consulta los espacios de nombres Windows App SDK).
TintTransitionDurationProperty	Identifica la propiedad de dependencia TintTransitionDuration. API de WinUI 2 equivalente para UWP: Microsoft.UI.Xaml.Media.AcrylicBrush.TintTransitionDurationProperty (para WinUI en Windows App SDK, consulta los espacios de nombres de Windows App SDK ).
Transform	Obtiene o establece la transformación que se aplica al pincel. (Heredado de Brush)

Métodos

ClearValue(DependencyProperty)	Borra el valor local de una propiedad de dependencia. (Heredado de DependencyObject)
GetAnimationBaseValue(DependencyProperty)	Devuelve cualquier valor base establecido para una propiedad de dependencia, que se aplicaría en los casos en los que una animación no está activa. (Heredado de DependencyObject)
GetValue(DependencyProperty)	Devuelve el valor efectivo actual de una propiedad de dependencia de un DependencyObject. (Heredado de DependencyObject)
OnConnected()	Se invoca cuando se usa un pincel por primera vez en la pantalla para pintar un elemento. Cuando se implementa en una clase derivada, puede crear una instancia de CompositionBrush y proporcionarla al marco estableciendo la propiedad CompositionBrush. onDisconnected se llamará cuando el pincel ya no se use para pintar ningún elemento. (Heredado de XamlCompositionBrushBase)
OnDisconnected()	Se invoca cuando el pincel ya no se usa para pintar ningún elemento. Cuando se implementa en una clase derivada, puede eliminar de forma segura el pincel de redacción y otros recursos de composición. OnConnected se volverá a llamar si el pincel se usa más adelante para pintar los elementos después de desconectarse. (Heredado de XamlCompositionBrushBase)
PopulatePropertyInfo(String, AnimationPropertyInfo)	Define una propiedad que se puede animar. (Heredado de Brush)
PopulatePropertyInfoOverride(String, AnimationPropertyInfo)	Cuando se reemplaza en una clase derivada, define una propiedad que se puede animar. (Heredado de Brush)
ReadLocalValue(DependencyProperty)	Devuelve el valor local de una propiedad de dependencia, si se establece un valor local. (Heredado de DependencyObject)
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback)	Registra una función de notificación para escuchar los cambios en una DependencyProperty específica en esta instancia de dependencyObject . (Heredado de DependencyObject)
SetValue(DependencyProperty, Object)	Establece el valor local de una propiedad de dependencia en un DependencyObject. (Heredado de DependencyObject)
UnregisterPropertyChangedCallback(DependencyProperty, Int64)	Cancela una notificación de cambio registrada anteriormente llamando a RegisterPropertyChangedCallback. (Heredado de DependencyObject)

Se aplica a

Consulte también

información general del material de Acrylic

Compartir a través de

AcrylicBrush Clase

Definición

Requisitos de Windows

Ejemplos

Comentarios

Historial de versiones

Constructores

Propiedades

Métodos

Se aplica a

Consulte también

Comentarios

Recursos adicionales