TextBlock.GetAlphaMask メソッド

public:
 virtual CompositionBrush ^ GetAlphaMask() = GetAlphaMask;

CompositionBrush GetAlphaMask();

public CompositionBrush GetAlphaMask();

function getAlphaMask()

Public Function GetAlphaMask () As CompositionBrush

返品

TextBlock 内のテキストのアルファ チャネルを表すマスク。

注釈

このメソッドは、合成シャドウと効果の入力として使用できる CompositionBrush としてテキストからアルファ マスクを取得します。 アルファ マスク CompositionBrush には、ソース XAML 要素がレンダリングされたコンテンツに適用されるものと同じ配置とストレッチ プロパティ値があるため、これらの値を使用して XAML 要素に対する影や効果を正しく配置できます。

バージョン互換性

GetAlphaMask メソッドは、Windows 10 バージョン 1607 より前には使用できません。 Microsoft Visual Studioのアプリの "最小プラットフォーム バージョン" 設定が、このページの後半の「要件」ブロックに示されている「導入されたバージョン」よりも小さい場合は、これを考慮するようにアプリを設計してテストする必要があります。 詳細については、「 バージョン アダプティブ コード」を参照してください。

以前のバージョンのWindows 10でアプリを実行するときに例外を回避するには、最初にランタイム チェックを実行せずにこのメソッドを呼び出さないでください。 この例では、 ApiInformation クラスを使用して、使用する前にこのメソッドの存在を確認する方法を示します。

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