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

BOOL TabCtrl_GetItem(
   HWND     hwnd,
   int      iItem,
   LPTCITEM pitem
);

Parameter

hwnd

Typ: HWND-

Behandeln sie das Registersteuerelement.

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 Mask Element an, welche Attribute zurückgegeben werden sollen. Wenn das Mask Element den TCIF_TEXT-Wert angibt, muss das pszText-element die Adresse des Puffers enthalten, der den Elementtext empfängt, und das cchTextMax Member muss die Größe des Puffers angeben.

Rückgabewert

Typ: BOOL-

Gibt TRUE zurück, wenn dies erfolgreich ist, oder FALSE andernfalls.

Bemerkungen

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

Anforderungen