次の方法で共有


Image.GetAlphaMask メソッド

定義

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

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

戻り値

画像のアルファ チャネルを表すマスク。

注釈

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

バージョンの互換性

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

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

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

適用対象