CTabCtrl::GetItem

Articolo
02/19/2013

Recupera informazioni su una scheda in un controllo scheda.

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

Parametri

nItem
Indice a base zero della scheda.
pTabCtrlItem
Puntatore a una struttura TCITEM, utilizzata per specificare le informazioni da recuperare.Utilizzata inoltre per ottenere informazioni sulla scheda.Questa struttura viene utilizzata con InsertItem, GetItemle funzioni membro e SetItem.

Valore restituito

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

Note

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

maschera
Stimare specificare che i membri di struttura TCITEM da recuperare o impostare.Questo membro può essere zero o una combinazione dei valori seguenti:
- TCIF_TEXT il membro pszText è valido.
- TCIF_IMAGE il membro iImage è valido.
- TCIF_PARAM il membro lParam è valido.
- TCIF_RTLREADING il testo pszText visualizzati utilizzando l'ordine di lettura da destra a sinistra nei sistemi l'arabo o l'ebraico.
- TCIF_STATE il membro dwState è valido.
pszText
Puntatore a una stringa con terminazione null che contiene il testo della scheda se la struttura contiene informazioni su una scheda.Se la struttura riceve informazioni, questo membro specifica l'indirizzo del buffer che riceve il testo della scheda.
cchTextMax
La dimensione del buffer indicato da pszText.Questo membro viene ignorato se la struttura non riceve le informazioni.
iImage
Indice nell'elenco immagini del controllo Struttura a schede, o – 1 se non esiste un'immagine per la scheda.
lParam
Dati definiti dall'applicazione associati alla scheda.Se esiste più di quattro byte di dati definiti dall'applicazione per scheda, un'applicazione deve definire una struttura e utilizzarla invece della 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 struttura e la dimensione della struttura TCITEMHEADER deve essere uguale al numero di byte aggiuntivi per scheda.

Esempio

// In this example a CTabCtrl data member, m_TabCtrl, changes the
// text of the tabs in the tab control.  A call to GetItem is used
// to get the current text, and then the text is changed.  A call 
// to SetItem is used to update the tab with the new text.

void CTabDlg::OnChangeItem()
{
   TCITEM tcItem;
   CString pszString;

   //  Get text for the tab item.
   GetDlgItemText(IDC_ITEM_TEXT, pszString);

   //  Get the current tab item text.
   TCHAR buffer[256] = {0};
   tcItem.pszText = buffer;
   tcItem.cchTextMax = 256;
   tcItem.mask = TCIF_TEXT;
   m_TabCtrl.GetItem(0, &tcItem);
   TRACE(_T("Changing item text from %s to %s..."), tcItem.pszText, pszString);

   //  Set the new text for the item.
   tcItem.pszText = pszString.LockBuffer();

   //  Set the item in the tab control.
   m_TabCtrl.SetItem(0, &tcItem);

   pszString.UnlockBuffer();
}