CTabCtrl::GetItem

Článek
06/10/2015

Načte informace o kartě v ovládacím prvku karta.

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

Parametry

nItem
Z nuly vycházející index karty.
pTabCtrlItem
Ukazatel TCITEM struktury, zadejte informace, které chcete načíst.Lze také zobrazit informace o kartě.Tato struktura se používá se InsertItem , GetItem , a SetItem funkce členů.

Vrácená hodnota

Vrátí TRUE v případě úspěchu; FALSE jinak.

Poznámky

Při odesílání zprávy Maska člena Určuje atributy, které chcete vrátit.Pokud Maska určuje členský TCIF_TEXT hodnotu, pszText člen musí obsahovat adresu vyrovnávací paměti, která obdrží text položky a cchTextMax člena musíte zadat velikost vyrovnávací paměti.

Maska
Hodnota určující, které TCITEM struktury členů načíst nebo nastavení.Tento člen může být nula nebo kombinací následujících hodnot:
- TCIF_TEXTPszText je platný.
- TCIF_IMAGE iImage Je platný.
- TCIF_PARAMLParam je platný.
- TCIF_RTLREADINGText pszText je zobrazena pomocí směr čtení zprava doleva v systémech pro hebrejštinu a arabštinu.
- TCIF_STATEDwState je platný.
pszText
Ukazatel na řetězec zakončený obsahující text kartu, pokud struktura obsahuje informace o kartě.Pokud struktura přijímá informace, tento člen Určuje adresu vyrovnávací paměti, která obdrží kartu text.
cchTextMax
Velikost vyrovnávací paměti odkazuje pszText.Pokud struktura není příjem informací, bude tato vlastnost ignorována.
iImage
Index do ovládacího prvku karta seznam obrázků nebo -1, pokud není žádný obrázek karty.
lParam
Definované aplikací data spojená s kartou.Pokud existují více než čtyři bajty dat definované aplikací na kartě, musíte definovat strukturu a použít místo aplikace TCITEM struktury.První člen struktury definované aplikací musí být TCITEMHEADERstruktury.TCITEMHEADER struktura je totožná TCITEM struktury, ale bez lParam člen.Rozdíl mezi velikostí struktury a velikost TCITEMHEADER struktura by měla být rovna počtu bajtů navíc na kartě.

Příklad

// 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();
}