キーボード入力の概要

アプリケーションでは、キーボードとマウスからのユーザー入力を受け入れる必要があります。 アプリケーションは、ウィンドウに投稿されたメッセージの形式でキーボード入力を受け取ります。

キーボード入力モデル

システムは、現在のキーボードに適したキーボード デバイス ドライバーをインストールすることで、アプリケーションのデバイスに依存しないキーボード サポートを提供します。 システムは、ユーザーまたはアプリケーションによって現在選択されている言語固有のキーボード レイアウトを使用して、言語に依存しないキーボード サポートを提供します。 キーボード デバイス ドライバーは、キーボードからスキャン コードを受け取り、キーボード レイアウトに送信され、メッセージに変換され、アプリケーション内の適切なウィンドウに投稿されます。

キーボードの各キーに割り当てられるのは、 スキャン コードと呼ばれる一意の値であり、キーボードのキーのデバイスに依存する識別子です。 キーボードは、ユーザーがキーを入力すると 2 つのスキャン コードを生成します。1 つはユーザーがキーを押したときと、ユーザーがキーを離したときです。

キーボード デバイス ドライバーは、スキャン コードを解釈し、それを 仮想キー コード (キーの目的を識別するシステムによって定義されるデバイスに依存しない値) に変換 (マップ) します。 スキャン コードを変換すると、キーボード レイアウトによって、スキャン コード、仮想キー コード、キーストロークに関するその他の情報を含むメッセージが作成され、メッセージがシステム メッセージ キューに配置されます。 システムは、システム・メッセージ待ち行列からメッセージを除去し、それを適切なスレッドのメッセージ待ち行列にポストします。 最終的に、スレッドのメッセージ ループはメッセージを削除し、処理のために適切なウィンドウ プロシージャに渡します。 次の図は、キーボード入力モデルを示しています。

キーボード フォーカスとアクティブ化

システムは、キーボード フォーカスを使用してウィンドウを作成したフォアグラウンド スレッドのメッセージ キューにキーボード メッセージをポストします。 キーボード フォーカスは、ウィンドウの一時的なプロパティです。 システムは、キーボードフォーカスをユーザーの方向に、あるウィンドウから別のウィンドウにシフトすることで、ディスプレイ上のすべてのウィンドウ間でキーボードを共有します。 キーボード フォーカスがあるウィンドウは、フォーカスが別のウィンドウに変わるまで、すべてのキーボード メッセージを (作成したスレッドのメッセージ キューから) 受け取ります。

スレッドは GetFocus 関数を呼び出して、現在キーボード フォーカスを持っているウィンドウ (存在する場合) を決定できます。 スレッドは 、SetFocus 関数を呼び出すことによって、いずれかのウィンドウにキーボード フォーカスを与えることができます。 キーボードフォーカスがウィンドウ間で変化すると、システムはフォーカスを失ったウィンドウに WM_KILLFOCUS メッセージを送信し、フォーカスを取得したウィンドウに WM_SETFOCUS メッセージを送信します。

キーボード フォーカスの概念は、アクティブ ウィンドウの概念に関連しています。 アクティブ ウィンドウは、ユーザーが現在操作している最上位のウィンドウです。 キーボード フォーカスがあるウィンドウは、アクティブウィンドウまたはアクティブウィンドウの子ウィンドウです。 ユーザーがアクティブウィンドウを識別しやすくするために、システムはそれをZオーダーの一番上に配置し、タイトルバー(ある場合)と境界線を強調表示します。

ユーザーは、トップレベル ウィンドウをクリックするか、 Alt + Tab キーまたは Alt +Esc キーの組み合わせを使用して選択するか、タスク リストから選択することでアクティブ化できます。 スレッドは 、SetActiveWindow 関数を使用してトップレベル ウィンドウをアクティブ化できます。 作成した最上位ウィンドウがアクティブかどうかを判断するには、 GetActiveWindow 関数を使用します。

