CTabCtrl::GetItem

Статья
02/20/2013

Извлекает сведения о вкладке в наборе вкладок.

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

Параметры

nItem
Индекс, начинающийся с нуля перехода по клавише TAB.
pTabCtrlItem
Указатель на структуру TCITEM, используемой для указания сведений для извлечения.Также используемый для получения сведений о вкладке.Эта структура используется с InsertItem, GetItem и функции-членами SetItem.

Возвращаемое значение

Возвращает TRUE, если успешно; FALSE в противном случае.

Заметки

Если сообщение отправлено участник MASK указывает атрибуты, которые должны быть возвращены.Если участник MASK задает значение TCIF_TEXT, то элемент pszText должен содержать адрес буфера, который получает текст элемента и участник cchTextMax должен определить размер буфера.

маска
Значение, указывающее, что члены структуры TCITEM, который требуется получить или задать.Этот элемент может иметь ноль или сочетанием следующих значений:
- TCIF_TEXT элемент pszText допустимо.
- TCIF_IMAGE элемент iImage допустимо.
- TCIF_PARAM элемент lParam допустимо.
- TCIF_RTLREADING текст pszText показано использование порядок чтения справа налево в древнееврейских или арабских системах.
- TCIF_STATE элемент dwState допустимо.
pszText
Указатель на null- завершенной строку, содержащую текст вкладки, если структура содержит сведения о вкладке.Если структура возвращает сведения, то этот элемент задает адрес буфера, который получает текст вкладки.
cchTextMax
Размер буфера указал на pszText.Этот член игнорировать, если структура не возвращает сведений.
iImage
Индекс в списке образа набор вкладок или – 1, если образ для вкладки.
lParam
Приложение- указанные данные, связанные с вкладкой.Если более чем 4 байт приложение- указанных данных на вкладке приложение должно определить структуру и использовать его вместо структуры TCITEM.Первый элемент приложение- указанной структуры должны быть структурой TCITEMHEADER.Структура TCITEMHEADER идентична структуре TCITEM, но без элемента lParam.Разница между размером вашей структуры и размер структуры TCITEMHEADER должно равняться количество дополнительных байтов на вкладке.

Пример

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