CBEM_GETITEM message

Gets item information for a given ComboBoxEx item.

Parameters

wParam

Must be zero.

lParam

A pointer to a COMBOBOXEXITEM structure that receives the item information.

Return value

Returns nonzero if successful, or zero otherwise.

Remarks

When the message is sent, the iItem and mask members of the structure must be set to indicate the index of the target item and the type of information to be retrieved. Other members are set as needed. For example, to retrieve text, you must set the CBEIF_TEXT flag in mask, and assign a value to cchTextMax. Setting the iItem member to -1 will retrieve the item displayed in the edit control.

If the CBEIF_TEXT flag is set in the mask member of the COMBOBOXEXITEM structure, the control may change the pszText member of the structure to point to the new text instead of filling the buffer with the requested text. Applications should not assume that the text will always be placed in the requested buffer.

Requirements

Requirement Value
Minimum supported client
Windows Vista [desktop apps only]
Minimum supported server
Windows Server 2003 [desktop apps only]
Header
Commctrl.h
Unicode and ANSI names
CBEM_GETITEMW (Unicode) and CBEM_GETITEMA (ANSI)