AcrylicBrush Classe

Referência

Definição

Namespace:: Windows.UI.Xaml.Media

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Editar

Pinta uma área com um material semitransparente que usa vários efeitos, incluindo desfoque e textura de ruído.

Equivalente API winui 2 paraUWP: Microsoft.UI.Xaml.Media.AcrylicBrush (para WinUI no do SDK do Aplicativo Windows, consulte os namespaces do SDK do aplicativo 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

Herança: Object IInspectable DependencyObject Brush XamlCompositionBrushBase AcrylicBrush

Atributos: ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisitos do Windows

Família de dispositivos	Windows 10 Fall Creators Update (introduzida na 10.0.16299.0)
API contract	Windows.Foundation.UniversalApiContract (introduzida na v5.0)

Exemplos

Ponta

Para obter mais informações, diretrizes de design e exemplos de código, consulte material acrílico.

Se você tiver o aplicativo da Galeria WinUI 2 instalado, clique aqui para abrir o aplicativo e ver o Acrílico em ação.

Para adicionar um pincel acrílico, defina os três recursos para temas escuros, claros e de alto contraste. Observe que, em alto contraste, é recomendável usar um SolidColorBrush com o mesmo x:Key que o AcrylicBrush escuro/claro.

Nota

Se você não especificar um valor TintLuminosityOpacity, o sistema ajustará automaticamente seu valor com base em TintColor e 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>

Este exemplo mostra como criar um AcrylicBrush no código. Se o aplicativo der suporte a vários destinos do sistema operacional, verifique se essa API está disponível no computador do usuário antes de usá-la.

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;
}

Comentários

Histórico de versões

Versão do Windows	Versão do SDK	Valor acrescentado
1903	18362	TintLuminosityOpacity

Construtores

AcrylicBrush()

Inicializa uma nova instância da classe AcrylicBrush.

Equivalente API do WinUI 2 paraUWP: Microsoft.UI.Xaml.Media.AcrylicBrush.-ctor (para WinUI nodo SDK do Aplicativo do Windows , consulte os namespaces do SDK do aplicativo Windows).

Propriedades

AlwaysUseFallback	Obtém ou define um valor que especifica se o pincel é forçado à cor de fallback sólida. Equivalente API do WinUI 2 paraUWP: Microsoft.UI.Xaml.Media.AcrylicBrush.AlwaysUseFallback (para WinUI nodo SDK do Aplicativo do Windows , consulte os namespaces do SDK do aplicativo Windows).
AlwaysUseFallbackProperty	Identifica a propriedade de dependência AlwaysUseFallback. Equivalente a API winui 2 paraUWP: Microsoft.UI.Xaml.Media.AcrylicBrush.AlwaysUseFallbackProperty (para WinUI nodo SDK do Aplicativo do Windows , consulte os namespaces do SDK do aplicativo Windows).
BackgroundSource	Obtém ou define um valor que especifica se os exemplos de pincel do conteúdo do aplicativo ou do conteúdo por trás da janela do aplicativo. Equivalente API winui 2 paraUWP: Microsoft.UI.Xaml.Media.AcrylicBrush.BackgroundSource (para WinUI no do SDK do Aplicativo windows, consulte os namespaces do SDK do aplicativo Windows).
BackgroundSourceProperty	Identifica a propriedade de dependência BackgroundSource. Equivalente API winui 2 paraUWP: microsoft.UI.Xaml.Media.AcrylicBrush.BackgroundSourceProperty (para WinUI nodo SDK do aplicativo Windows, consulte os namespaces do SDK do aplicativo Windows).
CompositionBrush	Obtém ou define o CompositionBrush usado por este pincel XAML. (Herdado de XamlCompositionBrushBase)
Dispatcher	Obtém o CoreDispatcher ao qual esse objeto está associado. O CoreDispatcher representa uma instalação que pode acessar o DependencyObject no thread da interface do usuário, mesmo que o código seja iniciado por um thread que não seja da interface do usuário. (Herdado de DependencyObject)
FallbackColor	A cor a ser usada para renderização caso a CompositionBrush não possa ser renderizada. (Herdado de XamlCompositionBrushBase)
Opacity	Obtém ou define o grau de opacidade de um pincel de . (Herdado de Brush)
RelativeTransform	Obtém ou define a transformação que é aplicada ao pincel usando coordenadas relativas. (Herdado de Brush)
TintColor	Obtém ou define a tonalidade de cor do material acrílico semitransparente. Equivalente API winui 2 paraUWP: Microsoft.UI.Xaml.Media.AcrylicBrush.TintColor (para WinUI nodo SDK do aplicativo do Windows , consulte os namespaces do SDK do aplicativo Windows).
TintColorProperty	Identifica a propriedade de dependência TintColor. Equivalente API winui 2 paraUWP: Microsoft.UI.Xaml.Media.AcrylicBrush.TintColorProperty (para WinUI nodo SDK do aplicativo Windows, consulte os namespaces do SDK do aplicativo Windows).
TintLuminosityOpacity	Obtém ou define a quantidade de brilho entre o TintColor e os pixels subjacentes atrás da superfície acrílica. Equivalente API do WinUI 2 paraUWP: Microsoft.UI.Xaml.Media.AcrylicBrush.TintLuminosityOpacity (para WinUI nodo SDK do Aplicativo do Windows , consulte os namespaces do SDK do aplicativo Windows).
TintLuminosityOpacityProperty	Identifica a propriedade de dependência TintLuminosityOpacity. Equivalente API winui 2 paraUWP: Microsoft.UI.Xaml.Media.AcrylicBrush.TintLuminosityOpacityProperty (para WinUI nodo SDK do Aplicativo do Windows , consulte os namespaces do SDK do aplicativo Windows).
TintOpacity	Obtém ou define o grau de opacidade da tonalidade de cor. Equivalente API winui 2 paraUWP: Microsoft.UI.Xaml.Media.AcrylicBrush.TintOpacity (para WinUI nodo SDK do aplicativo Windows, consulte os namespaces do SDK do aplicativo Windows).
TintOpacityProperty	Identifica a propriedade de dependência TintOpacity. Equivalente API do WinUI 2 paraUWP: Microsoft.UI.Xaml.Media.AcrylicBrush.TintOpacityProperty (para WinUI nodo SDK do Aplicativo do Windows , consulte os namespaces do SDK do aplicativo Windows).
TintTransitionDuration	Obtém ou define o comprimento da animação de transição automática usada quando o TintColor é alterado. Equivalente API winui 2 paraUWP: Microsoft.UI.Xaml.Media.AcrylicBrush.TintTransitionDuration (para WinUI nodo SDK do aplicativo Windows, consulte os namespaces do SDK do aplicativo Windows).
TintTransitionDurationProperty	Identifica a propriedade de dependência TintTransitionDuration. Equivalente API winui 2 paraUWP: Microsoft.UI.Xaml.Media.AcrylicBrush.TintTransitionDurationProperty (para WinUI nodo SDK do Aplicativo do Windows , consulte os namespaces do SDK do aplicativo Windows).
Transform	Obtém ou define a transformação que é aplicada ao pincel. (Herdado de Brush)

