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 Erfolg einen Wert ungleich 0 (null) zurück. Andernfalls wird 0 (null) zurückgegeben.

Bemerkungen

Wenn die Nachricht gesendet wird, müssen die Elemente iItem und mask der Struktur so festgelegt werden, dass sie den Index des Zielelements und den Typ der abzurufenden Informationen angeben. Andere Member werden nach Bedarf festgelegt. Um z. B. Text abzurufen, müssen Sie das CBEIF _ TEXT-Flag in der Maske festlegen und cchTextMax einen Wert zuweisen. Wenn Sie das iItem-Element auf -1 festlegen, wird das im Bearbeitungssteuerelement angezeigte Element abgerufen.

Wenn das CBEIF _ TEXT-Flag im Maskenmember der COMBOBOXEXITEM-Struktur festgelegt ist, kann das Steuerelement den pszText-Member der -Struktur so ändern, dass er auf den neuen Text verweist, anstatt den Puffer mit dem angeforderten Text aufzufüllen. Anwendungen sollten nicht davon ausgehen, dass der Text immer im angeforderten Puffer platziert wird.

Requirements (Anforderungen)

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows [Nur Vista-Desktop-Apps]
Unterstützte Mindestversion (Server)
Windows Nur Server [ 2003-Desktop-Apps]
Header
Commctrl.h
Unicode- und ANSI-Name
CBEM _ GETITEMW (Unicode) und CBEM _ GETITEMA (ANSI)