キーボードAPI関数

Size: px

Start display at page:

Download "キーボードAPI関数"

いおりことじ
5 years ago
Views:

1 キー入力処理 GetKeyState と GetAsyncKeyState 判定するキーが多い場合は GetKeyboardState 関数で一気に状態を取得して其れ程多くない場合は GetKeyState 関数か GetAsyncKeyState 関数を使用して個別にキーの状態を取得するのが一般的で有る GetKeyState 関数と GetAsyncKeyState 関数の区別はキーが押されて直ぐに反映されるのが後者で ( 詰まりキーが押されて発生するハードウェア割り込みに対応する ) リアルタイム性を重視するなら此方を使用する事に成る GetKeyState 関数はメッセージキューに溜められたデータを観る様なので何かの処理中にキーが押されても GetKeyState 関数は反映されない猶 GetAsyncKeyState 関数と GetKeyState 関数の孰れが速いかを調べる為に夫々れ回実行した処下記の結果を得た ( 勿論環境に依り値は変わる ) GetAsyncKeyState 関数 :31ms GetKeyState 関数 :47ms 矢張りリアルタイム性重視なら GetAsyncKeyState 関数を使う可きだろう因みに GetKeyboardState 関数は 281ms で有った GetAsyncKeyState 関数呼出時にキーが押されて居るか何うか亦前回の GetAsyncKeyState 関数呼出以降にキーが押されたか何うかを判定する関数定義 Visual Basic 6.0 Declare Function GetAsyncKeyState Lib "user32.dll" (ByVal vkey As Long) As Long Visual Basic 2005 Declare Function GetAsyncKeyState lib "user32.dll" (ByVal vkey As Integer) As Integer Private Declare Function GetAsyncKeyState Lib "user32" Alias "GetAsyncKeyState" ( _ ByVal vkey As Keys ) As Short <DllImport("user32")> Shared Function GetAsyncKeyState( _ <[In]( )> ByVal vkey As VirtualKeyCodes) As Short End Function C# using System.Runtime.InteropServices; [DllImport("user32")] static extern short GetAsyncKeyState(Keys vkey); C/C++ SHORT GetAsyncKeyState( int vkey // 仮想キーコード ); -1-

2 パラメータ vkey: 最大 256 通りの仮想キーコードの孰れかを指定する GetAsyncKeyState 関数は 32 ビットの引数を取る Visual Basic 2005 や Visual C# 2005 では此の引数に Keys 列挙体を利用する事が出来る戻り値関数が成功すると前回の GetAsyncKeyState 関数呼出以降にキーが押されたか何うか及びキーが現在押されて居るか何うかを示す値が返る下位 2 バイトの最上位ビットがセットされた時現在其のキーが押されて居る事を示し最下位ビットがセットされた時前回の GetAsyncKeyState 関数呼出以降に其のキーが押された事を示す他のスレッド ( 又はプロセス ) のウィンドウがキーボードフォーカスを備えて居る場合は 0 が返るスキャンする仮想キーコード通常のキーボードに配置されて居るキーが対象と成る解説 GetAsyncKeyState 関数はマウスボタンの状態も取得出来る但し此の関数は物理的なボタンのマップ先で有る論理的なマウスボタンの状態では無く物理的なマウスボタンの状態を取得する例えば GetAsyncKeyState(VK_LBUTTON) を呼び出すと其のボタンが論理的な左ボタンと右ボタンの孰れに割り当てられて居るかに関り無く ( 後者は左利き用の割り当て ) 常に物理的な左ボタンの状態を返す物理的なマウスボタンと論理的なマウスボタンの対応を調べるには次の呼出を行う GetSystemMetrics(SM_SWAPBUTTON) 上記の呼出はマウスボタンの左右が入れ替わって居る時に TRUE を返す vkey パラメータの値と仕て VK_SHIFT VK_CONTROL VK_MENU の各仮想キーコード定数を指定出来る此の場合左右を区別する事無く Shift Ctrl Alt の各キーの状態を取得出来る使用例 GetAsyncKeyState 関数の使用は簡単で例えば下記のコードはエンドユーザーが Ctrl+A キーの組み合わせでタイプしたか何うかを調査して居る Visual Basic 2005 If GetAsyncKeyState(Keys.A) < 0 And GetAsyncKeyState(Keys.ControlKey) < 0 Then ' Ctrl+A キーが押された End If C# if ( GetAsyncKeyState(Keys.A) < 0 && GetAsyncKeyState(Keys.ControlKey) < 0 ) { // Ctrl+A キーが押された } -2-

