Image.GetAlphaMask Método

Definición

Espacio de nombres:

Windows.UI.Xaml.Controls

Devuelve una máscara que representa el canal alfa de una imagen como compositionBrush.

public:
 virtual CompositionBrush ^ GetAlphaMask() = GetAlphaMask;

CompositionBrush GetAlphaMask();

public CompositionBrush GetAlphaMask();

function getAlphaMask()

Public Function GetAlphaMask () As CompositionBrush

Devoluciones

CompositionBrush

Máscara que representa el canal alfa de una imagen.

Requisitos de Windows

Familia de dispositivos	Windows 10 Anniversary Edition (se introdujo en la versión 10.0.14393.0)
API contract	Windows.Foundation.UniversalApiContract (se introdujo en la versión v3.0)

Comentarios

Este método obtiene una máscara alfa de una imagen como compositionBrush que se puede usar como entrada para componer sombras y efectos. CompositionBrush de máscara alfa tiene los mismos valores de propiedad de alineación y stretch que el elemento XAML de origen aplica a su contenido representado para que puedas usar esos valores para colocar correctamente sombras o efectos en relación con el elemento XAML.

Compatibilidad de versiones

El método GetAlphaMask no está disponible antes de Windows 10, versión 1607. Si la configuración "versión mínima de la plataforma" de la aplicación en Microsoft Visual Studio es menor que la "versión introducida" que se muestra en el bloque Requisitos más adelante en esta página, debe diseñar y probar la aplicación para que tenga en cuenta esto. Para obtener más información, consulta Código adaptable de versión.

Para evitar excepciones cuando la aplicación se ejecute en versiones anteriores de Windows 10, no llame a este método sin realizar primero una comprobación en tiempo de ejecución. En este ejemplo se muestra cómo usar la clase ApiInformation para comprobar la presencia de este método antes de usarlo.

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