Класс CTabCtrl

Предоставляет функциональные возможности стандартного элемента управления "вкладка" Windows.

Синтаксис

class CTabCtrl : public CWnd

Участники

Открытые конструкторы

Имя	Описание
CTabCtrl::CTabCtrl	Формирует объект CTabCtrl.

Открытые методы

Имя	Описание
CTabCtrl::AdjustRect	Вычисляет область отображения элемента управления табуляции с учетом прямоугольника окна или вычисляет прямоугольник окна, соответствующий заданной области отображения.
CTabCtrl::Create	Создает элемент управления tab и присоединяет его к экземпляру TabCtrl объекта
CTabCtrl::CreateEx	Создает элемент управления tab с указанными расширенными стилями Windows и присоединяет его к экземпляру CTabCtrl объекта.
CTabCtrl::DeleteAllItems	Удаляет все элементы из элемента управления вкладки.
CTabCtrl::DeleteItem	Удаляет элемент из элемента управления табуляции.
CTabCtrl::DeselectAll	Сбрасывает элементы в элементе управления табуляции, очищая все, которые были нажаты.
CTabCtrl::DrawItem	Рисует указанный элемент элемента управления табуляции.
CTabCtrl::GetCurFocus	Извлекает вкладку с текущим фокусом элемента управления табуляции.
CTabCtrl::GetCurSel	Определяет выбранную в данный момент вкладку в элементе управления табуляции.
CTabCtrl::GetExtendedStyle	Извлекает расширенные стили, которые в настоящее время используются для элемента управления tab.
CTabCtrl::GetImageList	Извлекает список изображений, связанный с элементом управления tab.
CTabCtrl::GetItem	Извлекает сведения о вкладке в элементе управления табуляции.
CTabCtrl::GetItemCount	Извлекает число вкладок в наборе вкладок.
CTabCtrl::GetItemRect	Извлекает ограничивающий прямоугольник для вкладки в элементе управления tab.
CTabCtrl::GetItemState	Извлекает состояние указанного элемента управления табуляции.
CTabCtrl::GetRowCount	Извлекает текущее количество строк вкладок в элементе управления табуляции.
CTabCtrl::GetToolTips	Извлекает дескриптор элемента управления подсказкой средства, связанного с элементом управления tab.
CTabCtrl::HighlightItem	Задает состояние выделения элемента вкладки.
CTabCtrl::HitTest	Определяет, какая вкладка, если она есть, находится в указанной позиции экрана.
CTabCtrl::InsertItem	Вставляет новую вкладку в элемент управления вкладки.
CTabCtrl::RemoveImage	Удаляет изображение из списка изображений элемента управления табуляции.
CTabCtrl::SetCurFocus	Задает фокус на указанную вкладку в элементе управления табуляции.
CTabCtrl::SetCurSel	Выбирает вкладку в элементе управления вкладкой.
CTabCtrl::SetExtendedStyle	Задает расширенные стили для элемента управления tab.
CTabCtrl::SetImageList	Назначает список изображений элементу управления tab.
CTabCtrl::SetItem	Задает некоторые или все атрибуты вкладки.
CTabCtrl::SetItemExtra	Задает количество байтов на вкладку, зарезервированное для данных, определенных приложением, в элементе управления табуляции.
CTabCtrl::SetItemSize	Задает ширину и высоту элемента.
CTabCtrl::SetItemState	Задает состояние указанного элемента управления вкладки.
CTabCtrl::SetMinTabWidth	Задает минимальную ширину элементов в элементе управления табуляции.
CTabCtrl::SetPadding	Задает объем пространства (заполнение) вокруг каждого значка вкладок и метки в элементе управления табуляции.
CTabCtrl::SetToolTips	Назначает элементу управления подсказки средства элементу управления tab.

Замечания

Элемент управления tab аналогиен разделителям в записной книжке или меткам в файловом шкафу. С помощью элемента управления "Вкладка" приложение может определить несколько страниц для одной области окна или диалогового окна. Каждая страница состоит из набора сведений или группы элементов управления, отображаемых приложением при выборе соответствующей вкладки. Специальный тип элемента управления вкладками отображает вкладки, которые выглядят как кнопки. Нажатие кнопки должно немедленно выполнить команду вместо отображения страницы.

Этот элемент управления (и, следовательно CTabCtrl , класс) доступен только для программ под управлением Windows 95/98 и Windows NT версии 3.51 и более поздних версий.

