Freigeben über

HDITEMA-Struktur (commctrl.h)

  • Artikel

Enthält Informationen zu einem Element in einem Kopfzeilensteuerelement. Diese Struktur ersetzt die HD_ITEM Struktur.

Syntax

typedef struct _HD_ITEMA {
  UINT    mask;
  int     cxy;
  LPSTR   pszText;
  HBITMAP hbm;
  int     cchTextMax;
  int     fmt;
  LPARAM  lParam;
  int     iImage;
  int     iOrder;
  UINT    type;
  void    *pvFilter;
  UINT    state;
} HDITEMA, *LPHDITEMA;

Angehörige

mask

Typ: UINT-

Flags, die angeben, welche anderen Strukturmmber gültige Daten enthalten oder ausgefüllt werden müssen. Dieses Element kann eine Kombination aus den folgenden Werten sein:

Wert Bedeutung
HDI_BITMAP
 Das hbm- Mitglied ist gültig.
HDI_DI_SETITEM
 Beim Behandeln der Nachricht HDM_GETITEMenthält das Kopfzeilensteuerelement möglicherweise nicht alle Werte, die zum Abschließen der Anforderung erforderlich sind. In diesem Fall muss das Steuerelement die Anwendung für die Werte über die HDN_GETDISPINFO-Benachrichtigung zurückrufen. Wenn HDI_DI_SETITEM in der HDM_GETITEM Nachricht übergeben wurde, speichert das Steuerelement alle werte zwischen, die von HDN_GETDISPINFO zurückgegeben werden (andernfalls bleiben die Werte nicht festgelegt.)
HDI_FORMAT
 Das fmt Member ist gültig.
HDI_FILTER
 Die Typ und pvFilter Mitglieder sind gültig. Dies wird verwendet, um die im Typ Member angegebenen Werte herauszufiltern.
HDI_HEIGHT
 Identisch mit HDI_WIDTH.
HDI_IMAGE
 Das iImage Member ist gültig und gibt das Bild an, das mit dem Element angezeigt werden soll.
HDI_LPARAM
 Das lParam- Mitglied ist gültig.
HDI_ORDER
 Das iOrder-element ist gültig und gibt den Bestellwert des Elements an.
HDI_STATE

Version 6.00 und höher. Der Status Mitglied ist gültig.
HDI_TEXT
 Die pszText und cchTextMax Member sind gültig.
HDI_WIDTH
 Das cxy Member ist gültig und gibt die Breite des Elements an.

cxy

Typ: int

Die Breite oder Höhe des Elements.

pszText

Typ: LPTSTR-

Ein Zeiger auf eine Elementzeichenfolge. Wenn der Text aus dem Steuerelement abgerufen wird, muss dieses Element initialisiert werden, um auf einen Zeichenpuffer zu zeigen. Wenn dieses Element auf LPSTR_TEXTCALLBACK festgelegt ist, fordert das Steuerelement Textinformationen für dieses Element an, indem ein HDN_GETDISPINFO-Benachrichtigungscode gesendet wird. Beachten Sie, dass zwar eine Zeichenfolge mit beliebiger Länge als Elementtext gespeichert werden kann, aber nur die ersten 260 TCHAR- angezeigt werden.

hbm

Typ: HBITMAP-

Ein Handle für die Elementbitmap.

cchTextMax

Typ: int

Die Länge der Elementzeichenfolge in TCHARs. Wenn der Text aus dem Steuerelement abgerufen wird, muss dieses Element die Anzahl der TCHARs an der adresse enthalten, die durch pszTextangegeben ist.

fmt

Typ: int

Flags, die das Format des Elements angeben.

Wert Bedeutung
Textbeschriftung:
 Legen Sie eines der folgenden Flags fest, um die Textbeschriftung anzugeben:
HDF_CENTER
 Der Inhalt des Elements wird zentriert.
HDF_LEFT
 Der Inhalt des Elements ist linksbündig ausgerichtet.
HDF_RIGHT
 Der Inhalt des Elements ist rechtsbündig ausgerichtet.
Anzeige:
 Legen Sie eines der folgenden Flags fest, um die Anzeige zu steuern:
HDF_BITMAP
 Das Element zeigt eine Bitmap an.
HDF_BITMAP_ON_RIGHT
 Die Bitmap wird rechts neben dem Text angezeigt.
HDF_OWNERDRAW
 Der Besitzer des Kopfzeilensteuerelements zeichnet das Element.
HDF_STRING
 Das Element zeigt eine Zeichenfolge an.
Kombinieren von Flags:
 Der vorangehende Wert kann mit folgendem kombiniert werden:
HDF_IMAGE
 Anzeigen eines Bilds aus einer Bildliste Geben Sie die Bildliste an, indem Sie eine HDM_SETIMAGELIST Nachricht senden. Geben Sie den Index des Bilds im iImage Element dieser Struktur an.
