ホーム › UI.Magnification › MagSetFullscreenColorEffect

MagSetFullscreenColorEffect

関数

全画面拡大鏡に適用する色効果を設定する。

DLLMAGNIFICATION.dll呼出規約winapi対応OSwindows8.0

シグネチャ

// MAGNIFICATION.dll
#include <windows.h>

BOOL MagSetFullscreenColorEffect(
    MAGCOLOREFFECT* pEffect
);

パラメーター

名前	型	方向	説明
pEffect	MAGCOLOREFFECT*	in	新しいカラー変換行列。このパラメーターを NULL にすることはできません。

戻り値の型: BOOL

公式ドキュメント

全画面拡大鏡に関連付けられているカラー変換行列を変更します。

戻り値

型: BOOL

成功した場合は TRUE を返し、それ以外の場合は FALSE を返します。

解説(Remarks)

全画面拡大鏡は、カラー変換行列を使用してデスクトップ全体にカラー効果を適用します。この関数が複数回呼び出された場合は、最後に指定されたカラー変換が使用されます。

例

次の例では、MagSetFullscreenColorEffect で使用する 2 つのカラー変換行列を定義します。g_MagEffectGrayscale 行列は画面の色をグレースケールに変換します。g_MagEffectIdentity 行列は単位行列であり、元の画面の色を復元します。

// グレースケールの適用と元の画面の色の復元に使用する
// カラー変換行列を初期化します。
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)
{
    // 画面の色にグレースケールを適用するか、通常の色を表示するために
    // 必要なカラー行列を適用します。
    PMAGCOLOREFFECT pEffect = 
                (fGrayscaleOn ? &g_MagEffectGrayscale : &g_MagEffectIdentity);

    return MagSetFullscreenColorEffect(pEffect);
}

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

各言語での呼び出し定義

// MAGNIFICATION.dll
#include <windows.h>

BOOL MagSetFullscreenColorEffect(
    MAGCOLOREFFECT* pEffect
);

[return: MarshalAs(UnmanagedType.Bool)]
[DllImport("MAGNIFICATION.dll", ExactSpelling = true)]
static extern bool MagSetFullscreenColorEffect(
    IntPtr pEffect   // MAGCOLOREFFECT*
);

<DllImport("MAGNIFICATION.dll", ExactSpelling:=True)>
Public Shared Function MagSetFullscreenColorEffect(
    pEffect As IntPtr   ' MAGCOLOREFFECT*
) As <MarshalAs(UnmanagedType.Bool)> Boolean
End Function

' pEffect : MAGCOLOREFFECT*
Declare PtrSafe Function MagSetFullscreenColorEffect Lib "magnification" ( _
    ByVal pEffect As LongPtr) As Long
' VBA7前提(PtrSafe)。32bit Office では LongPtr→Long。Integer=16bit / Long=32bit / LongLong=64bit。

import ctypes
from ctypes import wintypes

MagSetFullscreenColorEffect = ctypes.windll.magnification.MagSetFullscreenColorEffect
MagSetFullscreenColorEffect.restype = wintypes.BOOL
MagSetFullscreenColorEffect.argtypes = [
    ctypes.c_void_p,  # pEffect : MAGCOLOREFFECT*
]

require 'fiddle'
require 'fiddle/import'

lib = Fiddle.dlopen('MAGNIFICATION.dll')
MagSetFullscreenColorEffect = Fiddle::Function.new(
  lib['MagSetFullscreenColorEffect'],
  [
    Fiddle::TYPE_VOIDP,  # pEffect : MAGCOLOREFFECT*
  ],
  Fiddle::TYPE_INT)

#[link(name = "magnification")]
extern "system" {
    fn MagSetFullscreenColorEffect(
        pEffect: *mut MAGCOLOREFFECT  // MAGCOLOREFFECT*
    ) -> i32;
}
// crates: windows-sys provides ready-made bindings for this API.

$sig = @"
[return: MarshalAs(UnmanagedType.Bool)]
[DllImport("MAGNIFICATION.dll")]
public static extern bool MagSetFullscreenColorEffect(IntPtr pEffect);
"@
$api = Add-Type -MemberDefinition $sig -Name 'MAGNIFICATION_MagSetFullscreenColorEffect' -Namespace Win32 -PassThru
# $api::MagSetFullscreenColorEffect(pEffect)

#uselib "MAGNIFICATION.dll"
#func global MagSetFullscreenColorEffect "MagSetFullscreenColorEffect" sptr
; MagSetFullscreenColorEffect varptr(pEffect)   ; 戻り値は stat
; pEffect : MAGCOLOREFFECT* -> "sptr"
; ※HSP3.7は #func のため戻り値はシステム変数 stat に格納されます。

出力引数:

#uselib "MAGNIFICATION.dll"
#cfunc global MagSetFullscreenColorEffect "MagSetFullscreenColorEffect" var
; res = MagSetFullscreenColorEffect(pEffect)
; pEffect : MAGCOLOREFFECT* -> "var"
; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。#uselib "MAGNIFICATION.dll"
#cfunc global MagSetFullscreenColorEffect "MagSetFullscreenColorEffect" sptr
; res = MagSetFullscreenColorEffect(varptr(pEffect))
; pEffect : MAGCOLOREFFECT* -> "sptr"
; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。