TextBlock.GetAlphaMask Метод

Определение

Пространство имен:

Windows.UI.Xaml.Controls

Возвращает маску, представляющую альфа-канал текста в виде CompositionBrush.

public:
 virtual CompositionBrush ^ GetAlphaMask() = GetAlphaMask;

CompositionBrush GetAlphaMask();

public CompositionBrush GetAlphaMask();

function getAlphaMask()

Public Function GetAlphaMask () As CompositionBrush

Возвращаемое значение

CompositionBrush

Маска, представляющая альфа-канал текста в TextBlock.

Требования к Windows

Семейство устройств	Windows 10 Anniversary Edition (появилось в 10.0.14393.0)
API contract	Windows.Foundation.UniversalApiContract (появилось в v3.0)

Комментарии

Этот метод получает альфа-маску из текста в виде CompositionBrush , которую можно использовать в качестве входных данных для тени и эффектов композиции. Альфа-маска 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();
}