TCITEMW-Struktur (commctrl.h)

Gibt die Attribute eines Registerkartenelements an oder empfängt sie. Sie wird mit den nachrichten TCM_INSERTITEM, TCM_GETITEM und TCM_SETITEM verwendet. Diese Struktur ersetzt die TC_ITEM-Struktur .

Syntax

typedef struct tagTCITEMW {
  UINT   mask;
  DWORD  dwState;
  DWORD  dwStateMask;
  LPWSTR pszText;
  int    cchTextMax;
  int    iImage;
  LPARAM lParam;
} TCITEMW, *LPTCITEMW;

Member

mask

Typ: UINT

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

dwState

Typ: DWORD

Version 4.70. Gibt den aktuellen Status des Elements an, wenn Informationen abgerufen werden. Wenn Elementinformationen festgelegt werden, enthält dieser Member den Zustandswert, der für das Element festgelegt werden soll. Eine Liste der gültigen Registerkarten-Steuerelementelementzustände finden Sie unter Tabulatorsteuerungselementzustände. Dieses Element wird in der TCM_INSERTITEM-Nachricht ignoriert.

dwStateMask

Typ: DWORD

Version 4.70. Gibt an, welche Bits des dwState-Members gültige Informationen enthalten. Dieses Element wird in der TCM_INSERTITEM-Nachricht ignoriert.

pszText

Typ: LPTSTR

Zeiger auf eine NULL-beendete 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 in TCHARs 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 kein Bild für die Registerkarte vorhanden ist.

lParam

Typ: LPARAM

Anwendungsdefinierte Daten, die dem Steuerelementelement der Registerkarte zugeordnet sind. Wenn mehr oder weniger als 4 Bytes anwendungsdefinierte Daten pro Registerkarte vorhanden sind, muss eine Anwendung eine Struktur definieren und diese anstelle der TCITEM-Struktur verwenden. Das erste Element der anwendungsdefinierten Struktur muss eine TCITEMHEADER-Struktur sein.

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.

Anforderungen