CWnd::OnVKeyToItem

Syntax

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

Parameters

nKey

Specifies the virtual-key code of the key that the user pressed.

pListBox

Specifies a pointer to the list box. The pointer may be temporary.

nIndex

Specifies the current caret position.

Remarks

If the CWnd owns a list box with the LBS_WANTKEYBOARDINPUT style, the list box will send the WM_VKEYTOITEM message in response to a WM_KEYDOWN message.

This message-handler member function calls the Default member function. Override this member function in your derived class to handle the WM_VKEYTOITEM message.

Return Value

Specifies the action that the application performed in response to the message. A return value of -2 indicates that the application handled all aspects of selecting the item and wants no further action by the list box. A return value of -1 indicates that the list box should perform the default action in response to the keystroke. A return value of 0 or greater specifies the index of an item in the list box and indicates that the list box should perform the default action for the keystroke on the given item.

See Also

WM_KEYDOWN, WM_VKEYTOITEM, CWnd::Default