TextBlock.GetAlphaMask Metode

Definisi

Mengembalikan masker yang mewakili saluran alfa teks sebagai CompositionBrush.

public:
 virtual CompositionBrush ^ GetAlphaMask() = GetAlphaMask;
CompositionBrush GetAlphaMask();
public CompositionBrush GetAlphaMask();
function getAlphaMask()
Public Function GetAlphaMask () As CompositionBrush

Mengembalikan

Masker yang mewakili saluran alfa teks dalam TextBlock.

Persyaratan Windows

Rangkaian perangkat
Windows 10 Anniversary Edition (diperkenalkan dalam 10.0.14393.0)
API contract
Windows.Foundation.UniversalApiContract (diperkenalkan dalam v3.0)

Keterangan

Metode ini mendapatkan topeng alfa dari teks sebagai KomposisiBrush yang dapat Anda gunakan sebagai input untuk bayangan dan efek komposisi. Komposisi topeng alfaBrush memiliki nilai properti perataan dan peregangan yang sama dengan elemen XAML sumber yang diterapkan ke konten yang dirender sehingga Anda dapat menggunakan nilai-nilai tersebut untuk memposisikan bayangan atau efek dengan benar relatif terhadap elemen XAML.

Kompatibilitas versi

Metode GetAlphaMask tidak tersedia sebelum Windows 10, versi 1607. Jika pengaturan 'versi platform minimum' aplikasi Anda di Microsoft Visual Studio kurang dari 'versi yang diperkenalkan' yang ditunjukkan di blok Persyaratan nanti di halaman ini, Anda harus merancang dan menguji aplikasi Anda untuk mempertanyakan hal ini. Untuk informasi selengkapnya, lihat Kode adaptif versi.

Untuk menghindari pengecualian saat aplikasi Anda berjalan pada versi Windows 10 sebelumnya, jangan panggil metode ini tanpa terlebih dahulu melakukan pemeriksaan runtime. Contoh ini menunjukkan cara menggunakan kelas ApiInformation untuk memeriksa keberadaan metode ini sebelum Anda menggunakannya.

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

Berlaku untuk