Image.GetAlphaMask 方法

定義

命名空間:

Windows.UI.Xaml.Controls

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

public:
 virtual CompositionBrush ^ GetAlphaMask() = GetAlphaMask;

CompositionBrush GetAlphaMask();

public CompositionBrush GetAlphaMask();

function getAlphaMask()

Public Function GetAlphaMask () As CompositionBrush

傳回

CompositionBrush

代表影像 Alpha 色板的遮罩。

Windows 需求

裝置系列	Windows 10 Anniversary Edition (已於 10.0.14393.0 引進)
API contract	Windows.Foundation.UniversalApiContract (已於 v3.0 引進)

備註

這個方法會從影像取得 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();
}