TextBlock.GetAlphaMask メソッド

定義

名前空間:

Windows.UI.Xaml.Controls

テキストのアルファ チャネルを CompositionBrush として表すマスクを返します。

public:
 virtual CompositionBrush ^ GetAlphaMask() = GetAlphaMask;

CompositionBrush GetAlphaMask();

public CompositionBrush GetAlphaMask();

function getAlphaMask()

Public Function GetAlphaMask () As CompositionBrush

戻り値

CompositionBrush

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

Windows の要件

デバイス ファミリ	Windows 10 Anniversary Edition (10.0.14393.0 で導入)
API contract	Windows.Foundation.UniversalApiContract (v3.0 で導入)

注釈

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

バージョンの互換性

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

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

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