TextBlock.GetAlphaMask Método

Definição

Namespace:

Microsoft.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.

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