1 つのウィンドウが非アクティブ化され、別のウィンドウがアクティブになると、 WM_ACTIVATE メッセージが送信されます。 ウィンドウが非アクティブ化されている場合、 wParam パラメーターの下位ワードは 0 で、アクティブ化されている場合は 0 以外です。 既定のウィンドウ プロシージャは、 WM_ACTIVATE メッセージを受け取ると、キーボード フォーカスをアクティブ ウィンドウに設定します。

キーボードとマウスの入力イベントがアプリケーションに到達するのをブロックするには、 BlockInput を使用します。 BlockInput 関数は、非同期キーボード入力状態テーブルに干渉しないことに注意してください。 つまり、入力がブロックされている間に SendInput 関数を呼び出すと、非同期キーボード入力状態テーブルが変更されます。

キーストローク メッセージ

キーを押すと、キーボード フォーカスがあるウィンドウに接続されているスレッド メッセージ キューにWM_KEYDOWNまたはWM_SYSKEYDOWNメッセージが配置されます。 キーを解放すると、 WM_KEYUP または WM_SYSKEYUP メッセージがキューに配置されます。

通常、キーアップメッセージとキーダウンメッセージはペアで行われますが、ユーザーがキーボードの自動繰り返し機能を開始するのに十分な長さのキーを押すと、システムは多数の WM_KEYDOWN または WM_SYSKEYDOWN メッセージを連続して生成します。 その後、ユーザーがキーを解放すると、1 つの WM_KEYUP または WM_SYSKEYUP メッセージが生成されます。

このセクションは、次のトピックで構成されています。

• システムキーストロークと非システムキーストローク
• Virtual-Key コードについて説明
• キーストローク メッセージ フラグ

システムキーストロークと非システムキーストローク

システムは、システムキーストロークと非システムキーストロークを区別します。 システムキーストロークは、システムキーストロークメッセージ、 WM_SYSKEYDOWN および WM_SYSKEYUPを生成します。 非システム キーストロークでは、非システム キーストローク メッセージ、 WM_KEYDOWN 、 およびWM_KEYUPが生成されます。

ウィンドウ プロシージャがシステム キーストローク メッセージを処理する必要がある場合は、メッセージの処理後にプロシージャが DefWindowProc 関数に渡されることを確認します。 それ以外の場合、ウィンドウにキーボード フォーカスがある場合は常に 、Alt キーに関連するすべてのシステム操作が無効になります。 つまり、ユーザーはウィンドウのメニューやシステム メニューにアクセスしたり、 Alt + Esc キーまたは Alt + Tab キーストロークを使用して別のウィンドウをアクティブ化したりすることはできません。

システム キーストローク メッセージは、主にアプリケーションではなくシステムで使用されます。 システムはそれらを使用して、組み込みのキーボード インターフェイスをメニューに提供し、ユーザーがアクティブなウィンドウを制御できるようにします。 システム キーストローク メッセージは、ユーザーが Alt キーと組み合わせてキーを入力したとき、またはユーザーが入力したウィンドウにキーボード フォーカスがない場合 (アクティブなアプリケーションが最小化されている場合など) に生成されます。 この場合、メッセージは、アクティブ ウィンドウに接続されているメッセージ キューにポストされます。

非システム キーストローク メッセージは、アプリケーション ウィンドウで使用されます。 DefWindowProc 関数では何も行われません。 ウィンドウ プロシージャは、不要なシステムキーストロークメッセージを破棄できます。

Virtual-Key コードについての説明

キーストローク メッセージの wParam パラメーターには、押されたキーまたは解放されたキーの 仮想キー コード が含まれています。 ウィンドウ プロシージャは、仮想キー コードの値に応じて、キーストローク メッセージを処理または無視します。

