CTabCtrl::GetItem

BOOL GetItem ( int nItem, TCITEM * pTabCtrlItem ) const;

Valore restituito

Restituisce TRUE se successo; Falso altrimenti.

Parametri

nItem

Indice in base zero della scheda.

pTabCtrlItem

Puntatore a un struttura TCITEM , utilizzato per specificare le informazioni da recuperare. Utilizzato anche per ricevere informazioni sulla scheda. Questa struttura è utilizzata con le funzioni membro InsertItem, GetIteme SetItem.

Osservazioni

Chiamare questa funzione per recuperare informazioni su una scheda in un controllo struttura a schede.

Quando il messaggio viene inviato, il membro maschera specifica gli attributi che 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 la dimensione del buffer.

maschera

Valore che specifica quali membri di struttura TCITEM per recuperare o impostare. Questo membro può essere zero o una combinazione dei seguenti valori:

• TCIF_TEXT   Il membro pszText è valido.
  
  
• TCIF_IMAGE   Il membro membri iImage è valido.
  
  
• TCIF_PARAM   Il membro lParam è valido.
  
  
• TCIF_RTLREADI&NGnbsp;  Viene visualizzato il testo di pszText utilizzando l'ordine di lettura da destra a sinistra su sistemi ebraico o arabo.
  
  
• TCIF_STATE   Il membro dwState è valido.

pszText

Puntatore a una stringa null-terminated contenente il testo della scheda, se la struttura contiene informazioni su una scheda. Se la struttura sta ricevendo informazioni, questo membro specifica l'indirizzo del buffer che riceve il testo della scheda.

cchTextMax

Dimensione del buffer a cui punta pszText. Questo membro viene ignorato se la struttura non riceve informazioni.

membri iImage

I&ndice in elenco immagini del controllo struttura a schede, ornbsp; -1 se non non c'è nessuna immagine per la scheda.

lParam

Dati definiti dall'applicazione associati con la scheda. Se ci sono più di quattro byte di dati definiti dall'applicazione per scheda, un'applicazione deve definire una struttura e uso anziché la struttura TCITEM . Il primo membro della struttura definita dall'applicazione deve essere una struttura TCITEMHEADER . La struttura TCITEMHEADER è identica alla struttura TCITEM , ma senza il membro lParam . La differenza tra la dimensione della vostra struttura e le dimensioni della struttura TCITEMHEADER deve essere uguale al numero di byte supplementari per scheda.

Pa&noramica CTabCtrl |nbsp; Membri della classe | Gerarchia Chart

Vedere a&nchenbsp;CTabCtrl::InsertItem, CTabCtrl::SetItem