TCM_GETITEM Nachricht

Ruft Informationen zu einer Registerkarte in einem Registerkartensteuerelement ab. Sie können diese Nachricht explizit oder mithilfe des makros TabCtrl_GetItem senden.

Parameter

wParam

Index der Registerkarte.

lParam

Zeiger auf eine TCITEM-Struktur , die die Informationen angibt, die abgerufen werden sollen, und empfängt Informationen zur Registerkarte. 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

Gibt TRUE zurück, wenn der Vorgang erfolgreich war, oder andernfalls FALSE .

Bemerkungen

Wenn das TCIF_TEXT-Flag im Maskenelement der TCITEM-Struktur festgelegt ist, kann das Steuerelement das element pszText der Struktur so ändern, dass es 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