Дополнительные сведения см. в CTabCtrlразделе "Элементы управления" и "ИспользованиеCTabCtrl".

Иерархия наследования

CObject
CCmdTarget
CWnd

CTabCtrl

Требования

Заголовок: afxcmn.h

CTabCtrl::AdjustRect

Вычисляет область отображения элемента управления табуляции с учетом прямоугольника окна или вычисляет прямоугольник окна, соответствующий заданной области отображения.

void AdjustRect(BOOL bLarger,   LPRECT lpRect);

Параметры

bLarger
Указывает, какая операция требуется выполнить. Если этот параметр имеет значение TRUE, lpRect указывает прямоугольник отображения и получает соответствующий прямоугольник окна. Если этот параметр имеет значение FALSE, lpRect задает прямоугольник окна и получает соответствующий прямоугольник отображения.

lpRect
Указатель на структуру, задающую заданный RECT прямоугольник и получающий вычисляемый прямоугольник.

Пример

void CTabDlg::OnSize(UINT nType, int cx, int cy)
{
   CDialog::OnSize(nType, cx, cy);

   if (m_TabCtrl.m_hWnd == NULL)
      return; // Return if window is not created yet.

   RECT rect;

   // Get size of dialog window.
   GetClientRect(&rect);

   // Adjust the rectangle to fit the tab control into the
   // dialog's client rectangle.
   m_TabCtrl.AdjustRect(FALSE, &rect);

   // Move the tab control to the new position and size.
   m_TabCtrl.MoveWindow(&rect, TRUE);
}

CTabCtrl::Create

Создает элемент управления tab и присоединяет его к экземпляру CTabCtrl объекта.

virtual BOOL Create(
    DWORD dwStyle,
    const RECT& rect,
    CWnd* pParentWnd,
    UINT nID);

Параметры

dwStyle
Задает стиль элемента управления tab. Примените любое сочетание стилей элементов управления табуляции, описанных в пакете SDK для Windows. См . примечания для списка стилей окон, которые можно также применить к элементу управления.

rect
Указывает размер и позицию элемента управления tab. Это может быть CRect объект или RECT структура.

pParentWnd
Указывает родительское окно элемента управления вкладки, как правило, .CDialog Это не должно быть NULL.

nID
Указывает идентификатор элемента управления tab.

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

TRUE Значение , если инициализация объекта выполнена успешно; в противном случае FALSE.

Замечания

Вы создаете CTabCtrl объект на двух шагах. Сначала вызовите конструктор, а затем вызов Create, который создает элемент управления tab и присоединяет его к объекту CTabCtrl .

Помимо стилей элементов управления вкладками можно применить следующие стили окон к элементу управления tab:

• WS_CHILD: создает дочернее окно, представляющее элемент управления вкладки. Нельзя использовать с стилем WS_POPUP.
• WS_VISIBLE: создает элемент управления tab, который изначально отображается.
• WS_DISABLED: создает окно, которое изначально отключено.
• WS_GROUP: указывает первый элемент управления группы элементов управления, в котором пользователь может перейти от одного элемента управления к следующему с помощью клавиш со стрелками. Все элементы управления, определенные с помощью WS_GROUPстиля: после первого элемента управления принадлежат одной группе. Следующий элемент управления со WS_GROUPстилем заканчивает группу стилей и запускает следующую группу (то есть одна группа заканчивается, где начинается следующая).
• WS_TABSTOP: указывает одно из всех элементов управления, с помощью которого пользователь может перемещаться с помощью клавиши TAB. Клавиша TAB перемещает пользователя к следующему элементу управления, указанному в WS_TABSTOPстиле : .

Чтобы создать элемент управления tab с расширенными стилями окон, вызовите CTabCtrl::CreateEx вместо Createнего.

Пример

// Assuming you have a member variable m_TabCtrl, that is a CTabCtrl
// object, you can use the following to create a tab control.

m_TabCtrl.Create(TCS_TABS | TCS_FIXEDWIDTH | WS_CHILD | WS_VISIBLE,
                 rect, this, IDC_MYTAB);

// This creates a tab control with the given styles, and with
// an ID of IDC_MYTAB.

CTabCtrl::CreateEx

Создает элемент управления (дочернее окно) и связывает его с CTabCtrl объектом.

virtual BOOL CreateEx(
    DWORD dwExStyle,
    DWORD dwStyle,
    const RECT& rect,
    CWnd* pParentWnd,
    UINT nID);

