Image.GetAlphaMask Méthode

Définition

Espace de noms:

Windows.UI.Xaml.Controls

Renvoie un masque qui représente le canal alpha d’une image en tant que 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 d’une image.

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 à partir d’une image en tant que CompositionBrush que vous pouvez utiliser comme entrée pour composer des ombres et des effets. Le masque alpha CompositionBrush a les mêmes valeurs d’alignement et de propriété stretch 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 minimale de la plateforme » 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 en tenir compte. Pour plus d’informations, consultez Code adaptatif version.

Pour éviter les exceptions lorsque votre application s’exécute sur les versions précédentes de Windows 10, n’appelez pas cette méthode sans avoir d’abord effectué une 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.Image", "GetAlphaMask"))
{
    var compositionBrush = image1.GetAlphaMask();
}