CTabCtrl::InsertItem
Inserta una nueva ficha en un control de tabulación existente.
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
);
Parámetros
nItem
índice basado en cero de la ficha nueva.pTabCtrlItem
Puntero a una estructura de TCITEM que especifica los atributos de la pestaña.lpszItem
Dirección de una cadena terminada en null que contiene el texto de la pestaña.nImage
El índice de base cero de una imagen a insertar de una imagen.nMask
Especifica que los atributos de la estructura de TCITEM el conjunto.Puede ser cero o una combinación de los siguientes valores:El miembro deTCIF_TEXT The pszText es válido.
El miembro deTCIF_IMAGE The iImage es válido.
El miembro deTCIF_PARAM The lParam es válido.
El texto deTCIF_RTLREADING speed pszText se muestran mediante derecha a izquierda en sistemas hebreos o árabes.
El miembro deTCIF_STATE The dwState es válido.
lParam
Datos definidos por la aplicación asociada con la pestaña.dwState
Especifica los valores para los estados del elemento.Para obtener más información, vea TCITEM en Windows SDK.dwStateMask
Especifica que los estados deben estar establecidas.Para obtener más información, vea TCITEM en Windows SDK.
Valor devuelto
índice basado en cero de la ficha nueva si correctamente; si no – 1.
Ejemplo
TCITEM tcItem;
tcItem.mask = TCIF_TEXT;
tcItem.pszText = _T("Tab #1");
m_TabCtrl.InsertItem(0, &tcItem);
Requisitos
encabezado: afxcmn.h