Freigeben über

HDITEMW-Struktur (commctrl.h)

  • Artikel

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

Syntax

typedef struct _HD_ITEMW {
  UINT    mask;
  int     cxy;
  LPWSTR  pszText;
  HBITMAP hbm;
  int     cchTextMax;
  int     fmt;
  LPARAM  lParam;
  int     iImage;
  int     iOrder;
  UINT    type;
  void    *pvFilter;
  UINT    state;
} HDITEMW, *LPHDITEMW;

Member

mask

Typ: UINT

Flags, die angeben, welche anderen Strukturmember gültige Daten enthalten oder ausgefüllt werden müssen. Dieses Element kann eine Kombination der folgenden Werte sein:

Wert Bedeutung
HDI_BITMAP
 Das hbm-Element ist gültig.
HDI_DI_SETITEM
 Bei der Verarbeitung der Nachricht HDM_GETITEM verfügt das Headersteuerelement möglicherweise nicht über 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 von HDN_GETDISPINFO zurückgegebenen Werte zwischen (andernfalls bleiben die Werte nicht festgelegt.)
HDI_FORMAT
 Der fmt-Member ist gültig.
HDI_FILTER
 Die Elemente typ und pvFilter sind gültig. Dies wird verwendet, um die im Typmember angegebenen Werte herauszufiltern.
HDI_HEIGHT
 Dasselbe wie HDI_WIDTH.
HDI_IMAGE
 Das iImage-Element ist gültig und gibt das Bild an, das mit dem Element angezeigt werden soll.
HDI_LPARAM
 Das lParam-Element 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. Das Staatsmitglied ist gültig.
HDI_TEXT
 Die Member pszText und cchTextMax sind gültig.
HDI_WIDTH
 Das cxy-Element 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 verweisen. Wenn dieses Element auf LPSTR_TEXTCALLBACK festgelegt ist, fordert das Steuerelement Textinformationen für dieses Element an, indem es einen HDN_GETDISPINFO Benachrichtigungscode sendet. Beachten Sie, dass zwar mit dem Headersteuerelement eine beliebige Zeichenfolge als Elementtext gespeichert werden kann, aber nur die ersten 260 TCHARs angezeigt werden.

hbm

Typ: HBITMAP

Ein Handle für die Bitmap des Elements.

cchTextMax

Typ: int

Die Länge der Elementzeichenfolge in TCHARs. Wenn der Text aus dem Steuerelement abgerufen wird, muss dieses Element die Anzahl von TCHARs an der von pszText angegebenen Adresse enthalten.

fmt

Typ: int

Flags, die das Format des Elements angeben.

Wert Bedeutung
Textbegründung:
 Legen Sie eines der folgenden Flags fest, um die Textbegründung anzugeben:
HDF_CENTER
 Der Inhalt des Elements ist zentriert.
HDF_LEFT
 Der Inhalt des Elements ist linksbündig ausgerichtet.
HDF_RIGHT
 Der Inhalt des Elements ist rechtsbündig.
Anzeigen:
 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 Headersteuerelements zeichnet das Element.
HDF_STRING
 Das Element zeigt eine Zeichenfolge an.
Kombinieren von Flags:
 Der vorherige Wert kann mit 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-Member dieser Struktur an.
HDF_JUSTIFYMASK
 Isolieren Sie die Bits, die den drei Begründungsflags entsprechen, die in der vorherigen Tabelle aufgeführt sind.
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 derselben Richtung gelesen wie der Text im übergeordneten Fenster. Wenn HDF_RTLREADING festgelegt ist, liest der Kopfzeilentext in entgegengesetzter Richtung vom Text im übergeordneten Fenster.
HDF_SORTDOWN

Version 6.00 und höher. Zeichnet einen Pfeil nach unten für dieses Element. Dies wird in der Regel verwendet, um anzugeben, dass Die Informationen im aktuellen Fenster in absteigender Reihenfolge nach dieser Spalte sortiert werden. Dieses Flag kann nicht mit HDF_IMAGE oder HDF_BITMAP kombiniert werden.
HDF_SORTUP

Version 6.00 und höher. Zeichnet einen Pfeil nach oben für dieses Element. Dies wird in der Regel verwendet, um anzugeben, dass Informationen im aktuellen Fenster in aufsteigender Reihenfolge nach dieser Spalte sortiert werden. Dieses Flag 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 Headersteuerelement festgelegt wird.
HDF_CHECKED

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

Version 6.00 und höher. Die Breite des Elements kann von einer Benutzeraktion zum Ändern der Größe nicht geändert werden.
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 innerhalb der Bildliste. Das angegebene Bild wird im Headerelement zusätzlich zu allen im hbm-Feld angegebenen Bildern 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 Headersteuerelement von links nach rechts angezeigt wird. Das heißt, der Wert für das element ganz links ist 0. Der Wert für das nächste Element rechts ist 1 usw.

type

Typ: UINT

Der von pvFilter angegebene Filtertyp. Folgende Typen sind möglich:

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 Datenfiltertyp wird durch Festlegen des Flagwerts des Members bestimmt. Verwenden Sie das Flag HDFT_ISSTRING, 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

Das Land/die Region. Der einzige gültige, unterstützte Wert für dieses Element ist folgendes:

Wert Bedeutung
HDIS_FOCUSED
 Das Element verfügt über den Tastaturfokus.

Hinweise

Beachten Sie Comctl32.dll Version 6 nicht verteilbar, aber in Windows enthalten ist. Um Comctl32.dll Version 6 zu verwenden, geben Sie sie in einem Manifest an. Weitere Informationen zu Manifesten finden Sie unter Aktivieren von visuellen Formatvorlagen.
 

Hinweis

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
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Kopfzeile commctrl.h