TabCtrl_GetItem Makro (commctrl.h)

Ruft Informationen zu einer Registerkarte in einem Registerkartensteuerelement ab. Sie können dieses Makro verwenden oder die TCM_GETITEM Nachricht explizit senden.

Syntax

void TabCtrl_GetItem(
   hwnd,
   iItem,
   pitem
);

Parameter

hwnd

Typ: HWND

Handle für das Registerkartensteuerelement.

iItem

Typ: int

Index der Registerkarte.

pitem

Typ: LPTCITEM

Zeiger auf eine TCITEM-Struktur , die die abzurufenden Informationen angibt und Informationen über die Registerkarte empfängt. Wenn die Nachricht gesendet wird, gibt das Maskenelement an, welche Attribute zurückgegeben werden sollen. Wenn das Maskenelement den TCIF_TEXT Wert angibt, muss das pszText-Element die Adresse des Puffers enthalten, der den Elementtext empfängt, und das cchTextMax-Element muss die Größe des Puffers angeben.

Rückgabewert

Keine

Bemerkungen

Wenn das flag TCIF_TEXT im Maskenelement der TCITEM-Struktur festgelegt ist, kann das Steuerelement den pszText-Member der Struktur so ändern, dass er auf den neuen Text verweist, anstatt den Puffer mit dem angeforderten Text zu füllen. Das Steuerelement kann den pszText-Member auf NULL festlegen, um anzugeben, dass dem Element kein Text zugeordnet ist.

Anforderungen

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