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 в Windows SDK.dwStateMask
Указывает, какие состояния установить.Дополнительные сведения см. в разделе TCITEM в Windows SDK.
Возвращаемое значение
Индекс новой вкладки Начинающийся с нуля если успешно; в противном случае – 1.
Пример
TCITEM tcItem;
tcItem.mask = TCIF_TEXT;
tcItem.pszText = _T("Tab #1");
m_TabCtrl.InsertItem(0, &tcItem);
Требования
Header: afxcmn.h