Параметры

dwExStyle
Задает расширенный стиль создаваемого элемента управления. Список расширенных стилей Windows см dwExStyle . в параметре CreateWindowEx пакета SDK для Windows.

dwStyle
Задает стиль элемента управления tab. Примените любое сочетание стилей элементов управления табуляции, описанных в пакете SDK для Windows. См . примечания Create в списке стилей окон, которые можно также применить к элементу управления.

rect
Ссылка на RECT структуру, описывающую размер и положение создаваемого окна в координатах pParentWndклиента.

pParentWnd
Указатель на окно, которое является родительским элементом элемента управления.

nID
Идентификатор дочернего окна элемента управления.

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

Ненулевое значение в противном случае — значение 0.

Замечания

Используйте CreateEx вместо Create применения расширенных стилей Windows, указанных предисловием WS_EX_расширенного стиля Windows.

CreateEx создает элемент управления с расширенными стилями Windows, указанными dwExStyle. Задайте расширенные стили, относящиеся к элементу управления, с помощью SetExtendedStyle. Например, используйте CreateEx для задания таких стилей, как WS_EX_CONTEXTHELP, но используйте SetExtendedStyle для задания таких стилей, как TCS_EX_FLATSEPARATORS. Дополнительные сведения см. в стилях, описанных в разделе "Расширенные стили элемента управления tab" в пакете SDK для Windows.

CTabCtrl::CTabCtrl

Формирует объект CTabCtrl.

CTabCtrl();

CTabCtrl::DeleteAllItems

Удаляет все элементы из элемента управления вкладки.

BOOL DeleteAllItems();

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

Имеет ненулевое значение в случае успешного выполнения, иначе — 0.

CTabCtrl::DeleteItem

Удаляет указанный элемент из элемента управления tab.

BOOL DeleteItem(int nItem);

Параметры

nItem
Отсчитываемое от нуля значение элемента для удаления.

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

Имеет ненулевое значение в случае успешного выполнения, иначе — 0.

Пример

// This example assumes that there is a CTabCtrl member of the
// CTabDlg class named m_TabCtrl.  On a button handler
// called OnDeleteItem of the dialog box the tab control will
// delete the 0 indexed item.

void CTabDlg::OnDeleteItem()
{
   // Delete the first item in the tab control.
   m_TabCtrl.DeleteItem(0);
}

CTabCtrl::DeselectAll

Сбрасывает элементы в элементе управления табуляции, очищая все, которые были нажаты.

void DeselectAll(BOOL fExcludeFocus);

Параметры

fExcludeFocus
Флаг, указывающий область действия отмены выбора элемента. Если для этого параметра задано значение FALSE, все кнопки вкладок будут сброшены. Если задано TRUEзначение , все элементы вкладок, кроме выбранного в данный момент, будут сброшены.

Замечания

Эта функция-член реализует поведение сообщения Win32, TCM_DESELECTALLкак описано в пакете SDK для Windows.

CTabCtrl::DrawItem

Вызывается платформой при изменении визуального аспекта элемента управления вкладки "Рисование владельца".

virtual void DrawItem(LPDRAWITEMSTRUCT lpDrawItemStruct);

Параметры

lpDrawItemStruct
Указатель на DRAWITEMSTRUCT структуру, описывающую элемент, который будет окрашен.

Замечания

Элемент itemAction DRAWITEMSTRUCT структуры определяет действие рисования для выполнения.

По умолчанию эта функция-член ничего не делает. Переопределите эту функцию-член, чтобы реализовать рисование для объекта owner-draw CTabCtrl .

Приложение должно восстановить все объекты интерфейса графического устройства (GDI), выбранные для контекста отображения, предоставленного lpDrawItemStruct перед завершением этой функции-члена.

CTabCtrl::GetCurFocus

Извлекает индекс вкладки с текущим фокусом.

int GetCurFocus() const;

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

Отсчитываемый от нуля индекс вкладки с текущим фокусом.

CTabCtrl::GetCurSel

Извлекает выбранную в данный момент вкладку в элементе управления табуляции.

int GetCurSel() const;

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

Отсчитываемый от нуля индекс выбранной вкладки при успешном выполнении или -1, если вкладка не выбрана.

CTabCtrl::GetExtendedStyle

Извлекает расширенные стили, которые в настоящее время используются для элемента управления tab.

DWORD GetExtendedStyle();

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

