Partager via


CListCtrl::InsertItem

Insère un élément dans le contrôle liste view.

int InsertItem(
   const LVITEM* pItem 
);
int InsertItem(
   int nItem,
   LPCTSTR lpszItem 
);
int InsertItem(
   int nItem,
   LPCTSTR lpszItem,
   int nImage 
);
int InsertItem(
   UINT nMask,
   int nItem,
   LPCTSTR lpszItem,
   UINT nState,
   UINT nStateMask,
   int nImage,
   LPARAM lParam
);

Paramètres

  • pItem
    Pointeur vers une structure de LVITEM qui spécifie les attributs de l'élément, comme décrit dans Kit de développement logiciel Windows.

  • nItem
    Index de l'élément à insérer.

  • lpszItem
    Adresse d'une chaîne contenant l'étiquette de l'élément, ou LPSTR_TEXTCALLBACK si l'élément est un élément de rappel. Pour plus d'informations sur les éléments de rappel, consultez CListCtrl::GetCallbackMask.

  • nImage
    Index de l'image de l'élément, ou I_IMAGECALLBACK si l'élément est un élément de rappel. Pour plus d'informations sur les éléments de rappel, consultez CListCtrl::GetCallbackMask.

  • nMask
    Le paramètre d' nMask spécifie que les attributs d'élément sont passé comme les paramètres sont valides. Il peut être un ou plusieurs des valeurs de masque décrites dans LVITEM Structure dans Kit de développement logiciel Windows. Les valeurs valides peuvent être combinées avec l'opérateur de bits OR.

  • nState
    Indique l'état de l'élément, l'image d'état, et l'image de superposition. Consultez les rubriques LVITEM Structure pour plus d'informations et List-View Item States d' Kit de développement logiciel Windows pour obtenir la liste des indicateurs valides.

  • nStateMask
    Indique les bits du membre d'état sont récupérés ou modifiés. Consultez LVITEM Structure dans Kit de développement logiciel Windows pour plus d'informations.

  • lParam
    Une valeur spécifique à l'application de 32 bits associé à l'élément. Si ce paramètre est spécifié, vous devez définir l'attribut LVIF_PARAMd' nMask .

Valeur de retour

Index du nouvel élément en cas de réussite ou -1 sinon.

Notes

Appeler cette méthode peut entraîner le message de LVM_INSERTITEM d'être envoyé à la fenêtre de contrôle. Le gestionnaire de messages associé pour le contrôle peut pour définir le texte de l'élément sous certaines conditions (comme l'utilisation de styles de fenêtre comme LVS_OWNERDRAW). Pour plus d'informations sur ces conditions, reportez -vous à LVM_INSERTITEM dans Kit de développement logiciel Windows.

Exemple

       CString strText;
        int nColumnCount = m_myListCtrl.GetHeaderCtrl()->GetItemCount();

        // Insert 10 items in the list view control. 
        for (int i = 0; i < 10; i++)
        {
            strText.Format(TEXT("item %d"), i);

            // Insert the item, select every other item.
            m_myListCtrl.InsertItem(LVIF_TEXT | LVIF_STATE, i, strText, 
                (i % 2) == 0 ? LVIS_SELECTED : 0, LVIS_SELECTED, 0, 0);

            // Initialize the text of the subitems. 
            for (int j = 1; j < nColumnCount; j++)
            {
                strText.Format(TEXT("sub-item %d %d"), i, j);
                m_myListCtrl.SetItemText(i, j, strText);
            }
        }

Configuration requise

Header: afxcmn.h

Voir aussi

Référence

CListCtrl, classe

Graphique de la hiérarchie

CListCtrl::DeleteItem

CListCtrl::DeleteAllItems

LVM_INSERTITEM