一般的なウィンドウ プロシージャは、受信したキーストローク メッセージのごく一部のみを処理し、残りは無視します。 たとえば、ウィンドウ プロシージャは 、WM_KEYDOWN キーストローク メッセージのみを処理し、カーソル移動キー、シフト キー (制御キーとも呼ばれます)、およびファンクション キーの仮想キー コードを含むメッセージのみを処理できます。 一般的なウィンドウ プロシージャでは、文字キーからのキーストローク メッセージは処理されません。 代わりに、 TranslateMessage 関数を使用してメッセージを文字メッセージに変換します。 TranslateMessage と文字メッセージの詳細については、「文字メッセージ」を参照してください。

キーストローク メッセージ フラグ

キーストローク メッセージの lParam パラメーターには、メッセージを生成したキーストロークに関する追加情報が含まれています。 この情報には、 繰り返し数、 スキャン コード、 拡張キー フラグ、 コンテキスト コード、前の キー状態フラグ、 および遷移状態フラグが含まれます。 次の図は、これらのフラグの場所と lParam パラメーターの値を示しています。

アプリケーションでは、次の値を使用して 、lParam の上位ワードからキーストローク フラグを取得できます。

コード例:

case WM_KEYDOWN:
case WM_KEYUP:
case WM_SYSKEYDOWN:
case WM_SYSKEYUP:
{
    WORD vkCode = LOWORD(wParam);                                 // virtual-key code
    
    WORD keyFlags = HIWORD(lParam);

    WORD scanCode = LOBYTE(keyFlags);                             // scan code
    BOOL isExtendedKey = (keyFlags & KF_EXTENDED) == KF_EXTENDED; // extended-key flag, 1 if scancode has 0xE0 prefix
    
    if (isExtendedKey)
        scanCode = MAKEWORD(scanCode, 0xE0);

    BOOL wasKeyDown = (keyFlags & KF_REPEAT) == KF_REPEAT;        // previous key-state flag, 1 on autorepeat
    WORD repeatCount = LOWORD(lParam);                            // repeat count, > 0 if several keydown messages was combined into one message

    BOOL isKeyReleased = (keyFlags & KF_UP) == KF_UP;             // transition-state flag, 1 on keyup

    // if we want to distinguish these keys:
    switch (vkCode)
    {
    case VK_SHIFT:   // converts to VK_LSHIFT or VK_RSHIFT
    case VK_CONTROL: // converts to VK_LCONTROL or VK_RCONTROL
    case VK_MENU:    // converts to VK_LMENU or VK_RMENU
        vkCode = LOWORD(MapVirtualKeyW(scanCode, MAPVK_VSC_TO_VK_EX));
        break;
    }

    // ...
}
break;

繰り返し回数

繰り返し数を確認して、キーストローク メッセージが複数のキーストロークを表しているかどうかを判断できます。 システムは、アプリケーションがそれらを処理できる速度よりも速くキーボードが WM_KEYDOWN または WM_SYSKEYDOWN メッセージを生成するときにカウントをインクリメントします。 これは多くの場合、ユーザーがキーボードの自動繰り返し機能を開始するのに十分な長さにキーを押したときに発生します。 システム メッセージ キューに結果のキーダウン メッセージを入力する代わりに、システムはメッセージを 1 つのキーダウン メッセージに結合し、繰り返し数を増やします。 キーを解放しても自動繰り返し機能を開始できないため、 WM_KEYUP メッセージと WM_SYSKEYUP メッセージの繰り返し数は常に 1 に設定されます。

スキャン コード

スキャン コードは、ユーザーがキーを押したときにシステムによって生成される値です。 これは、キーによって表される文字ではなく、アクティブな キーボード レイアウトに関係なく押されたキーを識別する値です。 通常、アプリケーションはスキャン コードを無視します。 代わりに、仮想キー コードを使用してキーストローク メッセージを解釈します。

最新のキーボードは、コンピューターとの通信に ヒューマン インターフェイス デバイス (HID) 仕様を使用しています。 キーボードドライバーは、キーボードから送信された HID 使用法の値をスキャンコードに変換し、それをアプリケーションに渡します。

