KEYBDINPUT
構造体サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。
フィールド
| フィールド | 型 | サイズ | x64 | x86 | 説明 | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| wVk | VIRTUAL_KEY | 2 | +0 | +0 | 仮想キーコード。このコードは 1 から 254 の範囲の値でなければなりません。dwFlags メンバーが KEYEVENTF_UNICODE を指定している場合、wVk は 0 でなければなりません。 | ||||||||||
| wScan | WORD | 2 | +2 | +2 | キーのハードウェアスキャンコード。dwFlags が KEYEVENTF_UNICODE を指定している場合、wScan はフォアグラウンドアプリケーションに送信される Unicode 文字を指定します。 | ||||||||||
| dwFlags | KEYBD_EVENT_FLAGS | 4 | +4 | +4 | キーストロークのさまざまな側面を指定します。このメンバーには、次の値の特定の組み合わせを指定できます。
| ||||||||||
| time | DWORD | 4 | +8 | +8 | イベントのタイムスタンプ(ミリ秒単位)。このパラメーターが 0 の場合、システムが独自のタイムスタンプを提供します。 | ||||||||||
| dwExtraInfo | UINT_PTR | 8/4 | +16 | +12 | キーストロークに関連付けられた追加の値。この情報を取得するには、GetMessageExtraInfo 関数を使用します。 |
公式ドキュメント
シミュレートされたキーボードイベントに関する情報を格納します。
解説(Remarks)
INPUT_KEYBOARD は、KEYEVENTF_UNICODE フラグを使用することで、手書き認識や音声認識などのキーボード以外の入力方法を、テキスト入力であるかのようにサポートします。KEYEVENTF_UNICODE が指定されている場合、SendInput は wParam を VK_PACKET とした WM_KEYDOWN メッセージまたは WM_KEYUP メッセージを、フォアグラウンドスレッドのメッセージキューに送信します。GetMessage または PeekMessage がこのメッセージを取得した後、そのメッセージを TranslateMessage に渡すと、wScan で元々指定された Unicode 文字を含む WM_CHAR メッセージがポストされます。この Unicode 文字は、ANSI ウィンドウにポストされる場合、自動的に適切な ANSI 値に変換されます。
スキャンコードによってキーボード入力を定義するには、KEYEVENTF_SCANCODE フラグを設定します。これは、現在どのキーボードが使用されているかにかかわらず、物理的なキーストロークをシミュレートする場合に便利です。スキャンコードが拡張キーの場合は、KEYEVENTF_EXTENDEDKEY フラグを渡すこともできます。キーの仮想キー値は、現在のキーボードレイアウトや同時に押された他のキーによって変わることがありますが、スキャンコードは常に同じです。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
各言語での定義
#include <windows.h>
// KEYBDINPUT (x64 24 / x86 16 バイト)
typedef struct KEYBDINPUT {
VIRTUAL_KEY wVk;
WORD wScan;
KEYBD_EVENT_FLAGS dwFlags;
DWORD time;
UINT_PTR dwExtraInfo;
} KEYBDINPUT;using System;
using System.Runtime.InteropServices;
[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct KEYBDINPUT
{
public ushort wVk;
public ushort wScan;
public uint dwFlags;
public uint time;
public UIntPtr dwExtraInfo;
}Imports System.Runtime.InteropServices
<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure KEYBDINPUT
Public wVk As UShort
Public wScan As UShort
Public dwFlags As UInteger
Public time As UInteger
Public dwExtraInfo As UIntPtr
End Structureimport ctypes
from ctypes import wintypes
class KEYBDINPUT(ctypes.Structure):
_fields_ = [
("wVk", ctypes.c_ushort),
("wScan", ctypes.c_ushort),
("dwFlags", wintypes.DWORD),
("time", wintypes.DWORD),
("dwExtraInfo", ctypes.c_size_t),
]#[repr(C)]
pub struct KEYBDINPUT {
pub wVk: u16,
pub wScan: u16,
pub dwFlags: u32,
pub time: u32,
pub dwExtraInfo: usize,
}import "golang.org/x/sys/windows"
type KEYBDINPUT struct {
wVk uint16
wScan uint16
dwFlags uint32
time uint32
dwExtraInfo uintptr
}type
KEYBDINPUT = record
wVk: Word;
wScan: Word;
dwFlags: DWORD;
time: DWORD;
dwExtraInfo: NativeUInt;
end;const KEYBDINPUT = extern struct {
wVk: u16,
wScan: u16,
dwFlags: u32,
time: u32,
dwExtraInfo: usize,
};type
KEYBDINPUT {.bycopy.} = object
wVk: uint16
wScan: uint16
dwFlags: uint32
time: uint32
dwExtraInfo: uintstruct KEYBDINPUT
{
ushort wVk;
ushort wScan;
uint dwFlags;
uint time;
size_t dwExtraInfo;
}HSP用 定義
HSP3.7/3.8 は構造体機能が無いため4byte整数配列(dim)+peek/poke で操作(32/64bitでサイズ・位置が異なる場合はタブで分割)。IronHSP は NSTRUCT(#defstruct/stdim/->)で32/64bit共通。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; KEYBDINPUT サイズ: 16 バイト(x86)
dim st, 4 ; 4byte整数×4(構造体サイズ 16 / 4 切り上げ)
; wVk : VIRTUAL_KEY (+0, 2byte) wpoke st,0,値 / 値 = wpeek(st,0)
; wScan : WORD (+2, 2byte) wpoke st,2,値 / 値 = wpeek(st,2)
; dwFlags : KEYBD_EVENT_FLAGS (+4, 4byte) st.1 = 値 / 値 = st.1 (lpoke/lpeek も可)
; time : DWORD (+8, 4byte) st.2 = 値 / 値 = st.2 (lpoke/lpeek も可)
; dwExtraInfo : UINT_PTR (+12, 4byte) st.3 = 値 / 値 = st.3 (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; KEYBDINPUT サイズ: 24 バイト(x64)
dim st, 6 ; 4byte整数×6(構造体サイズ 24 / 4 切り上げ)
; wVk : VIRTUAL_KEY (+0, 2byte) wpoke st,0,値 / 値 = wpeek(st,0)
; wScan : WORD (+2, 2byte) wpoke st,2,値 / 値 = wpeek(st,2)
; dwFlags : KEYBD_EVENT_FLAGS (+4, 4byte) st.1 = 値 / 値 = st.1 (lpoke/lpeek も可)
; time : DWORD (+8, 4byte) st.2 = 値 / 値 = st.2 (lpoke/lpeek も可)
; dwExtraInfo : UINT_PTR (+16, 8byte) qpoke st,16,値 / qpeek(st,16) ※IronHSPのみ。3.7/3.8は lpoke st,16,下位 : lpoke st,20,上位
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global KEYBDINPUT
#field short wVk
#field short wScan
#field int dwFlags
#field int time
#field intptr dwExtraInfo
#endstruct
stdim st, KEYBDINPUT ; NSTRUCT 変数を確保
st->wVk = 100
mes "wVk=" + st->wVk