TCITEMA-Struktur (commctrl.h)

Artikel
08/22/2023

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

Syntax

typedef struct tagTCITEMA {
  UINT   mask;
  DWORD  dwState;
  DWORD  dwStateMask;
  LPSTR  pszText;
  int    cchTextMax;
  int    iImage;
  LPARAM lParam;
} TCITEMA, *LPTCITEMA;

Member

mask

Typ: UINT

Wert, der angibt, welche Member abgerufen oder festgelegt werden sollen. Dieser Member 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 Status von Registerkartensteuerelementelementen finden Sie unter Tab-Steuerelementelementstatus. Dieser Member wird in der TCM_INSERTITEM-Nachricht ignoriert.

dwStateMask

Typ: DWORD

Version 4.70. Gibt an, welche Bits des dwState-Elements gültige Informationen enthalten. Dieser Member 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 dieser Member die Adresse des Puffers an, der den Registerkartentext empfängt.

cchTextMax

Typ: int

Größe in TCHARs des Puffers , auf den der pszText-Member verweist. Wenn die Struktur keine Informationen empfängt, wird dieser Member 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 Byte anwendungsdefinierter 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.

Hinweise

In der Regel zeigen Fenster Text von links nach rechts (LTR) an. Fenster können in Anzeigesprachen wie Hebräisch oder Arabisch gespiegelt werden, die von rechts nach links (RTL) gelesen werden. Normalerweise wird pszText in derselben Richtung wie der Text im übergeordneten Fenster angezeigt. Wenn TCIF_RTLREADING festgelegt ist, liest pszText in entgegengesetzter 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 Code, der nicht Codierungsneutral ist, 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