messaggio TCM_GETITEM

Recupera informazioni su una scheda in un controllo struttura a schede. È possibile inviare questo messaggio in modo esplicito o utilizzando la macro TabCtrl_GetItem .

Parametri

wParam

Indice della scheda.

lParam

Puntatore a una struttura TCITEM che specifica le informazioni da recuperare e ricevere informazioni sulla scheda. Quando il messaggio viene inviato, il membro mask specifica gli attributi da restituire. Se il membro mask specifica il valore TCIF_TEXT, il membro pszText deve contenere l'indirizzo del buffer che riceve il testo dell'elemento e il membro cchTextMax deve specificare le dimensioni del buffer.

Valore restituito

Restituisce TRUE se l'operazione riesce o FALSE in caso contrario.

Commenti

Se il flag TCIF_TEXT è impostato nel membro mask della struttura TCITEM , il controllo può modificare il membro pszText della struttura in modo che punti al nuovo testo anziché riempire il buffer con il testo richiesto. Il controllo può impostare il membro pszText su NULL per indicare che all'elemento non è associato alcun testo.

Requisiti

Requisito Valore
Client minimo supportato
Windows Vista [solo app desktop]
Server minimo supportato
Windows Server 2003 [solo app desktop]
Intestazione
Commctrl.h
Nomi Unicode e ANSI
TCM_GETITEMW (Unicode) e TCM_GETITEMA (ANSI)