TextBlock.GetAlphaMask 方法

定义

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

编辑

返回一个掩码，该掩码将文本的 alpha 通道表示为 CompositionBrush。

public:
 virtual CompositionBrush ^ GetAlphaMask() = GetAlphaMask;

CompositionBrush GetAlphaMask();

public CompositionBrush GetAlphaMask();

function getAlphaMask()

Public Function GetAlphaMask () As CompositionBrush

一个掩码，表示 TextBlock 中文本的 alpha 通道。

设备系列	Windows 10 Anniversary Edition (在 10.0.14393.0 中引入)
API contract	Windows.Foundation.UniversalApiContract (在 v3.0 中引入)

此方法从文本中获取 alpha 掩码作为 CompositionBrush ，你可以将其用作合成阴影和效果的输入。 alpha 掩码 CompositionBrush 具有与源 XAML 元素应用于其呈现内容相同的对齐和拉伸属性值，以便你可以使用这些值来正确定位相对于 XAML 元素的阴影或效果。

GetAlphaMask 方法在 Windows 10 版本 1607 之前不可用。如果 Microsoft Visual Studio 中应用的“最低平台版本”设置小于本页稍后的“要求”块中显示的“引入版本”，则必须设计和测试应用以考虑到这一点。有关详细信息，请参阅版本自适应代码。

若要避免在以前版本的 Windows 10 上运行应用时出现异常，请不要在不首先执行运行时检查的情况下调用此方法。此示例演示如何使用 ApiInformation 类在使用此方法之前检查是否存在此方法。

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