Представляет расширенные стили, используемые в настоящее время для элемента управления tab. Это значение представляет собой сочетание расширенных стилей элемента управления tab, как описано в пакете SDK для Windows.

Замечания

Эта функция-член реализует поведение сообщения TCM_GETEXTENDEDSTYLEWin32, как описано в пакете SDK для Windows.

CTabCtrl::GetImageList

Извлекает список изображений, связанный с элементом управления tab.

CImageList* GetImageList() const;

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

В случае успешного выполнения указатель на список изображений элемента управления вкладки; NULLв противном случае .

CTabCtrl::GetItem

Извлекает сведения о вкладке в элементе управления табуляции.

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

Параметры

nItem
Отсчитываемый от нуля индекс вкладки.

pTabCtrlItem
Указатель на структуру, используемую для указания сведений TCITEM для извлечения. Также используется для получения сведений о вкладке. Эта структура используется с функциями InsertItemи GetItemSetItem членами.

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

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

Замечания

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

• mask

  Значение, указывающее элементы 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();
}

CTabCtrl::GetItemCount

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

int GetItemCount() const;

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

Количество элементов в элементе управления tab.

Пример

Пример см. в примере CPropertySheet::GetTabControl.

CTabCtrl::GetItemRect

Извлекает ограничивающий прямоугольник для указанной вкладки в элементе управления tab.

BOOL GetItemRect(int nItem,   LPRECT lpRect) const;

Параметры

nItem
Отсчитываемый от нуля индекс элемента вкладки.

lpRect
Указатель на RECT структуру, которая получает ограничивающий прямоугольник вкладки. Эти координаты используют текущий режим сопоставления окна просмотра.

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

Имеет ненулевое значение в случае успешного выполнения, иначе — 0.

Пример

Пример см. в примере CPropertySheet::GetTabControl.

CTabCtrl::GetItemState

Извлекает состояние элемента управления вкладки, определяемого nItemпо.

DWORD GetItemState(
    int nItem,
    DWORD dwMask) const;

Параметры

nItem
Отсчитываемый от нуля номер индекса элемента, для которого требуется получить сведения о состоянии.

dwMask
Маска, указывающая, какие флаги состояния элемента необходимо вернуть. Список значений см. в элементе TCITEM маски структуры, как описано в пакете SDK для Windows.

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

Ссылка на значение DWORD, получающее сведения о состоянии. Может использоваться одно из следующих значений:

значение	Описание
TCIS_BUTTONPRESSED	Выбран элемент управления tab.
TCIS_HIGHLIGHTED	Элемент управления tab выделен, а вкладка и текст рисуются с помощью текущего цвета выделения. При использовании цвета выделения это будет истинной интерполяцией, а не цветом с дитерацией.

Замечания

Состояние элемента определяется dwState членом TCITEM структуры.

CTabCtrl::GetRowCount

Извлекает текущее количество строк в элементе управления табуляции.

int GetRowCount() const;

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

Количество строк вкладок в элементе управления табуляции.

Замечания

Только элементы управления вкладками, которые имеют TCS_MULTILINE стиль, могут иметь несколько строк вкладок.

CTabCtrl::GetToolTips

Извлекает дескриптор элемента управления подсказкой средства, связанного с элементом управления tab.

CToolTipCtrl* GetToolTips() const;

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

Дескриптор элемента управления подсказкой средства в случае успешного выполнения; в противном случае NULL.

Замечания

Элемент управления tab создает элемент управления подсказкой инструментов, если он имеет TCS_TOOLTIPS стиль. Вы также можете назначить элемент управления подсказкой на вкладке SetToolTips с помощью функции-члена.

CTabCtrl::HighlightItem

Задает состояние выделения элемента вкладки.

BOOL HighlightItem(int idItem,  BOOL fHighlight = TRUE);

Параметры

idItem
Отсчитываемый от нуля индекс элемента управления tab.

fHighlight
Значение, указывающее состояние выделения, которое нужно задать. Если это значение имеет значение TRUE, выделена вкладка; если FALSEвкладка имеет значение по умолчанию.

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

Ненулевое значение в случае успеха, иначе — 0.

Замечания

Эта функция-член реализует сообщение TCM_HIGHLIGHTITEMWin32, как описано в пакете SDK для Windows.

CTabCtrl::HitTest

Определяет, какая вкладка, если она есть, находится в указанной позиции экрана.

