CWnd::OnCharToItem

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

更新 : 2007 年 11 月

LBS_WANTKEYBOARDINPUT スタイルを持つリストボックスが、WM_CHAR メッセージに応答して、そのオーナーに WM_CHARTOITEM メッセージを送信するときに、呼び出されます。

afx_msg int OnCharToItem(
   UINT nChar,
   CListBox* pListBox,
   UINT nIndex 
);

パラメータ

nChar
押されたキーの値を指定します。
pListBox
リストボックスへのポインタを指定します。一時的なポインタでもかまいません。
nIndex
現在のカレット位置を指定します。

戻り値

呼び出しに応答してアプリケーションが実行する動作を指定するために、フレームワークによって呼び出されます。戻り値が -2 の場合は、アプリケーションが項目の選択を完了し、リストボックスでそれ以上の動作が必要ないことを示します。戻り値が -1 の場合は、リストボックスがキーストロークに応じて既定の動作を実行する必要があることを示します。戻り値が 0 以上の場合は、その値はリストボックスの項目の 0 から始まるインデックス番号を意味し、リストボックスがその項目でのキーストロークに応じて既定の動作を実行することを示します。

解説

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

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