TCITEMW-Struktur (commctrl.h)

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

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:

dwState

Typ: DWORD-

Version 4.70. Gibt den aktuellen Status des Elements an, wenn Informationen abgerufen werden. Wenn Elementinformationen festgelegt werden, enthält dieses Element den Statuswert, der für das Element festgelegt werden soll. Eine Liste der gültigen Status des Registerkartensteuerelementelements finden Sie unter Status des Registersteuerelementelements. Dieses Mitglied wird in der TCM_INSERTITEM Nachricht ignoriert.

dwStateMask

Typ: DWORD-

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

pszText

Typ: LPTSTR-

Zeigen Sie auf eine mit Null beendete Zeichenfolge, die den Tabstopptext 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 keine Abbildung für die Registerkarte vorhanden ist.

lParam

Typ: LPARAM-

Anwendungsdefinierte Daten, die dem Registerkartensteuerelementelement zugeordnet sind. Wenn mehr als 4 Byte anwendungsdefinierte Daten pro Registerkarte vorhanden sind, muss eine Anwendung eine Struktur definieren und anstelle der TCITEM- Struktur verwenden. Das erste Mitglied 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. 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