int HitTest(TCHITTESTINFO* pHitTestInfo) const;

Параметры

pHitTestInfo
Указатель на TCHITTESTINFO структуру, как описано в пакете SDK для Windows, который указывает положение экрана для тестирования.

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

Возвращает отсчитываемый от нуля индекс вкладки или -1, если вкладка не находится в указанной позиции.

CTabCtrl::InsertItem

Вставляет новую вкладку в существующий элемент управления вкладки.

LONG InsertItem(
    int nItem,
    TCITEM* pTabCtrlItem);

LONG InsertItem(
    int nItem,
    LPCTSTR lpszItem);

LONG InsertItem(
    int nItem,
    LPCTSTR lpszItem,
    int nImage);

LONG InsertItem(
    UINT nMask,
    int nItem,
    LPCTSTR lpszItem,
    int nImage,
    LPARAM lParam);

LONG InsertItem(
    UINT nMask,
    int nItem,
    LPCTSTR lpszItem,
    int nImage,
    LPARAM lParam,
    DWORD dwState,
    DWORD dwStateMask);

Параметры

nItem
Отсчитываемый от нуля индекс новой вкладки.

pTabCtrlItem
Указатель на TCITEM структуру, указывающую атрибуты вкладки.

lpszItem
Адрес строки, завершаемой значением NULL, содержащей текст вкладки.

nImage
Отсчитываемый от нуля индекс изображения для вставки из списка изображений.

nMask
Указывает, какие TCITEM атрибуты структуры следует задать. Может быть равно нулю или сочетанию следующих значений:

• TCIF_TEXT: является допустимым pszText элементом.
• TCIF_IMAGE: является допустимым iImage элементом.
• TCIF_PARAM: является допустимым lParam элементом.
• TCIF_RTLREADING: текст pszText отображается с помощью порядка чтения справа налево на иврите или арабском языке.
• TCIF_STATE: является допустимым dwState элементом.

lParam
Определяемые приложением данные, связанные с вкладкой.

dwState
Задает значения для состояний элемента. Дополнительные сведения см TCITEM . в пакете SDK для Windows.

dwStateMask
Указывает, какие состояния необходимо задать. Дополнительные сведения см TCITEM . в пакете SDK для Windows.

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

Отсчитываемый от нуля индекс новой вкладки при успешном выполнении; в противном случае - 1.

Пример

TCITEM tcItem;
tcItem.mask = TCIF_TEXT;
tcItem.pszText = _T("Tab #1");

m_TabCtrl.InsertItem(0, &tcItem);

CTabCtrl::RemoveImage

Удаляет указанное изображение из списка изображений элемента управления вкладки.

void RemoveImage(int nImage);

Параметры

nImage
Отсчитываемый от нуля индекс образа.

Замечания

Элемент управления tab обновляет индекс изображения каждой вкладки, чтобы каждая вкладка оставалась связанной с тем же изображением.

CTabCtrl::SetCurFocus

Задает фокус на указанную вкладку в элементе управления табуляции.

void SetCurFocus(int nItem);

Параметры

nItem
Указывает индекс вкладки, которая получает фокус.

Замечания

Эта функция-член реализует поведение сообщения TCM_SETCURFOCUSWin32, как описано в пакете SDK для Windows.

CTabCtrl::SetCurSel

Выбирает вкладку в элементе управления вкладкой.

int SetCurSel(int nItem);

Параметры

nItem
Отсчитываемый от нуля индекс выбранного элемента.

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

Отсчитываемый от нуля индекс ранее выбранной вкладки в противном случае — значение -1.

Замечания

Элемент управления вкладкой не отправляет TCN_SELCHANGING сообщение или TCN_SELCHANGE уведомление при выборе вкладки с помощью этой функции. Эти уведомления отправляются, используя WM_NOTIFY, когда пользователь щелкает или использует клавиатуру для изменения вкладок.

CTabCtrl::SetExtendedStyle

Задает расширенные стили для элемента управления tab.

DWORD SetExtendedStyle(DWORD dwNewStyle, DWORD dwExMask = 0);

Параметры

dwNewStyle
Значение, указывающее сочетание расширенных стилей элемента управления tab.

dwExMask
Значение DWORD, указывающее, какие стили dwNewStyle должны быть затронуты. Будут изменены только расширенные стили dwExMask . Все остальные стили будут поддерживаться как есть. Если этот параметр равен нулю, все стили будут dwNewStyle затронуты.

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