次の表に、Windows で現在認識されているスキャン コードのセットを示します。 HID 使用状況ページ/HID 使用状況 ID/HID 使用法名の 値は、 HID 使用法テーブル ドキュメントを参照します。 キーの場所の値は、上記のキーボード イメージを参照します。

Scan 1 Make コードは、WM_KEYDOWN/WM_KEYUP/WM_SYSKEYDOWN/WM_SYSKEYUPおよびWM_INPUTメッセージで配信されます。

注記:

1. SysRq キー スキャン コードが Alt + Print 画面 のキーストロークで出力される
2. Ctrl + Pause キーストロークでブレーク キー スキャン コードが出力される
3. 従来のキーボード メッセージに表示されるとおり
4. このキーは、ブラジルのキーボードに存在します
5. キーは日本語キーボードに存在します
6. スキャン コードは、キー リリース イベントでのみ出力されます

Extended-Key フラグ

拡張キー フラグは、キーストローク メッセージが拡張 101/102 キー キーボードの追加キーの 1 つから送信されたかどうかを示します。 拡張キーとは、キーボード右側の Alt キーと Ctrl キー、数値キーパッドの左側のキー群にある Insert、Delete、Home、End、Page Up、Page Down、Arrow の各キー、Break（Ctrl+Pause）キー、Print Screen キー、数値キーパッド上の Divide (/) キーと Enter キー、および Windows キーと Application キーを指します。 Num Lock キーには、一時停止キーとは別のスキャン コード (拡張キー フラグなしで同じスキャン コードを使用) があり、拡張キー名テーブルに表示されているにもかかわらず拡張キーとは見なされないことに注意してください。 右側の Shift キーは拡張キーとも見なされません。代わりに別のスキャン コード (0x36) があります。

指定した場合、スキャン コードは 2 バイトのシーケンスで構成され、最初のバイトの値は 0xE0。

コンテキスト コード

コンテキスト コードは、キーストローク メッセージが生成されたときに Alt キーがダウンしたかどうかを示します。 Alt キーがダウンした場合はコードは 1、アップしている場合は 0 です。

前の Key-State フラグ

前のキー状態フラグは、キーストローク メッセージを生成したキーが以前にアップまたはダウンしたかどうかを示します。 キーが以前にダウンしていた場合は 1、キーが以前にアップしていた場合は 0 です。 このフラグを使用すると、キーボードの自動繰り返し機能によって生成されたキーストローク メッセージを識別できます。 このフラグは、自動繰り返し機能によって生成された WM_KEYDOWN および WM_SYSKEYDOWN キーストローク メッセージに対して 1 に設定されます。 WM_KEYUPメッセージとWM_SYSKEYUPメッセージの場合、常に 1 に設定されます。

Transition-State フラグ

遷移状態フラグは、キーを押すか、キーを解放してキーストローク メッセージを生成したかを示します。 WM_KEYDOWNおよびWM_SYSKEYDOWNメッセージの場合、このフラグは常に 0 に設定されます。WM_KEYUPメッセージとWM_SYSKEYUPメッセージの場合は常に 1 に設定されます。

文字メッセージ

キーストローク メッセージはキーストロークに関する多くの情報を提供しますが、文字キーストロークの文字コードは提供しません。 文字コードを取得するには、アプリケーションがスレッド メッセージ ループに TranslateMessage 関数を含める必要があります。 TranslateMessage は、 WM_KEYDOWN または WM_SYSKEYDOWN メッセージをキーボード レイアウトに渡します。 レイアウトはメッセージの仮想キー コードを調べ、文字キーに対応する場合は、同等の文字コードを提供します ( Shift キーと Caps Lock キーの状態を考慮)。 次に、文字コードを含む文字メッセージを生成し、メッセージをメッセージ キューの先頭に配置します。 メッセージ ループの次のイテレーションでは、キューから文字メッセージを削除し、適切なウィンドウ プロシージャにメッセージをディスパッチします。

