Compartilhar via


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

Consulte também

Referência

Classe CTabCtrl

Gráfico de hierarquia

CTabCtrl::GetItem

CTabCtrl::SetItem

Outros recursos

CTabCtrl membros