TextBlock.GetAlphaMask Méthode

Définition

Espace de noms:

Windows.UI.Xaml.Controls

Renvoie un masque qui représente le canal alpha du texte sous forme de CompositionBrush.

public:
 virtual CompositionBrush ^ GetAlphaMask() = GetAlphaMask;

CompositionBrush GetAlphaMask();

public CompositionBrush GetAlphaMask();

function getAlphaMask()

Public Function GetAlphaMask () As CompositionBrush

Retours

CompositionBrush

Masque qui représente le canal alpha du texte dans un TextBlock.

Configuration requise pour Windows

Famille d’appareils	Windows 10 Anniversary Edition (introduit dans 10.0.14393.0)
API contract	Windows.Foundation.UniversalApiContract (introduit dans v3.0)

Remarques

Cette méthode obtient un masque alpha du texte en tant que CompositionBrush que vous pouvez utiliser comme entrée pour les ombres et les effets de composition. Le masque alpha CompositionBrush a les mêmes valeurs de propriété d’alignement et d’étirement que l’élément XAML source applique à son contenu rendu, ce qui vous permet d’utiliser ces valeurs pour positionner correctement les ombres ou les effets par rapport à l’élément XAML.

Compatibilité des versions

La méthode GetAlphaMask n’est pas disponible avant Windows 10, version 1607. Si le paramètre « version de plateforme minimale » de votre application dans Microsoft Visual Studio est inférieur à la « version introduite » indiquée dans le bloc Configuration requise plus loin dans cette page, vous devez concevoir et tester votre application pour tenir compte de cela. Pour plus d’informations, consultez Code adaptatif de version.

Pour éviter les exceptions lorsque votre application s’exécute sur des versions antérieures de Windows 10, n’appelez pas cette méthode sans avoir d’abord effectué un case activée d’exécution. Cet exemple montre comment utiliser la classe ApiInformation pour case activée la présence de cette méthode avant de l’utiliser.

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