Image.GetAlphaMask 方法

定義

命名空間:

Microsoft.UI.Xaml.Controls

會傳回遮罩，代表影像的Alpha色板做為 CompositionBrush。

public:
 virtual CompositionBrush ^ GetAlphaMask() = GetAlphaMask;

CompositionBrush GetAlphaMask();

public CompositionBrush GetAlphaMask();

function getAlphaMask()

Public Function GetAlphaMask () As CompositionBrush

傳回

CompositionBrush

代表影像 Alpha 色板的遮罩。

備註

這個方法會從影像取得 Alpha 遮罩做為 CompositionBrush ，您可以使用做為組合陰影和效果的輸入。 Alpha 遮罩 CompositionBrush 的對齊方式和延展屬性值與來源 XAML 元素套用至其轉譯的內容相同，讓您可以使用這些值來正確定位相對於 XAML 元素的陰影或效果。

版本相容性

在 Windows 10 1607 版之前，無法使用 GetAlphaMask 方法。 如果您的 App 在 Microsoft Visual Studio 中的「最低平臺版本」設定小於此頁面稍後的 [需求] 區塊中顯示的「引進版本」，您必須設計並測試您的應用程式以考慮此設定。 如需詳細資訊，請參閱 版本調適型程序代碼。

若要避免在舊版 Windows 10 上執行應用程式時發生例外狀況，請勿在沒有先執行運行時間檢查的情況下呼叫此方法。 此範例示範如何使用 ApiInformation 類別來檢查此方法是否存在，再使用它。

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