このセクションは、次のトピックで構成されています。

• 非システム文字メッセージ
• Dead-Character メッセージ

非システム文字メッセージ

ウィンドウ プロシージャは、WM_CHAR、WM_DEADCHAR、WM_SYSCHAR、WM_SYSDEADCHAR、およびWM_UNICHARの文字メッセージを受け取ることができます。 TranslateMessage 関数は、WM_KEYDOWN メッセージを処理するときにWM_CHARまたはWM_DEADCHARメッセージを生成します。 同様に、 WM_SYSKEYDOWN メッセージを処理すると 、WM_SYSCHAR または WM_SYSDEADCHAR メッセージが生成されます。

キーボード入力を処理するアプリケーションは、通常、 WM_CHAR および WM_UNICHAR メッセージを除くすべてのメッセージを無視し、 DefWindowProc 関数に他のメッセージを渡します。 WM_CHARでは UTF-16 (16 ビット Unicode 変換形式) または ANSI 文字セットが使用されますが、WM_UNICHARでは常に UTF-32 (32 ビット Unicode 変換形式) が使用されることに注意してください。 システムは 、WM_SYSCHAR メッセージと WM_SYSDEADCHAR メッセージを使用してメニューニーモニックを実装します。

すべての文字メッセージの wParam パラメーターには、押された文字キーの文字コードが含まれています。 文字コードの値は、メッセージを受信するウィンドウのウィンドウ クラスによって異なります。 RegisterClass 関数の Unicode バージョンを使用してウィンドウ クラスを登録した場合、システムはそのクラスのすべてのウィンドウに Unicode 文字を提供します。 それ以外の場合、システムは ANSI 文字コードを提供します。 詳細については、Windows アプリ でのウィンドウ クラスの登録 と UTF-8 コード ページの使用に関するページを参照してください。

文字メッセージの lParam パラメーターの内容は、文字メッセージを生成するために変換されたキーダウン メッセージの lParam パラメーターの内容と同じです。 詳細については、「 キーストローク メッセージ フラグ」を参照してください。

デッドキャラクター メッセージ

一部の英語以外のキーボードには、単独で文字を生成することが想定されていない文字キーが含まれています。 代わりに、後続のキーストロークによって生成された文字に分音記号を追加するために使用されます。 これらのキーは 、デッド キーと呼ばれます。 ドイツ語キーボードの circumflex キーは、デッド キーの例です。 "o" で構成される文字を circumflex と共に入力するには、ドイツ語のユーザーは、circumflex キーの後に "o" キーを入力します。 キーボード フォーカスのあるウィンドウには、次の一連のメッセージが表示されます。

1. WM_KEYDOWN
2. WM_DEADCHAR
3. WM_KEYUP
4. WM_KEYDOWN
5. WM_CHAR
6. WM_KEYUP

TranslateMessage は、デッドキーから WM_KEYDOWN メッセージを処理すると WM_DEADCHAR メッセージを生成します。 WM_DEADCHAR メッセージの wParam パラメーターにはデッドキーの分音記号の文字コードが含まれていますが、通常アプリケーションはこのメッセージを無視します。 代わりに、後続のキーストロークによって生成された WM_CHAR メッセージを処理します。 WM_CHAR メッセージの wParam パラメーターには、分音記号を含む文字コードが含まれています。 後続のキーストロークで分音記号と組み合わせることができない文字が生成された場合、システムは 2 つの WM_CHAR メッセージを生成します。 最初の wParam パラメーターには、分音記号の文字コードが含まれています。2 番目の wParam パラメーターには、後続の文字キーの文字コードが含まれています。

TranslateMessage 関数は、システムのデッド キー (Alt キーと組み合わせて押されたデッド キー) からWM_SYSKEYDOWN メッセージを処理するときに、WM_SYSDEADCHAR メッセージを生成します。 アプリケーションは通常、 WM_SYSDEADCHAR メッセージを無視します。

キーの状態

