TextBlock.GetAlphaMask Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Gibt eine Maske zurück, die den Alphakanal des Texts als CompositionBrush darstellt.
public:
virtual CompositionBrush ^ GetAlphaMask() = GetAlphaMask;CompositionBrush GetAlphaMask();public CompositionBrush GetAlphaMask();function getAlphaMask()Public Function GetAlphaMask () As CompositionBrushGibt zurück
Eine Maske, die den Alphakanal des Texts in einem TextBlock darstellt.
Windows-Anforderungen
| Gerätefamilie |
Windows 10 Anniversary Edition (eingeführt in 10.0.14393.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (eingeführt in v3.0)
|
Hinweise
Diese Methode ruft eine Alphamaske aus dem Text als CompositionBrush ab, die Sie als Eingabe für Kompositionsschatten und -effekte verwenden können. Die Alphamaske CompositionBrush weist dieselben Ausrichtungs- und Stretcheigenschaftenwerte 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 ist als die "eingeführte Version", die im Block Anforderungen weiter unten auf dieser Seite angezeigt wird, müssen Sie Ihre App entwerfen und testen, um dies zu berücksichtigen. Weitere Informationen finden Sie unter Adaptiver Versionscode.
Um Ausnahmen zu vermeiden, wenn Ihre App in früheren Versionen von Windows 10 ausgeführt wird, rufen Sie diese Methode nicht auf, ohne zuvor eine Laufzeitprü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.TextBlock", "GetAlphaMask"))
{
var compositionBrush = textBlock1.GetAlphaMask();
}