MagSetFullscreenColorEffect 函式 (放大.h)

變更與全螢幕放大鏡相關聯的色彩轉換矩陣。

語法

BOOL MagSetFullscreenColorEffect(
  [in] PMAGCOLOREFFECT pEffect
);

參數

[in] pEffect

類型： PMAGCOLOREFFECT

新的色彩轉換矩陣。 此參數不得為 Null。

傳回值

類型： BOOL

如果成功，則傳回 TRUE，否則傳回 FALSE。

備註

全螢幕放大鏡會使用色彩轉換矩陣，將色彩效果套用至整個桌面。 如果多次呼叫函式，則會使用最新的色彩轉換。

範例

下列範例會定義兩個色彩轉換矩陣，以搭配 MagSetFullscreenColorEffect使用。 矩陣會將 g_MagEffectGrayscale 螢幕色彩轉換成灰階。 矩陣 g_MagEffectIdentity 是識別矩陣，可還原原始螢幕色彩。

// Initialize color transformation matrices used to apply grayscale and to 
// restore the original screen color.
MAGCOLOREFFECT g_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};

MAGCOLOREFFECT g_MagEffectIdentity = {1.0f,  0.0f,  0.0f,  0.0f,  0.0f,
                                      0.0f,  1.0f,  0.0f,  0.0f,  0.0f,
                                      0.0f,  0.0f,  1.0f,  0.0f,  0.0f,
                                      0.0f,  0.0f,  0.0f,  1.0f,  0.0f,
                                      0.0f,  0.0f,  0.0f,  0.0f,  1.0f};

BOOL SetColorGrayscale(__in BOOL fGrayscaleOn)
{
    // Apply the color matrix required to either apply grayscale to the screen 
    // colors or to show the regular colors.
    PMAGCOLOREFFECT pEffect = 
                (fGrayscaleOn ? &g_MagEffectGrayscale : &g_MagEffectIdentity);

    return MagSetFullscreenColorEffect(pEffect);
}

需求

最低支援的用戶端	Windows 8 [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2012 [僅限傳統型應用程式]
目標平台	Windows
標頭	放大.h
程式庫	Magnification.lib
Dll	Magnification.dll

另請參閱

MagGetFullscreenColorEffect