CWnd::OnDeadChar

[アーティクル]
08/09/2011

OnKeyUp メンバー関数および OnKeyDown メンバー関数が呼び出されるときに、フレームワークからこのメンバー関数が呼び出されます。

afx_msg void OnDeadChar(
   UINT nChar,
   UINT nRepCnt,
   UINT nFlags 
);

パラメーター

nChar
デッドキー文字の値を指定します。
nRepCnt
繰り返し回数を指定します。

nFlags
次に示すスキャンコード、キー変換コード、直前のキー状態、およびコンテキストコードを指定します。

値	説明
0–7	スキャンコード (OEM 依存の値)。上位ワードの下位バイト。
8	ファンクションキーなどの拡張キーまたはテンキー上のキーなど (拡張キーの場合は 1、それ以外の場合は 0)。
9–10	使用しません。
11–12	Windows 内部で使用します。
13	コンテキストコード (Alt キーを押した状態でほかのキーを押した場合は 1、それ以外の場合は 0)。
14	直前のキー状態 (呼び出す前にキーが押されると 1、キーが離されると 0)。
15	変換状態 (キーが離されている場合は 1、押されている場合は 0)。

解説

このメンバー関数を使ってデッドキー文字の値を指定できます。デッドキーとは、ほかのキーと組み合わせて合成文字を作るサーカムフレックス (^) などを示します。たとえば、^O 文字はデッドキーのサーカムフレックスと O キーから構成されます。

通常、アプリケーションでは OnDeadChar を使って、押されたキーについてのフィードバックが与えられます。たとえば、アプリケーションはカレットを移動せずに、現在の文字位置にアクセントを表示できます。

押されたキーと OnDeadChar 関数の呼び出しは、一対一で対応する必要はないので、通常 nFlags の情報をアプリケーションで使うことはありません。 nFlags の情報は、OnDeadChar の呼び出しの直前に呼び出された OnKeyUp メンバー関数、または OnKeyDown メンバー関数に適用されます。

IBM の 101 キーまたは 102 キーの拡張キーボードで拡張されたキーは、キーボードのメインセクションの右 Alt キーと右 Ctrl キー、テンキーの左にある Ins キー、Del キー、Home キー、End キー、PageUp キー、PageDown キー、方向キー、およびテンキーのスラッシュ (/) キーと Enter キーです。ほかのキーボードでは、nFlags の拡張キービットで拡張キーをサポートすることがあります。

注意

このメンバー関数は、アプリケーションが Windows メッセージを処理できるようにするためにフレームワークによって呼び出されます。この関数に渡されるパラメーターの値は、フレームワークがメッセージ受信時に受け取ったパラメーターの値に基づいています。この関数の基本クラスの実装を呼び出した場合は、関数に渡したパラメーターではなく、メッセージと共に渡されたパラメーター自体が使用されます。