TextBlock.GetAlphaMask 方法

定义

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

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

返回

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

Windows 要求

设备系列
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();
}

适用于