Image.GetAlphaMask Methode

Definition

Namespace:

Microsoft.UI.Xaml.Controls

Gibt eine Maske zurück, die den Alphakanal eines Bilds als CompositionBrush darstellt.

public:
 virtual CompositionBrush ^ GetAlphaMask() = GetAlphaMask;

CompositionBrush GetAlphaMask();

public CompositionBrush GetAlphaMask();

function getAlphaMask()

Public Function GetAlphaMask () As CompositionBrush

Gibt zurück

CompositionBrush

Eine Maske, die den Alphakanal eines Bilds darstellt.

Hinweise

Diese Methode ruft eine Alphamaske aus einem Bild als CompositionBrush ab, die Sie als Eingabe für die Komposition von Schatten und Effekten verwenden können. Die Alphamaske CompositionBrush weist die gleichen Ausrichtungs- und Stretcheigenschaftswerte auf, die das XAML-Quellelement auf den gerenderten Inhalt anwendet, sodass Sie diese Werte verwenden können, um Schatten oder Effekte relativ zum XAML-Element korrekt zu positionieren.

Versionskompatibilität

Die GetAlphaMask-Methode ist vor Windows 10 Version 1607 nicht verfügbar. Wenn die Einstellung "Mindestplattformversion" Ihrer App in Microsoft Visual Studio kleiner als die im Abschnitt "Anforderungen" weiter unten auf dieser Seite angezeigte "eingeführte Version" ist, müssen Sie die App entwerfen und testen, um dies zu berücksichtigen. Weitere Informationen finden Sie unter Versionsadaptiver Code.

Um Ausnahmen zu vermeiden, wenn Ihre App in früheren Versionen von Windows 10 ausgeführt wird, rufen Sie diese Methode nicht auf, ohne zuerst eine Laufzeitüberprüfung durchzuführen. In diesem Beispiel wird gezeigt, wie Sie die ApiInformation-Klasse verwenden, um zu überprüfen, ob diese Methode vorhanden ist, bevor Sie sie verwenden.

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