Значение DWORD, содержащее расширенные стили элементов управления вкладками, как описано в пакете SDK для Windows.

Замечания

Эта функция-член реализует поведение сообщения TCM_SETEXTENDEDSTYLEWin32, как описано в пакете SDK для Windows.

CTabCtrl::SetImageList

Назначает список изображений элементу управления tab.

CImageList* SetImageList(CImageList* pImageList);

Параметры

pImageList
Указатель на список изображений, назначенный элементу управления tab.

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

Возвращает указатель на предыдущий список изображений или NULL отсутствует предыдущий список изображений.

CTabCtrl::SetItem

Задает некоторые или все атрибуты вкладки.

BOOL SetItem(int nItem,   TCITEM* pTabCtrlItem);

Параметры

nItem
Отсчитываемый от нуля индекс элемента.

pTabCtrlItem
Указатель на структуру TCITEM , содержащую атрибуты нового элемента. Элемент mask указывает, какие атрибуты необходимо задать. mask Если элемент задает TCIF_TEXT значение, член является адресом строки, завершаемой значением NULL, pszText и cchTextMax элемент игнорируется.

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

Имеет ненулевое значение в случае успешного выполнения, иначе — 0.

Пример

Пример см. в примере GetItem.

CTabCtrl::SetItemExtra

Задает количество байтов на вкладку, зарезервированное для данных, определенных приложением, в элементе управления табуляции.

BOOL SetItemExtra(int nBytes);

Параметры

nBytes
Количество дополнительных байтов, которые нужно задать.

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

Ненулевое значение в случае успеха, иначе — 0.

Замечания

Эта функция-член реализует поведение сообщения TCM_SETITEMEXTRAWin32, как описано в пакете SDK для Windows.

CTabCtrl::SetItemSize

Задает ширину и высоту элементов набора вкладок.

CSize SetItemSize(CSize size);

Параметры

size
Новая ширина и высота (в пикселях) элементов набора вкладок.

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

Возвращает старую ширину и высоту элементов набора вкладок.

CTabCtrl::SetItemState

Задает состояние элемента управления вкладки, определяемого по nItem.

BOOL SetItemState(
    int nItem,
    DWORD dwMask,
    DWORD dwState);

Параметры

nItem
Отсчитываемый от нуля номер индекса элемента, для которого необходимо задать сведения о состоянии.

dwMask
Маска, указывающая, какие флаги состояния элемента необходимо задать. Список значений см. в элементе TCITEM маски структуры, как описано в пакете SDK для Windows.

dwState
Ссылка на значение DWORD, содержащее сведения о состоянии. Может использоваться одно из следующих значений:

значение	Описание
TCIS_BUTTONPRESSED	Выбран элемент управления tab.
TCIS_HIGHLIGHTED	Элемент управления tab выделен, а вкладка и текст рисуются с помощью текущего цвета выделения. При использовании цвета выделения это будет истинной интерполяцией, а не цветом с дитерацией.

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

Имеет ненулевое значение в случае успешного выполнения, иначе — 0.

CTabCtrl::SetMinTabWidth

Задает минимальную ширину элементов в элементе управления табуляции.

int SetMinTabWidth(int cx);

Параметры

cx
Минимальная ширина элемента управления вкладки. Если для этого параметра задано значение -1, элемент управления будет использовать ширину табуляции по умолчанию.

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

Предыдущая минимальная ширина вкладки.

Замечания

Эта функция-член реализует поведение сообщения TCM_SETMINTABWIDTHWin32, как описано в пакете SDK для Windows.

CTabCtrl::SetPadding

Задает объем пространства (заполнение) вокруг значка и метки каждой вкладки в элементе управления табуляции.

void SetPadding(CSize size);

Параметры

size
Задает объем пространства (заполнение) вокруг значка и метки каждой вкладки в элементе управления табуляции.

CTabCtrl::SetToolTips

Назначает элементу управления подсказки средства элементу управления tab.

void SetToolTips(CToolTipCtrl* pWndTip);

Параметры

pWndTip
Дескриптор элемента управления подсказкой средства.

Замечания

Вы можете получить элемент управления подсказкой, связанный с элементом управления вкладкой, выполнив вызов GetToolTips.

Пример

Пример см. в примере CPropertySheet::GetTabControl.

См. также

CWnd Класс
CHeaderCtrl Класс
CListCtrl Класс
Диаграмма иерархии