WM_CHARTOITEM message

Sent by a list box with the LBS_WANTKEYBOARDINPUT style to its owner in response to a WM_CHAR message.

WM_CHARTOITEM

    WPARAM wParam;
    LPARAM lParam; 

Parameters

wParam

The LOWORD specifies the character code of the key the user pressed. The HIWORD specifies the current position of the caret.

lParam

Handle to the list box.

Return value

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

Remarks

The DefWindowProc function returns -1.

Only owner-drawn list boxes that do not have the LBS_HASSTRINGS style can receive this message.

If a dialog box procedure handles this message, it should cast the desired return value to a BOOL and return the value directly. The DWL_MSGRESULT value set by the SetWindowLong function is ignored.

Requirements

Requirement Value
Minimum supported client
Windows Vista [desktop apps only]
Minimum supported server
Windows Server 2003 [desktop apps only]
Header
Winuser.h (include Windows.h)

See also

Reference

WM_VKEYTOITEM

Other Resources

DefWindowProc

HIWORD

LOWORD

WM_CHAR