Freigeben über

COMBOBOXEXITEMA-Struktur (commctrl.h)

  • Artikel

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;

Angehörige

mask

Typ: UINT-

Eine Gruppe von Bitkennzeichnungen, 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. Dieses Element kann eine Kombination aus den folgenden Werten sein.

Wert Bedeutung
CBEIF_DI_SETITEM
 Legen Sie dieses Kennzeichen beim Verarbeiten von CBEN_GETDISPINFOfest; Das ComboBoxEx-Steuerelement behält die bereitgestellten Informationen bei und fordert sie nicht erneut an.
CBEIF_IMAGE
 Das iImage- Mitglied ist gültig oder muss ausgefüllt werden.
CBEIF_INDENT
 Das iIndent- Mitglied ist gültig oder muss ausgefüllt werden.
CBEIF_LPARAM
 Das lParam- Mitglied ist gültig oder muss ausgefüllt werden.
CBEIF_OVERLAY
 Das iOverlay- Mitglied ist gültig oder muss ausgefüllt werden.
CBEIF_SELECTEDIMAGE
 Das iSelectedImage Mitglied ist gültig oder muss ausgefüllt werden.
CBEIF_TEXT
 Das pszText- Mitglied 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 cchTextMaxangegeben 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 pszText, in TCHARs. Wenn Textinformationen festgelegt werden, wird dieses Element ignoriert.

iImage

Typ: int

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

iSelectedImage

Typ: int

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

iOverlay

Typ: int

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

iIndent

Typ: int

Die Anzahl der Einzüge, die für das Element angezeigt werden sollen. Jeder Einzug entspricht 10 Pixel. Wenn dieses Element auf I_INDENTCALLBACK festgelegt ist, fordert das Steuerelement die Informationen mithilfe CBEN_GETDISPINFO Benachrichtigungscodes an.

lParam

Typ: LPARAM-

Ein wert, der für das Element spezifisch ist.

Bemerkungen

Anmerkung

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 Code, der nicht codierungsneutral ist, 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
mindestens unterstützte Client- Windows Vista [nur Desktop-Apps]
mindestens unterstützte Server- Windows Server 2003 [Nur Desktop-Apps]
Header- commctrl.h