TextBlock.GetAlphaMask Metodo

Definizione

Spazio dei nomi:

Windows.UI.Xaml.Controls

Restituisce una maschera che rappresenta il canale alfa del testo come CompositionBrush.

public:
 virtual CompositionBrush ^ GetAlphaMask() = GetAlphaMask;

CompositionBrush GetAlphaMask();

public CompositionBrush GetAlphaMask();

function getAlphaMask()

Public Function GetAlphaMask () As CompositionBrush

Restituisce

CompositionBrush

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

Requisiti Windows

Famiglia di dispositivi	Windows 10 Anniversary Edition (è stato introdotto in 10.0.14393.0)
API contract	Windows.Foundation.UniversalApiContract (è stato introdotto in v3.0)

Commenti

Questo metodo ottiene una maschera alfa dal testo come CompositionBrush che è possibile utilizzare come input per ombreggiature ed effetti di composizione. La maschera alfa CompositionBrush ha gli stessi valori di allineamento e estensione delle proprietà che l'elemento XAML di origine applica al contenuto di cui è stato eseguito il rendering, in modo che sia possibile usare tali valori per posizionare correttamente le ombreggiature o gli effetti relativi all'elemento XAML.

Compatibilità tra 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 aspetto. 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();
}