MapVirtualKeyA 関数 (winuser.h)

仮想キー コードをスキャン コードまたは文字値に変換 (マップ) するか、スキャン コードを仮想キー コードに変換します。

構文

UINT MapVirtualKeyA(
  [in] UINT uCode,
  [in] UINT uMapType
);

パラメーター

[in] uCode

型: UINT

仮想キー コードまたはキーのスキャン コード。 この値の解釈方法は、 uMapType パラメーターの値によって異なります。

[in] uMapType

型: UINT

実行する翻訳。 このパラメーターの値は、 uCode パラメーターの値によって異なります。

戻り値

型: UINT

戻り値は、 uCode と uMapType の値に応じて、スキャン コード、仮想キー コード、または文字値のいずれかです。 変換がない場合、戻り値は 0 になります。

注釈

指定したコードの変換に使用するキーボード レイアウトのハンドルを指定するには、MapVirtualKeyEx 関数を使用します。

アプリケーションは MapVirtualKey を使用して、スキャン コードを仮想キー コード定数VK_SHIFT、VK_CONTROL、VK_MENUに変換できます。その逆も同様です。 これらの変換では、Shift キー、Ctrl キー、または Alt キーの左と右のインスタンスは区別されません。

アプリケーションは、次のいずれかの仮想キー コード定数に uCode を設定して MapVirtualKey を呼び出すことによって、これらのキーの左または右のインスタンスに対応するスキャン コードを取得できます。

• VK_LSHIFT
• VK_RSHIFT
• VK_LCONTROL
• VK_RCONTROL
• VK_LMENU
• VK_RMENU

これらの左および右区別定数は、GetKeyboardState、SetKeyboardState、GetAsyncKeyState、GetKeyState、MapVirtualKey、および MapVirtualKeyEx 関数を介してのみアプリケーションで使用できます。 仮想キー コードの完全な一覧については、「 仮想キー コード」を参照してください。

MAPVK_VK_TO_CHAR モードの仮想キー コードでは、'A'..'Z キーは大文字の 'A' に変換されます。現在のキーボード レイアウトに関係なく、Z' 文字。 仮想キー コードを対応する文字に変換する場合は、 ToAscii 関数を使用します。

要件

こちらもご覧ください

• GetAsyncKeyState
• GetKeyState
• GetKeyboardState
• GetSystemMetrics
• MapVirtualKey
• SetKeyboardState
• キーボード入力
• キーボード入力の概要