Compartilhar via

CTabCtrl::InsertItem

  • Artigo

Insere uma nova aba em um controle existente na guia.

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 com base zero de nova guia.

  • pTabCtrlItem
    Ponteiro a estrutura de TCITEM que especifica atributos de tabulação.

  • lpszItem
    Endereço de uma cadeia de caracteres NULL- finalizada que contém o texto na guia.

  • nImage
    O índice com base zero de uma imagem para inserir de uma lista de imagem.

  • nMask
    Especifica que estrutura de TCITEM atribui para definir.Podem ser zero ou uma combinação dos seguintes valores:

    • TCIF_TEXT o membro de pszText é válido.

    • TCIF_IMAGE o membro de iImage é válido.

    • TCIF_PARAM o membro de lParam é válido.

    • TCIF_RTLREADING o texto de pszText é exibido usando a ordem de leitura d-e nos sistemas hebraico ou árabe.

    • TCIF_STATE o membro de dwState é válido.

  • lParam
    Associados a dados definidos pela guia.

  • dwState
    Especifica valores para os estados de item.Para obter mais informações, consulte TCITEM em Windows SDK.

  • dwStateMask
    Especifica que estados devem ser definidos.Para obter mais informações, consulte TCITEM em Windows SDK.

Valor de retorno

Índice com base zero da nova guia se com êxito; se não – 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 de CTabCtrl

Gráfico de hierarquia

CTabCtrl::GetItem

CTabCtrl::SetItem