Win32 API 日本語リファレンス
ホーム › UI.Accessibility › MOUSEKEYS

MOUSEKEYS

構造体
📘 Microsoft Learn (日本語) · English
サイズx64: 28 バイト / x86: 28 バイト

サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。

フィールド

フィールド型サイズx64x86説明
cbSizeDWORD4+0+0この構造体のサイズをバイト単位で指定します。
dwFlagsDWORD4+4+4

FilterKeys 機能のプロパティを指定するビットフラグのセットです。次のビットフラグ値が定義されています。

値 意味
MKF_AVAILABLE
0x00000002
 このフラグが設定されている場合、MouseKeys 機能が利用可能です。
MKF_CONFIRMHOTKEY
0x00000008
 Windows 95/98, Windows 2000: ホットキーを使用して MouseKeys 機能を有効にすると、確認ダイアログボックスが表示されます。
MKF_HOTKEYACTIVE
0x00000004
 このフラグが設定されている場合、ユーザーはホットキー (LEFT ALT+LEFT SHIFT+NUM LOCK) を使用して MouseKeys 機能のオンとオフを切り替えられます。
MKF_HOTKEYSOUND
0x00000010
 このフラグが設定されている場合、ユーザーがホットキーを使用して MouseKeys 機能のオンとオフを切り替えると、システムはサイレン音を鳴らします。
MKF_INDICATOR
0x00000020
 Windows 95/98, Windows 2000: MouseKeys 機能がオンのときに、視覚的なインジケーターが表示されます。
MKF_LEFTBUTTONDOWN
0x01000000
 Windows 95/98, Windows 2000: 左ボタンが「押されている」状態です。
MKF_LEFTBUTTONSEL
0x10000000
 Windows 95/98, Windows 2000: ユーザーがマウスボタン操作の対象として左ボタンを選択しています。
MKF_MODIFIERS
0x00000040
 Windows 95/98, Windows 2000: CTRL キーは iCtrlSpeed メンバーで指定された値の分だけカーソル速度を上げ、SHIFT キーはカーソルが 1 ピクセル移動した後に短い遅延を発生させて、カーソルの細かな位置合わせを可能にします。この値が指定されていない場合、ユーザーが方向キーでマウスカーソルを移動する間、CTRL キーと SHIFT キーは無視されます。
MKF_MOUSEKEYSON
0x00000001
 このフラグが設定されている場合、MouseKeys 機能はオンです。
MKF_MOUSEMODE
0x80000000
 Windows 95/98, Windows 2000: システムはテンキーの入力をマウスコマンドとして処理しています。
MKF_REPLACENUMBERS
0x00000080
 Windows 95/98, Windows 2000: NUM LOCK キーがオンのときに、テンキーでマウスを移動します。このフラグが指定されていない場合、NUM LOCK キーがオフのときにテンキーでマウスカーソルを移動します。
MKF_RIGHTBUTTONDOWN
0x02000000
 Windows 95/98, Windows 2000: 右ボタンが「押されている」状態です。
MKF_RIGHTBUTTONSEL
0x20000000
 Windows 95/98, Windows 2000: ユーザーがマウスボタン操作の対象として右ボタンを選択しています。
iMaxSpeedDWORD4+8+8

方向キーを押し続けたときにマウスカーソルが到達する最高速度を指定します。

Windows 95/98: 範囲チェックは行われません。

Windows NT/2000: 有効な値は 10 から 360 です。

iTimeToMaxSpeedDWORD4+12+12方向キーを押し続けたときに、マウスカーソルが最高速度に達するまでの時間をミリ秒単位で指定します。有効な値は 1000 から 5000 です。
iCtrlSpeedDWORD4+16+16方向キーでカーソルを移動する際にユーザーが CTRL キーを押し続けているときに、マウスカーソルの速度へ適用する倍率を指定します。MKF_MODIFIERS が設定されていない場合、この値は無視されます。
dwReserved1DWORD4+20+20このメンバーは将来の使用のために予約済みです。0 に設定しなければなりません。
dwReserved2DWORD4+24+24このメンバーは将来の使用のために予約済みです。0 に設定しなければなりません。

公式ドキュメント

MouseKeys ユーザー補助機能に関する情報を格納します。MouseKeys 機能が有効なとき、ユーザーはテンキーを使用してマウスポインターを操作し、クリック、ダブルクリック、ドラッグ、ドロップを行えます。NUMLOCK を押すことで、テンキーをマウス操作モードと通常操作との間で切り替えられます。

解説(Remarks)

アプリケーションは、uiAction パラメーターに SPI_GETMOUSEKEYS または SPI_SETMOUSEKEYS の値を設定して SystemParametersInfo 関数を呼び出すときに、MOUSEKEYS 構造体を使用します。SPI_GETMOUSEKEYS を使用する場合、アプリケーションは MOUSEKEYS 構造体の cbSize メンバーを指定しなければなりません。残りのメンバーは SystemParametersInfo 関数が設定します。SPI_SETMOUSEKEYS の値を使用する場合、アプリケーションはすべての構造体メンバーを指定しなければなりません。

