CWnd::OnVKeyToItem

[アーティクル]
09/17/2008

更新 : 2007 年 11 月

CWnd オブジェクトが LBS_WANTKEYBOARDINPUT スタイルを持つリストボックスを所有している場合、リストボックスは WM_KEYDOWN メッセージに応答して WM_VKEYTOITEM メッセージを送ります。

afx_msg int OnVKeyToItem( 
   UINT nKey, 
   CListBox* pListBox, 
   UINT nIndex  
);

パラメータ

nKey
ユーザーが押したキーの仮想キーコードを指定します。標準の仮想キーコードの一覧については、Winuser.h を参照してください。
pListBox
リストボックスへのポインタを指定します。このポインタは一時的である場合があるので、後で使用するために保持しておくことはできません。
nIndex
現在のカレット位置を指定します。

戻り値

アプリケーションがこのメッセージに応答して実行した動作を返します。戻り値が -2 の場合は、アプリケーションで項目の選択に関するすべての動作が処理され、リストボックスでの動作がこれ以上必要ないことを示します。戻り値が -1 の場合は、リストボックスがキーストロークに応じて既定の動作を実行する必要があることを示します。戻り値が 0 以上の場合は、その値はリストボックスの項目の 0 から始まるインデックス番号を意味し、リストボックスがその項目でのキーストロークに応じて既定の動作を実行することを示します。

解説

このメンバ関数は、LBS_HASSTRINGS スタイルを持つリストボックスに対してのみ、フレームワークから呼び出されます。

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

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