CTabCtrl::InsertItem
Insere uma nova guia em um controle 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 baseado em zero da nova guia.pTabCtrlItem
Ponteiro para um TCITEM estrutura que especifica os atributos da guia.lpszItem
Endereço de uma seqüência de caracteres terminada com nulo que contém o texto da guia.nImage
O índice baseado em zero de uma imagem para inserir a partir de uma lista de imagens.nMask
Especifica qual TCITEM atributos de estrutura para conjunto. Pode ser zero ou uma combinação dos seguintes valores:TCIF_TEXT O pszText membro é válido.
TCIF_IMAGE O iImage membro é válido.
TCIF_PARAM O lParam membro é válido.
TCIF_RTLREADING O texto da pszText é exibido usando sentido de leitura da direita para a esquerda nos sistemas hebraico ou árabe.
TCIF_STATE O dwState membro é válido.
lParam
Dados definidos pelo aplicativo associados com a guia.dwState
Especifica valores para os estados do item.Para obter mais informações, consulte TCITEM in the Windows SDK.dwStateMask
Especifica quais estados devem ser definidas.Para obter mais informações, consulte TCITEM in the Windows SDK.
Valor de retorno
Índice baseado em zero da nova guia se bem-sucedida; caso contrário – 1.
Exemplo
TCITEM tcItem;
tcItem.mask = TCIF_TEXT;
tcItem.pszText = _T("Tab #1");
m_TabCtrl.InsertItem(0, &tcItem);
Requisitos
Cabeçalho: afxcmn.h