Windows Dev Center

MagGetColorEffect function

Gets the color transformation matrix for a magnifier control.

Syntax


BOOL WINAPI MagGetColorEffect(
  _In_  HWND            hwnd,
  _Out_ PMAGCOLOREFFECT pEffect
);

Parameters

hwnd [in]

Type: HWND

The magnification window.

pEffect [out]

Type: PMAGCOLOREFFECT

The color transformation matrix, or NULL if no color effect has been set.

Return value

Type: BOOL

Returns TRUE if successful, or FALSE otherwise.

Remarks

The magnifier control uses the color transformation matrix to apply a color effect to the entire magnifier window.

This function requires Windows Display Driver Model (WDDM)-capable video cards.

Examples

The following example retrieves the color transformation matrix.


// Description:
//   Retrieves the color transformation matrix from a magnifier control.
// Parameters:
//   hwndMag - handle of the magnifier control.
//
BOOL GetMagnifierColorTransform(HWND hwndMag)
{
    MAGCOLOREFFECT effect;

    BOOL ret = MagGetColorEffect(hwndMag, &effect);

    //
    // Do something with the color data.
    //

    return ret;
}


Requirements

Minimum supported client

Windows Vista [desktop apps only]

Minimum supported server

Windows Server 2008 [desktop apps only]

Header

Magnification.h

Library

Magnification.lib

DLL

Magnification.dll

See also

MagSetColorEffect

 

 

Community Additions

ADD
Show:
© 2015 Microsoft