CListCtrl::InsertItem

Articolo
03/05/2013

Inserisce un elemento nel controllo elenco.

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

Parametri

pItem
Puntatore a una struttura LVITEM specificando gli attributi dell'elemento, come descritto in Windows SDK.
nItem
Indice dell'elemento da inserire.
lpszItem
Indirizzo di una stringa contenente l'etichetta dell'elemento, o LPSTR_TEXTCALLBACK se l'elemento è un elemento di callback.Per informazioni sugli elementi di callback, vedere CListCtrl::GetCallbackMask.
nImage
Indice dell'immagine dell'elemento, o I_IMAGECALLBACK se l'elemento è un elemento di callback.Per informazioni sugli elementi di callback, vedere CListCtrl::GetCallbackMask.
nMask
Il parametro nMask specifica che gli attributi dell'elemento sono passati come parametri sono validi.Può essere uno o più valori della maschera descritti in LVITEM Structure in Windows SDK.I valori validi possono essere combinate con l'operatore OR bit.
nState
Indica lo stato dell'elemento, l'immagine di stato e l'immagine di sovrapposizione.Vedere gli argomenti LVITEM Structure per ulteriori informazioni e List-View Item StatesWindows SDK per un elenco di flag validi.
nStateMask
Indica quali bit del membro di stato vengono recuperati o modificati.Vedere LVITEM Structure in Windows SDK per ulteriori informazioni.
lParam
Un valore specifico dell'applicazione a 32 bit associato all'elemento.Se questo parametro è specificato, è necessario impostare l'attributo LVIF_PARAMdi nMask.

Valore restituito

L'indice di nuovo elemento in caso di esito positivo o -1 in caso contrario.

Note

Chiamare questo metodo può determinare un messaggio LVM_INSERTITEM venga inviato alla finestra di controllo.Il gestore di messaggi collegato al controllo può non riuscire a impostare il testo dell'elemento in determinate condizioni (come utilizzare gli stili di finestra come LVS_OWNERDRAW).Per ulteriori informazioni su queste condizioni, fare riferimento a LVM_INSERTITEM in Windows SDK.

Esempio

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