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:

Wert	Bedeutung
TCIF_IMAGE	Das iImage-Element ist gültig.
TCIF_PARAM	Das lParam-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_STATE	Version 4.70. Das dwState-Element ist gültig.
TCIF_TEXT	Das pszText-Element ist gültig.

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.

Hinweis

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

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