CListCtrl::InsertItem

Article
06/10/2015

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