CTabCtrl::GetItem

Artykuł
02/27/2013

Pobiera informacje o karcie formantu karty.

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

Parametry

nItem
Indeksu karty.
pTabCtrlItem
Wskaźnik do TCITEM struktury służy do określania informacji do pobrania.Umożliwia również otrzymywać informacje o karcie.Ta struktura jest używany z InsertItem, GetItem, i SetItem funkcji elementów członkowskich.

Wartość zwracana

Zwraca TRUE w przypadku powodzenia; FALSE inaczej.

Uwagi

Gdy wysyłana jest wiadomość, maski Członkowskich określa, które atrybuty, aby powrócić.Jeśli maski Członkowskich Określa TCIF_TEXT wartości, pszText Członkowskich musi zawierać adres buforu, który odbiera tekst elementu i cchTextMax Członkowskie należy określić rozmiar buforu.

Maska
Wartości określające, które TCITEM struktury członków, aby pobrać lub ustawić.Ten element może być zero lub kombinacją następujących wartości:
- TCIF_TEXTPszText Członkowskich jest prawidłowy.
- TCIF_IMAGEiImage Członkowskich jest prawidłowy.
- TCIF_PARAMLParam Członkowskich jest prawidłowy.
- TCIF_RTLREADINGTekst pszText jest wyświetlany przy użyciu kolejność czytania od prawej do lewej w systemach języka hebrajskiego lub arabskiego.
- TCIF_STATEDwState Członkowskich jest prawidłowy.
pszText
Wskaźnik na tekst kartę struktury zawiera informacje o karcie ciąg zakończony znakiem null.Jeśli struktura odbiera informacje, członek ten określa adres buforu, który odbiera kartę tekst.
cchTextMax
Rozmiar buforu wskazywanej przez pszText.Członek ten jest ignorowany, jeśli struktura nie odbiera informacje.
iImage
Indeks do formantu karty listy obrazu lub -1, jeśli nie ma żadnego obrazu na karcie.
lParam
Definicja aplikacji dane skojarzone z karcie.W przypadku więcej niż czterech bajtów danych przez aplikację na karcie aplikacji należy zdefiniować strukturę i użyj jej zamiast TCITEM struktury.Pierwszy członek struktury definicja aplikacji musi być TCITEMHEADERstruktury.TCITEMHEADER struktura jest identyczne z TCITEM struktury, ale bez lParam Członkowskich.Różnica między rozmiar struktury i rozmiar TCITEMHEADER struktury powinna być równa liczbę dodatkowych bajtów na karcie.

Przykład

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