TextBlock.GetAlphaMask メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
テキストのアルファ チャネルを CompositionBrush として表すマスクを返します。
public:
virtual CompositionBrush ^ GetAlphaMask() = GetAlphaMask;CompositionBrush GetAlphaMask();public CompositionBrush GetAlphaMask();function getAlphaMask()Public Function GetAlphaMask () As 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();
}