3 上記コードを Interval プロパティの値を充分に小さくした ( 例えば 200 ミリ秒 )Timer コントロールの Tick イベントで動かせば調べ度い総てのホットキーをトラップ出来る様に成る併し此の方法では Timer コントロールのインターバル間隔が短いとアプリケーションにより多くのオーバーヘッドを加えて了う事に成り更に GetAsyncKeyState のドキュメントに依れば Windows NT 2000 XP の時にカレントデスクトップがアクティブなデスクトップでは無い場合やデスクトップの設定に依りエンドユーザーが押したキーがバックグラウンドアプリケーションに知られない様に保護されて居てアプリケーションがフォアグラウンド状態で無い場合には 0 を返す可能性が有ると記述されて居る此の様な場合オーバーヘッドを回避する為 RegisterHotKey 関数を使用してグローバルなホットキーを登録する方法を取ると良い RegisterHotKey 関数の宣言は下記の通りで有る Visual Basic 2005 Declare Function RegisterHotKey Lib "user32" ( _ ByVal hwnd As IntPtr, _ ByVal id As Integer, _ ByVal fsmodifiers As Integer, _ ByVal vk As Keys _ ) As Integer C# [DllImport("user32")] static extern int RegisterHotKey( IntPtr hwnd, int id, int fsmodifiers, Keys vk); hwnd は最後の 2 個の引数に依って指定されたホットキーがエンドユーザーに依って押された時 WM_HOTKEY メッセージを受け取るウィンドウのハンドルで有る引数 id はホットキーを区別する識別子で有りシステムに登録された夫々れのグローバルキーと違った物でなければ成らないアプリケーションがシャットダウンする時には登録したグローバルホットキー情報を解除する為 UnregisterHotKey 関数を呼び出す必要が有るアプリケーションのメインフォームが読み込まれた場合にホットキーを登録しサブクラスでホットキーをトラップしフォームが閉じられた際にホットキーを解放するプログラムは下記のリストの様に成るクラスの夫々れのインスタンスに唯一無二の ID を作成するにはマイクロソフトのドキュメントで推奨されて居る様に GlobalAddAtom 関数を用いる幾つかの API を呼び亦フォームの WndProc メソッドをオーバーライドする事で入力フォーカスを有して居ない時にエンドユーザーが与えられたキーの組み合わせの通知を受けられる様にするには以下のコードを Windows フォームクラスに追加する -3-

4 Visual Basic 2005 ' Windows API functions and constants Private Declare Function RegisterHotKey Lib "user32" ( _ ByVal hwnd As IntPtr, _ ByVal id As Integer, _ ByVal fsmodifiers As Integer, _ ByVal vk As Keys _ ) As Integer Private Declare Function UnregisterHotKey Lib "user32" ( _ ByVal hwnd As IntPtr, _ ByVal id As Integer _ ) As Integer Private Declare Function GlobalAddAtom Lib "kernel32" Alias "GlobalAddAtomA" ( _ ByVal lpstring As String _ ) As Short Private Declare Function GlobalDeleteAtom Lib "kernel32" ( _ ByVal natom As Short _ ) As Short Private Const MOD_ALT As Integer = &H1 Private Const MOD_CONTROL As Integer = &H2 Private Const MOD_SHIFT As Integer = &H4 Private Const MOD_WIN As Integer = &H8 Private Const WM_HOTKEY As Integer = &H312 Private hotkeyid As Short Sub Form1_Load(ByVal sender As Object, ByVal e As System.EventArgs) _ Handles MyBase.Load ' ホットキーのために唯一無二の ID を生成する hotkeyid = GlobalAddAtom("GlobalHotKey " & Me.GetHashCode( ).ToString( )) ' Ctrl+A キーを登録する RegisterHotKey(Me.Handle, hotkeyid, MOD_CONTROL, Keys.A) End Sub Sub Form1_Closing(ByVal sender As Object, _ ByVal e As System.ComponentModel.CancelEventArgs) Handles MyBase.Closing ' ホットキーの登録を解除しアトムを削除する UnregisterHotKey(Me.Handle, hotkeyid) GlobalDeleteAtom(hotkeyID) End Sub Protected Overrides Sub WndProc( ByRef m As Message) MyBase.WndProc(m) If m.msg = WM_HOTKEY Then ' ホットキーが押されたときの処理 Debug.WriteLine("WndProc: CTRL+A") End If End Sub -4-

