macro TabCtrl_GetItem (commctrl.h)

Recupera informazioni su una scheda in un controllo struttura a schede. È possibile utilizzare questa macro o inviare il messaggio di TCM_GETITEM in modo esplicito.

Sintassi

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

Parametri

hwnd

Tipo: HWND

Handle per il controllo struttura a schede.

iItem

Tipo: int

Indice della scheda.

pitem

Tipo: LPTCITEM

Puntatore a una struttura TCITEM che specifica le informazioni da recuperare e ricevere informazioni sulla scheda. Quando il messaggio viene inviato, il membro maschera specifica gli attributi da restituire. Se il membro maschera 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

Tipo: BOOL

Restituisce TRUE in caso di esito positivo oppure FALSE in caso contrario.

Osservazioni

Se il flag TCIF_TEXT viene impostato nella maschera membro 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.

Fabbisogno