TCITEMHEADERW-Struktur (commctrl.h)

Gibt die Attribute einer Registerkarte an oder empfängt sie. Sie wird mit den nachrichten TCM_INSERTITEM, TCM_GETITEMund 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;

Angehörige

mask

Typ: UINT-

Wert, der angibt, welche Elemente abgerufen oder festgelegt werden sollen. Dieses Element kann eine Kombination aus den folgenden Werten sein:

lpReserved1

Typ: UINT-

Reserviertes Mitglied. Nicht verwenden.

lpReserved2

Typ: UINT-

Reserviertes Mitglied. Nicht verwenden.

pszText

Typ: LPTSTR-

Adresse einer mit 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

Index in der Bildliste des Registerkartensteuerelements oder -1, wenn keine Abbildung für die Registerkarte vorhanden ist.

Bemerkungen

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. Ordinarily, pszText wird in der gleichen Richtung wie der Text im übergeordneten Fenster angezeigt. Wenn TCIF_RTLREADING festgelegt ist, liest pszText- in entgegengesetzter Richtung aus dem Text im übergeordneten Fenster.

Anforderungen