TextBlock.GetAlphaMask Método

public:
 virtual CompositionBrush ^ GetAlphaMask() = GetAlphaMask;

CompositionBrush GetAlphaMask();

public CompositionBrush GetAlphaMask();

function getAlphaMask()

Public Function GetAlphaMask () As CompositionBrush

Retornos

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

Comentários

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

Compatibilidade entre 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 aplicativo no Microsoft Visual Studio for menor do 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 o 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 executar primeiro uma verificação de runtime. Este exemplo mostra como usar a classe ApiInformation para verificar a presença desse método antes de usá-lo.

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