キーボード メッセージの処理中に、アプリケーションは、現在のメッセージを生成したキー以外の別のキーの状態を確認する必要がある場合があります。 たとえば、ユーザーが Shift キーを押しながら End キーを押してテキスト ブロックを選択できるようにするワープロ アプリケーションでは、End キーからキーストローク メッセージを受信するたびに Shift キーの状態を確認する必要があります。 アプリケーションは GetKeyState 関数を使用して、現在のメッセージが生成されたときの仮想キーの状態を判断できます。 GetAsyncKeyState 関数を使用して、仮想キーの現在の状態を取得できます。

一部のキーは、キーボード レイアウトの状態を変更するトグル キーと見なされます。 トグル キーには、通常、 CapsLock (VK_CAPITAL)、 Num Lock (VK_NUMLOCK)、 スクロール ロック (VK_SCROLL) キーが含まれます。 ほとんどのキーボードには、これらのキーに対応する LED インジケーターがあります。

キーボード レイアウトでは、名前の一覧が保持されます。 1 つの文字を生成するキーの名前は、キーによって生成される文字と同じです。 Tab キーや Enter キーなどの文字以外のキーの名前は、文字列として格納されます。 アプリケーションは 、GetKeyNameText 関数を呼び出すことによって、キーボード レイアウトから任意のキーの名前を取得できます。

キーストロークと文字翻訳

システムには、さまざまなキーストローク メッセージによって提供されるスキャン コード、文字コード、および仮想キー コードを変換する特殊な目的の機能がいくつか含まれています。 これらの関数には、 MapVirtualKey、 ToAscii、 ToUnicode、 VkKeyScan が含まれます。

さらに、Microsoft Rich Edit 3.0 では HexToUnicode IME がサポートされています。これにより、ユーザーはホット キーを使用して 16 進文字と Unicode 文字を変換できます。 つまり、Microsoft Rich Edit 3.0 をアプリケーションに組み込むと、アプリケーションは HexToUnicode IME の機能を継承します。

ホット キーのサポート

ホット キーは、WM_HOTKEY メッセージを生成するキーの組み合わせで、システムがスレッドのメッセージ キューの先頭に配置し、キュー内の既存のメッセージをバイパスします。 アプリケーションでは、ホット キーを使用して、ユーザーから優先度の高いキーボード入力を取得します。 たとえば、 Ctrl + C キーストロークで構成されるホット キーを定義することで、アプリケーションはユーザーが長い操作を取り消すことができます。

ホット キーを定義するために、アプリケーションは RegisterHotKey 関数を呼び出し、 WM_HOTKEY メッセージを生成するキーの組み合わせ、メッセージを受信するウィンドウへのハンドル、ホット キーの識別子を指定します。 ユーザーがホット キーを押すと、ウィンドウを作成したスレッドのメッセージ キューに WM_HOTKEY メッセージが配置されます。 メッセージの wParam パラメーターには、ホット キーの識別子が含まれています。 アプリケーションはスレッドに対して複数のホット キーを定義できますが、スレッド内の各ホット キーには一意の識別子が必要です。 アプリケーションが終了する前に、 UnregisterHotKey 関数を使用してホット キーを破棄する必要があります。

アプリケーションでは、ホット キー コントロールを使用して、ユーザーがホット キーを簡単に選択できるようにします。 ホット キー コントロールは、通常、ウィンドウをアクティブにするホット キーを定義するために使用されます。 RegisterHotKey 関数と UnregisterHotKey 関数は 使用しません。 代わりに、ホット キー コントロールを使用するアプリケーションは、通常、 WM_SETHOTKEY メッセージを 送信してホット キーを設定します。 ユーザーがホット キーを押すたびに、システムはSC_HOTKEYを指定するWM_SYSCOMMAND メッセージを送信します。 ホット キー コントロールの詳細については、「ホット キー コントロールの使用」を参照してください。

ブラウズやその他の機能のキーボード キー

