Función MagSetColorEffect (magnification.h)

Establece la matriz de transformación de color para un control de lupa.

Sintaxis

BOOL MagSetColorEffect(
  [in] HWND            hwnd,
  [in] PMAGCOLOREFFECT pEffect
);

Parámetros

[in] hwnd

Tipo: HWND

Ventana de ampliación.

[in] pEffect

Tipo: PMAGCOLOREFFECT

Matriz de transformación de color o NULL para quitar el efecto de color actual, si existe.

Valor devuelto

Tipo: BOOL

Devuelve TRUE si se ejecuta correctamente o FALSE de lo contrario.

Comentarios

El control de lupa usa la matriz de transformación de color para aplicar un efecto de color a toda la ventana de lupa. Si se llama a la función varias veces, se usa la transformación de color más reciente.

Esta función requiere tarjetas de vídeo compatibles con windows Display Driver Model (WDDM).

Ejemplos

En el ejemplo siguiente se establece una matriz de transformación de color que convierte los colores mostrados en la lupa en escala de grises.

// Description:
//   Converts the colors displayed in the magnifier window to grayscale, or
//   returns the colors to normal.
// Parameters:
//   hwndMag - Handle of the magnifier control.
//   fInvert - TRUE to convert to grayscale, or FALSE for normal colors.
//
BOOL ConvertToGrayscale(HWND hwndMag, BOOL fConvert)
{
    // Convert the screen colors in the magnifier window.
    if (fConvert)
    {
        MAGCOLOREFFECT magEffectGrayscale = 
            {{ // MagEffectGrayscale
                {  0.3f,  0.3f,  0.3f,  0.0f,  0.0f },
                {  0.6f,  0.6f,  0.6f,  0.0f,  0.0f },
                {  0.1f,  0.1f,  0.1f,  0.0f,  0.0f },
                {  0.0f,  0.0f,  0.0f,  1.0f,  0.0f },
                {  0.0f,  0.0f,  0.0f,  0.0f,  1.0f } 
            }};

        return MagSetColorEffect(hwndMag, &magEffectGrayscale);
    }

    // Return the colors to normal.
    else
    {
        return MagSetColorEffect(hwndMag, NULL);
    }
}

Requisitos

Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	magnification.h
Library	Magnification.lib
Archivo DLL	Magnification.dll

Consulte también

MagGetColorEffect