TextBlock.GetAlphaMask Metodo

public:
 virtual CompositionBrush ^ GetAlphaMask() = GetAlphaMask;

CompositionBrush GetAlphaMask();

public CompositionBrush GetAlphaMask();

function getAlphaMask()

Public Function GetAlphaMask () As CompositionBrush

Valori restituiti

Maschera che rappresenta il canale alfa del testo in un controllo TextBlock.

Commenti

Questo metodo ottiene una maschera alfa dal testo come CompositionBrush che è possibile usare come input per le ombreggiature e gli effetti della composizione. La maschera alfa CompositionBrush ha gli stessi valori di allineamento e proprietà di estensione applicati dall'elemento XAML di origine al contenuto di cui è stato eseguito il rendering, in modo da poter usare tali valori per posizionare correttamente le ombreggiature o gli effetti rispetto all'elemento XAML.

Compatibilità delle versioni

Il metodo GetAlphaMask non è disponibile prima di Windows 10 versione 1607. Se l'impostazione "versione minima della piattaforma" dell'app in Microsoft Visual Studio è inferiore alla "versione introdotta" visualizzata nel blocco Requisiti più avanti in questa pagina, è necessario progettare e testare l'app per tenere conto di questo problema. Per altre info, vedi Codice adattivo per la versione.

Per evitare eccezioni quando l'app viene eseguita nelle versioni precedenti di Windows 10, non chiamare questo metodo senza prima eseguire un controllo di runtime. Questo esempio mostra come usare la classe ApiInformation per verificare la presenza di questo metodo prima di usarlo.

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