TextBlock.GetAlphaMask Método

Definição

Namespace:

Windows.UI.Xaml.Controls

Retorna uma máscara que representa o canal alfa do texto como um CompositionBrush.

public:
 virtual CompositionBrush ^ GetAlphaMask() = GetAlphaMask;

CompositionBrush GetAlphaMask();

public CompositionBrush GetAlphaMask();

function getAlphaMask()

Public Function GetAlphaMask () As CompositionBrush

Retornos

CompositionBrush

Uma máscara que representa o canal alfa do texto em um TextBlock.

Requisitos do Windows

Família de dispositivos	Windows 10 Anniversary Edition (introduzida na 10.0.14393.0)
API contract	Windows.Foundation.UniversalApiContract (introduzida na v3.0)

Comentários

Esse método obtém uma máscara alfa do texto como um CompositionBrush que você pode usar como uma entrada para sombras e efeitos de composição. A máscara alfa CompositionBrush tem os mesmos valores de propriedade stretch e alinhamento que o elemento XAML de origem aplica ao seu conteúdo renderizado para que você possa usar esses valores para posicionar corretamente sombras ou efeitos relativos ao elemento XAML.

Compatibilidade de versões

O método GetAlphaMask não está disponível antes do Windows 10, versão 1607. Se a configuração de "versão mínima da plataforma" do seu aplicativo no Microsoft Visual Studio for menor que a "versão introduzida" mostrada no bloco Requisitos posteriormente nesta página, você deverá projetar e testar seu aplicativo para considerar isso. Para obter mais informações, consulte Código adaptável de versão.

Para evitar exceções quando seu aplicativo é executado em versões anteriores do Windows 10, não chame esse método sem primeiro executar um runtime marcar. Este exemplo mostra como usar a classe ApiInformation para marcar para a presença desse método antes de usá-lo.

if (ApiInformation.IsMethodPresent("Windows.UI.Xaml.Controls.TextBlock", "GetAlphaMask"))
{
    var compositionBrush = textBlock1.GetAlphaMask();
}