ホーム › UI.Magnification › MagSetInputTransform

MagSetInputTransform

関数

拡大表示に対応する入力座標変換を設定する。

DLLMAGNIFICATION.dll呼出規約winapiSetLastErrorあり対応OSwindows8.0

シグネチャ

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

BOOL MagSetInputTransform(
    BOOL fEnabled,
    const RECT* pRectSource,
    const RECT* pRectDest
);

パラメーター

名前	型	方向	説明
fEnabled	BOOL	in	入力変換を有効にする場合は TRUE、無効にする場合は FALSE を指定します。
pRectSource	RECT*	in	拡大する画面領域を定義する、新しいソース四角形 (拡大されていないスクリーン座標)。bEnabled が FALSE の場合、このパラメーターは無視されます。
pRectDest	RECT*	in	拡大された画面内容が表示される画面領域を定義する、新しい変換先四角形 (拡大されていないスクリーン座標)。この四角形内のペンおよびタッチ入力は、ソース四角形にマップされます。bEnabled が FALSE の場合、このパラメーターは無視されます。

戻り値の型: BOOL

公式ドキュメント

ペンおよびタッチ入力に対する現在有効な入力変換を、ソース四角形と変換先四角形として設定します。

戻り値

型: BOOL

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

解説(Remarks)

入力変換は、拡大された画面内容の座標空間を、実際の (拡大されていない) スクリーン座標空間にマップします。これにより、拡大された画面内容に対して行われたペンおよびタッチ入力を、システムが画面上の正しい UI 要素に渡せるようになります。たとえば入力変換を行わない場合、入力は拡大された画面内容に表示されている項目ではなく、拡大されていないスクリーン座標の位置にある要素に渡されます。

この関数を使用するには、呼び出し元のプロセスが UIAccess 特権を持っている必要があります。呼び出し元が UIAccess 特権を持っていない場合、MagSetInputTransform の呼び出しは失敗し、GetLastError 関数は ERROR_ACCESS_DENIED を返します。詳細については、「UI Automation Security Considerations」および「/MANIFESTUAC (Embeds UAC information in manifest)」を参照してください。

Windows 10 Creators Update (バージョン 1703) 以降では、(ペンおよびタッチ入力に加えて) マウス入力を拡大された要素にルーティングするために、MagSetInputTransform function を使用する必要があります。

例

次の例では、全画面拡大鏡の入力変換を設定します。

// Description:
//   Applies an input transformation to adjust pen and touch input to account 
//   for the current magnification factor.
//
BOOL SetInputTranform()
{
    // Get the current magnification settings.
    float magLevel;
    int xOffset, yOffset;

    BOOL fResult = MagGetFullscreenTransform(&magLevel, &xOffset, &yOffset);
    if (fResult)
    {
        // Assume that pen or touch input occurs only in the primary monitor.
        RECT rcDest;
        rcDest.left   = 0;
        rcDest.top    = 0;
        rcDest.right  = GetSystemMetrics(SM_CXSCREEN);
        rcDest.bottom = GetSystemMetrics(SM_CYSCREEN);

        // Calculate the portion of the screen that is visible in the magnified
        // view.
        RECT rcSource;
        rcSource.left   = xOffset;
        rcSource.top    = yOffset;
        rcSource.right  = rcSource.left + (int)(rcDest.right / magLevel);
        rcSource.bottom = rcSource.top  + (int)(rcDest.bottom / magLevel);

        fResult = MagSetInputTransform(TRUE, &rcSource, &rcDest);
    }

    return fResult;
}

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

各言語での呼び出し定義

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

BOOL MagSetInputTransform(
    BOOL fEnabled,
    const RECT* pRectSource,
    const RECT* pRectDest
);

[return: MarshalAs(UnmanagedType.Bool)]
[DllImport("MAGNIFICATION.dll", SetLastError = true, ExactSpelling = true)]
static extern bool MagSetInputTransform(
    bool fEnabled,   // BOOL
    IntPtr pRectSource,   // RECT*
    IntPtr pRectDest   // RECT*
);

<DllImport("MAGNIFICATION.dll", SetLastError:=True, ExactSpelling:=True)>
Public Shared Function MagSetInputTransform(
    fEnabled As Boolean,   ' BOOL
    pRectSource As IntPtr,   ' RECT*
    pRectDest As IntPtr   ' RECT*
) As <MarshalAs(UnmanagedType.Bool)> Boolean
End Function

' fEnabled : BOOL
' pRectSource : RECT*
' pRectDest : RECT*
Declare PtrSafe Function MagSetInputTransform Lib "magnification" ( _
    ByVal fEnabled As Long, _
    ByVal pRectSource As LongPtr, _
    ByVal pRectDest As LongPtr) As Long
' VBA7前提(PtrSafe)。32bit Office では LongPtr→Long。Integer=16bit / Long=32bit / LongLong=64bit。

import ctypes
from ctypes import wintypes

MagSetInputTransform = ctypes.windll.magnification.MagSetInputTransform
MagSetInputTransform.restype = wintypes.BOOL
MagSetInputTransform.argtypes = [
    wintypes.BOOL,  # fEnabled : BOOL
    ctypes.c_void_p,  # pRectSource : RECT*
    ctypes.c_void_p,  # pRectDest : RECT*
]
# GetLastError: use ctypes.GetLastError() (or ctypes.WinDLL(use_last_error=True))

require 'fiddle'
require 'fiddle/import'

lib = Fiddle.dlopen('MAGNIFICATION.dll')
MagSetInputTransform = Fiddle::Function.new(
  lib['MagSetInputTransform'],
  [
    Fiddle::TYPE_INT,  # fEnabled : BOOL
    Fiddle::TYPE_VOIDP,  # pRectSource : RECT*
    Fiddle::TYPE_VOIDP,  # pRectDest : RECT*
  ],
  Fiddle::TYPE_INT)

#[link(name = "magnification")]
extern "system" {
    fn MagSetInputTransform(
        fEnabled: i32,  // BOOL
        pRectSource: *const RECT,  // RECT*
        pRectDest: *const RECT  // RECT*
    ) -> i32;
}
// crates: windows-sys provides ready-made bindings for this API.

$sig = @"
[return: MarshalAs(UnmanagedType.Bool)]
[DllImport("MAGNIFICATION.dll", SetLastError = true)]
public static extern bool MagSetInputTransform(bool fEnabled, IntPtr pRectSource, IntPtr pRectDest);
"@
$api = Add-Type -MemberDefinition $sig -Name 'MAGNIFICATION_MagSetInputTransform' -Namespace Win32 -PassThru
# $api::MagSetInputTransform(fEnabled, pRectSource, pRectDest)

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

出力引数:

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