5 C# // Windows API functions and constants [DllImport("user32")] static extern int RegisterHotKey(IntPtr hwnd, int id, int fsmodifiers, Keys vk) ; [DllImport("user32")] static extern int UnregisterHotKey(IntPtr hwnd, int id); [DllImport("kernel32", EntryPoint="GlobalAddAtomA")] static extern short GlobalAddAtom(string lpstring); [DllImport("kernel32")] static extern short GlobalDeleteAtom (short natom); private const int MOD_ALT = 0x01; private const int MOD_CONTROL = 0x02; private const int MOD_SHIFT = 0x04; private const int MOD_WIN = 0x08; private const int WM_HOTKEY = 0x312; short hotkeyid; void Form1_Load(object sender, EventArgs e) { // ホットキーのために唯一無二の ID を生成する hotkeyid = GlobalAddAtom("GlobalHotKey " + this.gethashcode().tostring()); // Ctrl+A キーを登録する RegisterHotKey(this.Handle, hotkeyid, MOD_CONTROL, Keys.A); } void Form1_Closing(object sender, System.ComponentModel.CancelEventArgs e) { // ホットキーの登録を解除しアトムを削除する UnregisterHotKey(this.Handle, hotkeyid); GlobalDeleteAtom(hotkeyID); } protected override void WndProc(ref Message m) { base.wndproc(ref m); if ( m.msg == WM_HOTKEY ) { // ホットキーが押されたときの処理 Debug.WriteLine("Ctrl+A"); } } 猶上記のリストに示したコードにはフォームのクラス内部から呼び出された場合而巳の動作と謂う制限が有る -5-

6 GetKeyState 指定された仮想キーの状態を取得する状態とはキーが押されて居るか押されて居ないかトグルに成って居るか何うか ( オンとオフの 2 つが有りキーを押す度に入れ替わる ) を表す関数定義 Visual Basic Private Declare Function GetKeyState Lib "user32" (ByVal nvirtkey As Integer) As Short C/C++ C# SHORT GetKeyState( int nvirtkey // 仮想キーコード ); パラメータ nvirtkey: 仮想キーコードを指定する希望の仮想キーが文字キーか数字キー (A~Z a~z 0~9) で有る場合 nvirtkey に其の文字の ASCII コードを指定し他のキーの場合は仮想キーコードを指定する欧州等の英語以外のキーボードレイアウトを使用して居る場合 A~Z と 0~9 の各範囲に相当する ASCII コードはアクセント付きを含め殆どの文字を表す為に使われて居る例えば独語のキーボードレイアウトでは ASCII の O ( 0x4F) の値に相当する仮想キーは o キーを意味するが VK_OEM_1 はウムラウト ( ) 付きの o キーを意味する戻り値戻り値は指定された仮想キーの状態を表す最上位ビットが 1 の時はキーが押されて居る事を 0 の時はキーが押されて居ない事を示す最下位ビットが 1 の時はキーがトグル状態に有る事を示す例えば CapsLock キーが ON に成って居る時はトグル状態に成る最下位ビットが 0 の時はキーが OFF に成って居てトグルが解除されて居る事を示すキーボードにトグルキーのインジケータランプが用意されて居る場合キーがトグル状態に成って居るとランプは点灯しトグル解除状態ではランプは消灯する解説スレッドがメッセージキューからキーメッセージを読み出す度に此の関数が返すキーの状態は変化するキーの状態はハードウェアに依る割り込みレベルの状態を反映しない割り込みレベルの情報を取得するには GetAsyncKeyState 関数を使用するアプリケーションはキーボード入力メッセージに応じて GetKeyState を呼び出す此の関数は入力メッセージが生成された時のキーの状態を取得する総ての仮想キーの状態を取得するには GetKeyboardState 関数を使用する -6-

