CBEM_GETITEM Nachricht

Ruft Elementinformationen für ein bestimmtes ComboBoxEx-Element ab.

Parameter

wParam

Muss Null sein.

lParam

Ein Zeiger auf eine COMBOBOXEXITEM-Struktur , die die Elementinformationen empfängt.

Rückgabewert

Gibt bei erfolgreicher Ausführung nonzero zurück, oder andernfalls null.

Bemerkungen

Wenn die Nachricht gesendet wird, müssen die Elemente iItem und Masken der Struktur so festgelegt werden, dass sie den Index des Zielelements und den Typ der abzurufenden Informationen angeben. Andere Member werden nach Bedarf festgelegt. Zum Abrufen von Text müssen Sie beispielsweise das CBEIF_TEXT-Flag in der Maske festlegen und cchTextMax einen Wert zuweisen. Wenn Sie das iItem-Element auf -1 festlegen, wird das element abgerufen, das im Bearbeitungssteuerelement angezeigt wird.

Wenn das CBEIF_TEXT-Flag im Maskenelement der COMBOBOXEXITEM-Struktur festgelegt ist, kann das Steuerelement das pszText-Element der Struktur so ändern, dass es auf den neuen Text verweist, anstatt den Puffer mit dem angeforderten Text zu füllen. Anwendungen sollten nicht davon ausgehen, dass der Text immer im angeforderten Puffer platziert wird.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Header	Commctrl.h
Unicode- und ANSI-Name	CBEM_GETITEMW (Unicode) und CBEM_GETITEMA (ANSI)