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)