HDF_JUSTIFYMASK
 Isolieren Sie die Bits, die den drei in der vorherigen Tabelle aufgeführten Begründungskennzeichnungen entsprechen.
HDF_RTLREADING
 In der Regel werden in Fenstern Text von links nach rechts (LTR) angezeigt. Windows kann gespiegelt werden, um Sprachen wie Hebräisch oder Arabisch anzuzeigen, die von rechts nach links (RTL) gelesen werden. Normalerweise wird Kopfzeilentext in der gleichen Richtung wie der Text im übergeordneten Fenster gelesen. Wenn HDF_RTLREADING festgelegt ist, liest der Kopfzeilentext in entgegengesetzter Richtung aus dem Text im übergeordneten Fenster.
HDF_SORTDOWN

Version 6.00 und höher. Zeichnet einen Abwärtspfeil auf diesem Element. Dies wird in der Regel verwendet, um anzugeben, dass Informationen im aktuellen Fenster in dieser Spalte in absteigender Reihenfolge sortiert werden. Dieses Kennzeichen kann nicht mit HDF_IMAGE oder HDF_BITMAP kombiniert werden.
HDF_SORTUP

Version 6.00 und höher. Zeichnet einen Pfeil nach oben auf diesem Element. Dies wird in der Regel verwendet, um anzugeben, dass Informationen im aktuellen Fenster in dieser Spalte in aufsteigender Reihenfolge sortiert werden. Dieses Kennzeichen kann nicht mit HDF_IMAGE oder HDF_BITMAP kombiniert werden.
HDF_CHECKBOX

Version 6.00 und höher. Das Element zeigt ein Kontrollkästchen an. Das Flag ist nur gültig, wenn die HDS_CHECKBOXES Formatvorlage zuerst für das Kopfzeilensteuerelement festgelegt wird.
HDF_CHECKED

Version 6.00 und höher. Das Element zeigt ein aktiviertes Kontrollkästchen an. Das Kennzeichen ist nur gültig, wenn auch HDF_CHECKBOX festgelegt ist.
HDF_FIXEDWIDTH

Version 6.00 und höher. Die Breite des Elements kann von einer Benutzeraktion nicht geändert werden, um die Größe zu ändern.
HDF_SPLITBUTTON

Version 6.00 und höher. Das Element zeigt eine geteilte Schaltfläche an. Die HDN_DROPDOWN Benachrichtigung wird gesendet, wenn auf die Geteilte Schaltfläche geklickt wird.

lParam

Typ: LPARAM-

Anwendungsdefinierte Elementdaten.

iImage

Typ: int

Der nullbasierte Index eines Bilds in der Bildliste. Das angegebene Bild wird zusätzlich zu allen im hbm- Feld angegebenen Bildern im Kopfzeilenelement angezeigt. Wenn iImage- auf I_IMAGECALLBACK festgelegt ist, fordert das Steuerelement Textinformationen für dieses Element mithilfe eines HDN_GETDISPINFO Benachrichtigungscodes an. Um das Bild zu löschen, legen Sie diesen Wert auf I_IMAGENONE fest.

iOrder

Typ: int

Die Reihenfolge, in der das Element im Kopfzeilensteuerelement angezeigt wird, von links nach rechts. Das heißt, der Wert für das ganz linke Element ist 0. Der Wert für das nächste Element rechts ist 1 usw.

type

Typ: UINT-

Der Filtertyp, der durch pvFilterangegeben wird. Zu den möglichen Typen gehören:

Wert Bedeutung
HDFT_ISSTRING
 Zeichenfolgendaten.
HDFT_ISNUMBER
 Numerische Daten.
HDFT_HASNOVALUE
 pvFilter-ignorieren.
HDFT_ISDATE

Version 6.00 und höher. Datumsdaten. Der pvFilter Member ist ein Zeiger auf eine SYSTEMTIME Struktur.

pvFilter

Typ: void*

Die Adresse eines anwendungsdefinierten Datenelements. Der Datentyp wird durch Festlegen des Flagwerts des Elements bestimmt. Verwenden Sie das HDFT_ISSTRING-Flag, um eine Zeichenfolge anzugeben, und HDFT_ISNUMBER, um eine ganze Zahl anzugeben. Wenn das HDFT_ISSTRING Flag verwendet wird, ist pvFilter ein Zeiger auf eine HDTEXTFILTER Struktur.

state

Typ: UINT-

Der Zustand. Der einzige gültige, unterstützte Wert für dieses Element lautet wie folgt:

Wert Bedeutung
HDIS_FOCUSED
 Das Element hat den Tastaturfokus.

Bemerkungen

Hinweis Comctl32.dll Version 6 nicht weiterverteilt werden kann, aber in Windows enthalten ist. Wenn Sie Comctl32.dll Version 6 verwenden möchten, geben Sie sie in einem Manifest an. Weitere Informationen zu Manifesten finden Sie unter Aktivieren von visuellen Formatvorlagen.
 

Anmerkung

Der commctrl.h-Header definiert HDITEM 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