SPI_SETMOUSEKEYS の値を指定して SystemParametersInfo を呼び出した場合、次のフラグは無視されます。

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

各言語での定義

#include <windows.h>

// MOUSEKEYS  (x64 28 / x86 28 バイト)
typedef struct MOUSEKEYS {
    DWORD cbSize;
    DWORD dwFlags;
    DWORD iMaxSpeed;
    DWORD iTimeToMaxSpeed;
    DWORD iCtrlSpeed;
    DWORD dwReserved1;
    DWORD dwReserved2;
} MOUSEKEYS;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct MOUSEKEYS
{
    public uint cbSize;
    public uint dwFlags;
    public uint iMaxSpeed;
    public uint iTimeToMaxSpeed;
    public uint iCtrlSpeed;
    public uint dwReserved1;
    public uint dwReserved2;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure MOUSEKEYS
    Public cbSize As UInteger
    Public dwFlags As UInteger
    Public iMaxSpeed As UInteger
    Public iTimeToMaxSpeed As UInteger
    Public iCtrlSpeed As UInteger
    Public dwReserved1 As UInteger
    Public dwReserved2 As UInteger
End Structure
import ctypes
from ctypes import wintypes

class MOUSEKEYS(ctypes.Structure):
    _fields_ = [
        ("cbSize", wintypes.DWORD),
        ("dwFlags", wintypes.DWORD),
        ("iMaxSpeed", wintypes.DWORD),
        ("iTimeToMaxSpeed", wintypes.DWORD),
        ("iCtrlSpeed", wintypes.DWORD),
        ("dwReserved1", wintypes.DWORD),
        ("dwReserved2", wintypes.DWORD),
    ]
#[repr(C)]
pub struct MOUSEKEYS {
    pub cbSize: u32,
    pub dwFlags: u32,
    pub iMaxSpeed: u32,
    pub iTimeToMaxSpeed: u32,
    pub iCtrlSpeed: u32,
    pub dwReserved1: u32,
    pub dwReserved2: u32,
}
import "golang.org/x/sys/windows"

type MOUSEKEYS struct {
	cbSize uint32
	dwFlags uint32
	iMaxSpeed uint32
	iTimeToMaxSpeed uint32
	iCtrlSpeed uint32
	dwReserved1 uint32
	dwReserved2 uint32
}
type
  MOUSEKEYS = record
    cbSize: DWORD;
    dwFlags: DWORD;
    iMaxSpeed: DWORD;
    iTimeToMaxSpeed: DWORD;
    iCtrlSpeed: DWORD;
    dwReserved1: DWORD;
    dwReserved2: DWORD;
  end;
const MOUSEKEYS = extern struct {
    cbSize: u32,
    dwFlags: u32,
    iMaxSpeed: u32,
    iTimeToMaxSpeed: u32,
    iCtrlSpeed: u32,
    dwReserved1: u32,
    dwReserved2: u32,
};
type
  MOUSEKEYS {.bycopy.} = object
    cbSize: uint32
    dwFlags: uint32
    iMaxSpeed: uint32
    iTimeToMaxSpeed: uint32
    iCtrlSpeed: uint32
    dwReserved1: uint32
    dwReserved2: uint32
struct MOUSEKEYS
{
    uint cbSize;
    uint dwFlags;
    uint iMaxSpeed;
    uint iTimeToMaxSpeed;
    uint iCtrlSpeed;
    uint dwReserved1;
    uint dwReserved2;
}

HSP用 定義

HSP3.7/3.8 は構造体機能が無いため4byte整数配列(dim)+peek/poke で操作(32/64bitでサイズ・位置が異なる場合はタブで分割)。IronHSP は NSTRUCT(#defstruct/stdim/->)で32/64bit共通。

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; MOUSEKEYS サイズ: 28 バイト(x64)
dim st, 7    ; 4byte整数×7(構造体サイズ 28 / 4 切り上げ)
; cbSize : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; dwFlags : DWORD (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; iMaxSpeed : DWORD (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; iTimeToMaxSpeed : DWORD (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; iCtrlSpeed : DWORD (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; dwReserved1 : DWORD (+20, 4byte)  st.5 = 値  /  値 = st.5   (lpoke/lpeek も可)
; dwReserved2 : DWORD (+24, 4byte)  st.6 = 値  /  値 = st.6   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global MOUSEKEYS
    #field int cbSize
    #field int dwFlags
    #field int iMaxSpeed
    #field int iTimeToMaxSpeed
    #field int iCtrlSpeed
    #field int dwReserved1
    #field int dwReserved2
#endstruct

stdim st, MOUSEKEYS        ; NSTRUCT 変数を確保
st->cbSize = 100
mes "cbSize=" + st->cbSize