COMBOBOXEXITEMA-Struktur (commctrl.h)

Enthält Informationen zu einem Element in einem ComboBoxEx-Steuerelement.

Syntax

typedef struct tagCOMBOBOXEXITEMA {
  UINT    mask;
  INT_PTR iItem;
  LPSTR   pszText;
  int     cchTextMax;
  int     iImage;
  int     iSelectedImage;
  int     iOverlay;
  int     iIndent;
  LPARAM  lParam;
} COMBOBOXEXITEMA, *PCOMBOBOXEXITEMA;

Member

mask

Typ: UINT

Eine Reihe von Bitflags, die Attribute dieser Struktur oder eines Vorgangs angeben, der diese Struktur verwendet. Die Flags geben Elemente an, die gültig sind oder ausgefüllt werden müssen. Dieser Member kann eine Kombination der folgenden Werte sein.

Wert	Bedeutung
CBEIF_DI_SETITEM	Legen Sie dieses Flag fest, wenn Sie CBEN_GETDISPINFO verarbeiten. Das ComboBoxEx-Steuerelement behält die angegebenen Informationen bei und fordert sie nicht erneut an.
CBEIF_IMAGE	Das iImage-Element ist gültig oder muss ausgefüllt werden.
CBEIF_INDENT	Das iIndent-Element ist gültig oder muss ausgefüllt werden.
CBEIF_LPARAM	Das lParam-Element ist gültig oder muss ausgefüllt werden.
CBEIF_OVERLAY	Das iOverlay-Element ist gültig oder muss ausgefüllt werden.
CBEIF_SELECTEDIMAGE	Das iSelectedImage-Element ist gültig oder muss ausgefüllt werden.
CBEIF_TEXT	Das pszText-Element ist gültig oder muss ausgefüllt werden.

iItem

Typ: INT_PTR

Der nullbasierte Index des Elements.

pszText

Typ: LPTSTR

Ein Zeiger auf einen Zeichenpuffer, der den Text des Elements enthält oder empfängt. Wenn Textinformationen abgerufen werden, muss dieses Element auf die Adresse eines Zeichenpuffers festgelegt werden, der den Text empfängt. Die Größe dieses Puffers muss auch in cchTextMax angegeben werden. Wenn dieses Element auf LPSTR_TEXTCALLBACK festgelegt ist, fordert das Steuerelement die Informationen mithilfe der CBEN_GETDISPINFO Benachrichtigungscodes an.

cchTextMax

Typ: int

Die Länge von pszText in TCHARs. Wenn Textinformationen festgelegt werden, wird dieser Member ignoriert.

iImage

Typ: int

Der nullbasierte Index eines Bilds innerhalb der Bildliste. Das angegebene Bild wird für das Element angezeigt, wenn es nicht ausgewählt ist. Wenn dieser Member auf I_IMAGECALLBACK festgelegt ist, fordert das Steuerelement die Informationen mithilfe von CBEN_GETDISPINFO Benachrichtigungscodes an.

iSelectedImage

Typ: int

Der nullbasierte Index eines Bilds innerhalb der Bildliste. Das angegebene Bild wird für das Element angezeigt, wenn es ausgewählt wird. Wenn dieser Member auf I_IMAGECALLBACK festgelegt ist, fordert das Steuerelement die Informationen mithilfe von CBEN_GETDISPINFO Benachrichtigungscodes an.

iOverlay

Typ: int

Der 1-basierte Index eines Überlagerungsbilds innerhalb der Bildliste. Wenn dieser Member auf I_IMAGECALLBACK festgelegt ist, fordert das Steuerelement die Informationen mithilfe von CBEN_GETDISPINFO Benachrichtigungscodes an.

iIndent

Typ: int

Die Anzahl der Einzugsplätze, die für das Element angezeigt werden sollen. Jeder Einzug entspricht 10 Pixel. Wenn dieser Member auf I_INDENTCALLBACK festgelegt ist, fordert das Steuerelement die Informationen mithilfe von CBEN_GETDISPINFO Benachrichtigungscodes an.

lParam

Typ: LPARAM

Ein für das Element spezifischer Wert.

Hinweise

Hinweis

Der commctrl.h-Header definiert COMBOBOXEXITEM als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit nicht codierungsneutralem Code kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Kopfzeile	commctrl.h