AIT_VerifyKeyState

機能

キーの状態がキーボード上のキーの状態と同じ状態であるかを確認します。

形式

integer AIT_VerifyKeyState  (
 integer nVirtualKey,     // 仮想キー
 integer nKeyState        // キーの状態
);

引数

nVirtualKey(入力用)

確認するキー状態の仮想キーを指定してください。

次の値のどれかに該当する必要があります。

意味
NUMLOCK[Num Lock]キー
SCROLLLOCK[Scroll Lock]キー
CAPSLOCK[Caps Lock]キー

nKeyState(入力用)

確認するキーのオンまたはオフの状態を指定してください。次の値のどれかに該当する必要があります。

意味
KEYSTATE_OFFキーはオフ状態
KEYSTATE_ONキーはオン状態

戻り値

キーの状態が指定した状態と一致している場合の戻り値は1,一致していない場合の戻り値は0,失敗した場合の戻り値は-1となります。

関数が-1を返した場合には,AIT_GetLastErrorを使用して拡張エラーコードを取得できます。AIT_GetLastErrorが返す可能性のあるエラーコードを次に示します。

拡張エラー番号エラーコード
8ERROR_NOT_ENOUGH_MEMORY
14ERROR_OUTOFMEMORY
87ERROR_INVALID_PARAMETER
112ERROR_DISK_FULL
1400ERROR_INVALID_WINDOW_HANDLE
1460ERROR_TIMEOUT