Condividi tramite


CTabCtrl::InsertItem

Inserisce una nuova scheda in un controllo scheda esistente.

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 
);

Parametri

  • nItem
    Indice a base zero della nuova scheda.

  • pTabCtrlItem
    Puntatore a una struttura TCITEM specificando gli attributi della scheda.

  • lpszItem
    Indirizzo di una stringa con terminazione null che contiene il testo della scheda.

  • nImage
    L'indice in base zero di un'immagine da inserire da un elenco.

  • nMask
    Specifica la struttura TCITEM attributi per impostare.Può essere zero o una combinazione dei valori seguenti:

    • TCIF_TEXT il membro pszText è valido.

    • TCIF_IMAGE il membro iImage è valido.

    • TCIF_PARAM il membro lParam è valido.

    • TCIF_RTLREADING il testo pszText visualizzati utilizzando l'ordine di lettura da destra a sinistra nei sistemi l'arabo o l'ebraico.

    • TCIF_STATE il membro dwState è valido.

  • lParam
    Dati definiti dall'applicazione associati alla scheda.

  • dwState
    Specifica i valori degli stati degli elementi.Per ulteriori informazioni, vedere TCITEM in Windows SDK.

  • dwStateMask
    Specifica che gli stati devono essere impostati.Per ulteriori informazioni, vedere TCITEM in Windows SDK.

Valore restituito

Indice a base zero della nuova scheda in caso di esito positivo; in caso contrario – 1.

Esempio

TCITEM tcItem;
tcItem.mask = TCIF_TEXT;
tcItem.pszText = _T("Tab #1");

m_TabCtrl.InsertItem(0, &tcItem);

Requisiti

Header: afxcmn.h

Vedere anche

Riferimenti

Classe di CTabCtrl

Grafico della gerarchia

CTabCtrl::GetItem

CTabCtrl::SetItem