Métodos

ClearValue(DependencyProperty)	Limpa o valor local de uma propriedade de dependência. (Herdado de DependencyObject)
GetAnimationBaseValue(DependencyProperty)	Retorna qualquer valor base estabelecido para uma propriedade de dependência, que se aplicaria em casos em que uma animação não está ativa. (Herdado de DependencyObject)
GetValue(DependencyProperty)	Retorna o valor efetivo atual de uma propriedade de dependência de um DependencyObject. (Herdado de DependencyObject)
OnConnected()	Invocado quando um pincel é usado pela primeira vez na tela para pintar um elemento. Quando implementado em uma classe derivada, você pode criar uma instância CompositionBrush e fornecê-la à estrutura definindo a propriedade CompositionBrush. OnDisconnected será chamado quando o pincel não estiver mais sendo usado para pintar elementos. (Herdado de XamlCompositionBrushBase)
OnDisconnected()	Invocado quando o pincel não está mais sendo usado para pintar elementos. Quando implementado em uma classe derivada, você pode descartar com segurança o pincel de compostagem e outros recursos de composição. OnConnected será chamado novamente se o pincel for usado posteriormente para pintar quaisquer elementos após ser desconectado. (Herdado de XamlCompositionBrushBase)
PopulatePropertyInfo(String, AnimationPropertyInfo)	Define uma propriedade que pode ser animada. (Herdado de Brush)
PopulatePropertyInfoOverride(String, AnimationPropertyInfo)	Quando substituído em uma classe derivada, define uma propriedade que pode ser animada. (Herdado de Brush)
ReadLocalValue(DependencyProperty)	Retorna o valor local de uma propriedade de dependência, se um valor local for definido. (Herdado de DependencyObject)
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback)	Registra uma função de notificação para ouvir alterações em um dependencyProperty específico nesta instância dependencyObject . (Herdado de DependencyObject)
SetValue(DependencyProperty, Object)	Define o valor local de uma propriedade de dependência em um DependencyObject. (Herdado de DependencyObject)
UnregisterPropertyChangedCallback(DependencyProperty, Int64)	Cancela uma notificação de alteração que foi registrada anteriormente chamando RegisterPropertyChangedCallback. (Herdado de DependencyObject)

Aplica-se a

Confira também

visão geral do material Acrílico

Partilhar via

AcrylicBrush Classe

Definição

Requisitos do Windows

Exemplos

Comentários

Histórico de versões

Construtores

Propriedades

Métodos

Aplica-se a

Confira também

Comentários

Recursos adicionais