Windows では、ブラウザー機能、メディア機能、アプリケーション起動、電源管理用の特別なキーを備えたキーボードがサポートされています。 WM_APPCOMMANDでは、追加のキーボード キーがサポートされます。 さらに、 ShellProc 関数は、追加のキーボード キーをサポートするように変更されます。

コンポーネント アプリケーションの子ウィンドウで、これらの追加のキーボード キーのコマンドを直接実装できる可能性はほとんどありません。 そのため、これらのキーのいずれかが押されると、 DefWindowProc は ウィンドウにWM_APPCOMMAND メッセージを送信します。 DefWindowProc は、 WM_APPCOMMAND メッセージを親ウィンドウにバブルします。 これは、右マウス ボタンを使用してコンテキスト メニューを呼び出す方法と似ています。 これは、DefWindowProc が右ボタン クリック でWM_CONTEXTMENU メッセージを送信し、親にバブルを付ける方法です。 さらに、 DefWindowProc がトップレベル ウィンドウの WM_APPCOMMAND メッセージを受信すると、コード HSHELL_APPCOMMANDを含むシェル フックが呼び出されます。

Windows では、5 つのボタンを持つマウスである Microsoft IntelliMouse エクスプローラーもサポートされています。 2 つの追加ボタンは、前方および後方のブラウザー ナビゲーションをサポートします。 詳細については、 XBUTTON を参照してください。

入力のシミュレート

中断されない一連のユーザー入力イベントをシミュレートするには、 SendInput 関数を使用します。 この関数は、3 つのパラメーターを受け取ります。 最初のパラメーター cInputs は、シミュレートされる入力イベントの数を示します。 2 番目のパラメーター rgInputs は INPUT 構造体の配列であり、それぞれが入力イベントの種類とそのイベントに関する追加情報を記述します。 最後のパラメーター cbSize は、 INPUT 構造体のサイズをバイト単位で受け入れます。

SendInput 関数は、シミュレートされた一連の入力イベントをデバイスの入力ストリームに挿入することによって機能します。 この効果は 、keybd_event または mouse_event 関数を繰り返し呼び出すことと似ていますが、シミュレートされたイベントと他の入力イベントが混在しないようにシステムによって保証される点が異なります。 呼び出しが完了すると、戻り値は、正常に再生された入力イベントの数を示します。 この値が 0 の場合、入力はブロックされました。

SendInput 関数は、キーボードの現在の状態をリセットしません。 そのため、ユーザーがこの関数を呼び出すときに押されたキーがある場合、この関数が生成するイベントに干渉する可能性があります。 干渉の可能性が心配な場合は、 GetAsyncKeyState 関数を使用してキーボードの状態を確認し、必要に応じて修正します。

言語、ロケール、キーボード レイアウト

言語は、英語、フランス語、日本語などの自然言語です。 サブ言語は、英国と米国で話される英語のサブ言語など、特定の地理的地域で話される自然言語のバリエーションです。 アプリケーションでは、 言語識別子と呼ばれる値を使用して、言語とサブ言語を一意に識別します。

通常、アプリケーションは ロケール を使用して、入力と出力が処理される言語を設定します。 たとえば、キーボードのロケールを設定すると、キーボードによって生成される文字値に影響します。 ディスプレイまたはプリンターのロケールを設定すると、表示または印刷されるグリフに影響します。 アプリケーションでは、キーボード レイアウトを読み込んで使用することで、キーボードのロケールを設定します。 指定したロケールをサポートするフォントを選択して、ディスプレイまたはプリンターのロケールを設定します。

キーボード レイアウトは、キーボード上のキーの物理的な位置を指定するだけでなく、それらのキーを押すことによって生成される文字値も決定します。 各レイアウトは、現在の入力言語を識別し、キーとキーの組み合わせによって生成される文字値を決定します。