7 アプリケーションは nvirtkey パラメータの値と仕て VK_SHIFT VK_CONTROL VK_MENU の各仮想キーコード定数を使用する事が出来る此の場合左右を区別する事無く Shift Ctrl Alt の各キーの状態を取得出来る亦アプリケーションは nvirtkey の値と仕て次の仮想キーコード定数を使う事に依り此等のキーの左右を区別する事が出来る VK_LSHIFT VK_RSHIFT VK_LCONTROL VK_RCONTROL VK_LMENU VK_RMENU GetKeyboardState 256 個の仮想キーの状態を指定されたバッファへコピーする関数定義 Visual Basic Declare Function GetKeyboardState lib "user32.dll" _ (ByRef pbkeystate As Byte) As Integer C/C++ C# BOOL GetKeyboardState( PBYTE lpkeystate // 状態データの配列 ); パラメータ lpkeystate: 総ての仮想キーの状態を保持する 256 バイトの配列へのポインタを指定する戻り値関数が成功すると 0 以外の値が返る関数が失敗すると 0 が返る解説アプリケーションは此の関数を呼び出して総ての仮想キーの現在の状態を一度に取得出来るスレッドがメッセージキューからキーボードメッセージを削除すると仮想キーの状態が変化するキーボードメッセージがスレッドのメッセージキューにポストされたり他のスレッドのメッセージキューへのキーボードメッセージのポストや削除が発生しても状態は変化しない此の関数から制御が返ると lpkeystate パラメータが指す配列の各メンバは各仮想キーの状態データを保持する最上位ビットが 1 の時はキーが押されて居る事を 0 の時はキーが押されて居ない事を示す最下位ビットが 1 の時はキーがトグル状態に有る事を 0 の時はトグルが解除されて居る事を示す例えば CapsLock キーが ON に成って居る時はトグル状態に成る最下位ビットが 0 に成って居る場合キーは OFF でトグルが解除されて居る事を意味するキーボードにトグルキーのインジケータランプが用意されて居る場合キーがトグル状態に成って居るとランプは点灯しトグル解除状態ではランプは消灯する -7-

8 個別のキーに関する状態情報を取得するには GetKeyState 関数を使用する対応するキーボードメッセージがメッセージキューから取得されたか何うかに関り無く個別のキーの現在の状態を取得するには GetAsyncKeyState 関数を使用するアプリケーションは lpkeystate パラメータが指す配列へのインデックスと仕て VK_SHIFT VK_CONTROL VK_MENU の各仮想キーコード定数を使用する事が出来る此の場合左右を区別する事無く Shift Ctrl Alt の各キーの状態を取得出来る亦アプリケーションはインデックスと仕て次の仮想キーコード定数を使う事に依り此等のキーの左右を区別出来る VK_LSHIFT VK_RSHIFT VK_LCONTROL VK_RCONTROL VK_LMENU VK_RMENU 使用法 Visual Basic 2005 ' API 関数の宣言 Declare Function GetKeyboardState Lib "user32" (ByRef pbkeystate As Byte) As Integer ' API 関数の呼出 Dim keys(255) as Byte Call GetKeyboardState(keys(0)) 参考従来の N88BASIC の INP 関数に依るキースキャンが此の方式で有る INP 関数の引数に E0H~ECH のポート番号を指定して呼び出し押されて居るキーを取得する戻り値は 1 バイトのデータで各ビットのデータがキーの押し下げに対応する即ち押し下げられて居るキーに対応するビットが 0 押し下げられて居ないキーに対応するビットが 1 に成る ( 従って何もキーが押されて居ない状態では FFH が返される ) アドレスパス ( ポート番号 ) とデータパスの対応を下記に示す猶 D0 が最下位ビット D7 が最上位ビットで有る D7 D6 D5 D4 D3 D2 D1 D0 E E1 Return., = + * 9 8 E2 G F E D C B E3 O N M L K J I H E4 W V U T S R Q P E5 = ^ } \ } Z Y X E6 ' & % $ # "! 0 E7 _? > < + * ) ( E8 Ctrl Shift カナ Grph Del Home E9 Esc Space F5 F4 F3 F2 F1 Stop EA Caps / - Copy Help Tab EB RollDn RollUp EC Ins F10 F9 F8 F7 F6 Xfer Back -8-

