TCITEMHEADERW-Struktur (commctrl.h)

Gibt die Attribute einer Registerkarte an oder empfängt diese. Sie wird mit den nachrichten TCM_INSERTITEM, TCM_GETITEM und TCM_SETITEM verwendet. Diese Struktur ersetzt die TC_ITEMHEADER-Struktur .

Syntax

typedef struct tagTCITEMHEADERW {
  UINT   mask;
  UINT   lpReserved1;
  UINT   lpReserved2;
  LPWSTR pszText;
  int    cchTextMax;
  int    iImage;
} TCITEMHEADERW, *LPTCITEMHEADERW;

Member

mask

Typ: UINT

Wert, der angibt, welche Member abgerufen oder festgelegt werden sollen. Dieses Element kann eine Kombination der folgenden Werte sein:

Wert	Bedeutung
TCIF_IMAGE	Das iImage-Element ist gültig.
TCIF_RTLREADING	Die Zeichenfolge, auf die von pszText verwiesen wird, wird in der Richtung angezeigt, die dem Text im übergeordneten Fenster entgegengesetzt ist.
TCIF_TEXT	Das pszText-Element ist gültig.

lpReserved1

Typ: UINT

Reserviertes Mitglied. Darf nicht verwendet werden.

lpReserved2

Typ: UINT

Reserviertes Mitglied. Darf nicht verwendet werden.

pszText

Typ: LPTSTR

Adresse einer null-beendeten Zeichenfolge, die den Registerkartentext enthält, wenn Elementinformationen festgelegt werden. Wenn Elementinformationen abgerufen werden, gibt dieses Element die Adresse des Puffers an, der den Registerkartentext empfängt.

cchTextMax

Typ: int

Größe des Puffers, auf den das pszText-Element verweist. Wenn die Struktur keine Informationen empfängt, wird dieses Element ignoriert.

iImage

Typ: int

Indizieren Sie in die Bildliste des Registerkartensteuerelements oder -1, wenn kein Bild für die Registerkarte vorhanden ist.

Hinweise

In der Regel zeigen Fenster Text von links nach rechts (LTR) an. Windows kann gespiegelt werden, um Sprachen wie Hebräisch oder Arabisch anzuzeigen, die von rechts nach links (RTL) gelesen werden. Normalerweise wird pszText in der gleichen Richtung wie der Text im übergeordneten Fenster angezeigt. Wenn TCIF_RTLREADING festgelegt ist, liest pszText in umgekehrter Richtung vom Text im übergeordneten Fenster.

Hinweis

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

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