すべてのキーボード レイアウトには、レイアウトと言語を識別する対応するハンドルがあります。 ハンドル部分の下位ワードは言語識別子です。 高い単語は、物理レイアウトを指定するデバイス ハンドル、または既定の物理レイアウトを示す 0 です。 ユーザーは、任意の入力言語を物理レイアウトに関連付けることができます。 たとえば、フランス語で頻繁に作業する英語を話すユーザーは、キーボードの物理的なレイアウトを変更せずに、キーボードの入力言語をフランス語に設定できます。 つまり、ユーザーは使い慣れた英語レイアウトを使用してフランス語でテキストを入力できます。

通常、アプリケーションは入力言語を直接操作することは想定されていません。 代わりに、ユーザーは言語とレイアウトの組み合わせを設定し、その間で切り替えます。 ユーザーが別の言語でマークされたテキストをクリックすると、アプリケーションは ActivateKeyboardLayout 関数を呼び出して、その言語のユーザーの既定のレイアウトをアクティブにします。 ユーザーがアクティブなリストにない言語でテキストを編集した場合、アプリケーションは言語で LoadKeyboardLayout 関数を呼び出して、その言語に基づいてレイアウトを取得できます。

ActivateKeyboardLayout 関数は、現在のタスクの入力言語を設定します。 hkl パラメーターには、キーボード レイアウトのハンドルまたは 0 から拡張された言語識別子のいずれかを指定できます。 キーボード レイアウト ハンドルは、 LoadKeyboardLayout または GetKeyboardLayoutList 関数から取得できます。 HKL_NEXTとHKL_PREVの値を使用して、次のキーボードまたは前のキーボードを選択することもできます。

GetKeyboardLayoutName 関数は、呼び出し元スレッドのアクティブなキーボード レイアウトの名前を取得します。 アプリケーションが LoadKeyboardLayout 関数を使用してアクティブなレイアウトを作成する場合、 GetKeyboardLayoutName はレイアウトの作成に使用したのと同じ文字列を取得します。 それ以外の場合、文字列は、アクティブなレイアウトのロケールに対応するプライマリ言語識別子です。 つまり、関数は必ずしも同じプライマリ言語を持つ異なるレイアウト間で区別されない可能性があるため、入力言語に関する特定の情報を返すことはできません。 ただし、 GetKeyboardLayout 関数を使用して入力言語を決定できます。

LoadKeyboardLayout 関数は、キーボード レイアウトを読み込み、ユーザーがレイアウトを使用できるようにします。 アプリケーションでは、 KLF_ACTIVATE 値を使用して、現在のスレッドのレイアウトをすぐにアクティブにすることができます。 アプリケーションでは、 KLF_REORDER 値を使用して、 KLF_ACTIVATE 値も指定せずにレイアウトを並べ替えることができます。 アプリケーションでは、キーボード レイアウトを読み込むときに 常に KLF_SUBSTITUTE_OK 値を使用して、ユーザーの設定 (ある場合) が選択されていることを確認する必要があります。

多言語サポートのために、 LoadKeyboardLayout 関数は KLF_REPLACELANG フラグと KLF_NOTELLSHELL フラグを提供します。 KLF_REPLACELANG フラグは、言語を変更せずに既存のキーボード レイアウトを置き換える関数を指示します。 同じ言語識別子を使用し、 KLF_REPLACELANG を指定せずに既存のレイアウトを置き換えようとすると、エラーになります。 KLF_NOTELLSHELL フラグを設定すると、キーボード レイアウトが追加または置き換えられたときに、関数がシェルに通知できなくなります。 これは、連続する一連の呼び出しで複数のレイアウトを追加するアプリケーションに役立ちます。 このフラグは、最後の呼び出し以外のすべての呼び出しで使用する必要があります。

UnloadKeyboardLayout 関数は、システムの既定の入力言語をアンロードできないという点で制限されています。 これにより、シェルおよびファイル システムで使用されるのと同じ文字セットを使用して、ユーザーが常に 1 つのレイアウトを入力テキストに使用できるようになります。