9 例えば INP( &HE8) と仕た時キーが押されて居れば戻り値は B(FBH) と成り Shift キーが併用されて居れば戻り値は B(BBH) と成る此れはリアルタイム入力を取得する方法と仕て良く用いられた方法で有るので昔のゲーム等をリメイクする場合には参考に成ると思うキーコード定数の定義 Private Const VK_LBUTTON = &H1 ' マウス左ボタン Private Const VK_RBUTTON = &H2 ' マウス右ボタン Private Const VK_CANCEL = &H3 '[Cancel] Private Const VK_MBUTTON = &H4 ' マウスの中央ボタン Private Const VK_BACK = &H8 '[Back Space] Private Const VK_TAB = &H9 '[TAB] Private Const VK_CLEAR = &HC '[Clear] Private Const VK_RETURN = &HD '[Enter] Private Const VK_SHIFT = &H10 '[Shift] Private Const VK_RSHIFT = &HA1 '[ 右 Shift] Private Const VK_CONTROL = &H11 '[Control] Private Const VK_RCONTROL = &HA3 '[ 右 Control] Private Const VK_MENU = &H12 '[Menu] Private Const VK_RMENU = &HA5 '[ 右 Menu] Private Const VK_PAUSE = &H13 '[Pause] Private Const VK_CAPITAL = &H14 '[Caps Lock] Private Const VK_ESCAPE = &H1B '[Esc] Private Const VK_SPACE = &H20 '[Space] Private Const VK_PRIOR = &H21 '[Page Up] Private Const VK_NEXT = &H22 '[Page Down] Private Const VK_END = &H23 '[End] Private Const VK_HOME = &H24 '[Home] Private Const VK_LEFT = &H25 '[ ] Private Const VK_UP = &H26 '[ ] Private Const VK_RIGHT = &H27 '[ ] Private Const VK_DOWN = &H28 '[ ] Private Const VK_SELECT = &H29 '[Select] Private Const VK_PRINT = &H2A '[Print Screen] Private Const VK_EXECUTE = &H2B '[Execute] Private Const VK_SNAPSHOT = &H2C '[Snap Shot] Private Const VK_INSERT = &H2D '[Insert] Private Const VK_DELETE = &H2E '[Delete] Private Const VK_HELP = &H2F '[Help] Private Const VK_NUMPAD0 = &H60 ' テンキーの [0] Private Const VK_NUMPAD1 = &H61 ' テンキーの [1] Private Const VK_NUMPAD2 = &H62 ' テンキーの [2] Private Const VK_NUMPAD3 = &H63 ' テンキーの [3] Private Const VK_NUMPAD4 = &H64 ' テンキーの [4] Private Const VK_NUMPAD5 = &H65 ' テンキーの [5] Private Const VK_NUMPAD6 = &H66 ' テンキーの [6] Private Const VK_NUMPAD7 = &H67 ' テンキーの [7] Private Const VK_NUMPAD8 = &H68 ' テンキーの [8] Private Const VK_NUMPAD9 = &H69 ' テンキーの [9] Private Const VK_MULTIPLY = &H6A ' テンキーの [*] -9-

10 Private Const VK_ADD = &H6B ' テンキーの [+] Private Const VK_SEPARATOR = &H6C ' テンキーの [Enter] Private Const VK_SUBTRACT = &H6D ' テンキーの [-] Private Const VK_DECIMAL = &H6E ' テンキーの [.] Private Const VK_DIVIDE = &H6F ' テンキーの [/] Private Const VK_F1 = &H70 '[F1] Private Const VK_F2 = &H71 '[F2] Private Const VK_F3 = &H72 '[F3] Private Const VK_F4 = &H73 '[F4] Private Const VK_F5 = &H74 '[F5] Private Const VK_F6 = &H75 '[F6] Private Const VK_F7 = &H76 '[F7] Private Const VK_F8 = &H77 '[F8] Private Const VK_F9 = &H78 '[F9] Private Const VK_F10 = &H79 '[F10] Private Const VK_F11 = &H7A '[F11] Private Const VK_F12 = &H7B '[F12] Private Const VK_F13 = &H7C '[F13] Private Const VK_F14 = &H7D '[F14] Private Const VK_F15 = &H7E '[F15] Private Const VK_F16 = &H7F '[F16] Private Const VK_F17 = &H80 '[F17] Private Const VK_F18 = &H81 '[F18] Private Const VK_F19 = &H82 '[F19] Private Const VK_F20 = &H83 '[F20] Private Const VK_F21 = &H84 '[F21] Private Const VK_F22 = &H85 '[F22] Private Const VK_F23 = &H86 '[F23] Private Const VK_F24 = &H87 '[F24] Private Const VK_NUMLOCK = &H90 '[Num Lock] -10-

プロセス間通信

プロセス間通信プロセス間通信 (SendMessage) プロセス間通信とは同一コンピューター上で起動して居るアプリケーション間でデータを受け渡し度い事は時々有る Framework にはリモート処理と謂う方法でデータの受け渡しを行なう方法が有る此処では此の方法では無く従来の方法の API を使用したプロセス間通信を紹介する此の方法は送信側は API の SendMessage で送り