CListCtrl::InsertItem

Artykuł
02/27/2013

Wstawia element do formantu widoku listy.

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

Parametry

pItem
Wskaźnik do LVITEM strukturę, która określa atrybuty elementu, jak opisano w Windows SDK.
nItem
Indeks elementu do wstawienia.
lpszItem
Adres ciąg zawierający etykietę elementu, lub LPSTR_TEXTCALLBACK , jeśli element jest element wywołania zwrotnego.Informacji na temat pozycji wywołania zwrotnego, zobacz CListCtrl::GetCallbackMask.
nImage
Indeks obrazu towaru lub I_IMAGECALLBACK , jeśli element jest element wywołania zwrotnego.Informacji na temat pozycji wywołania zwrotnego, zobacz CListCtrl::GetCallbackMask.
nMask
nMask Parametr określa, który element przekazane jako parametry atrybutów są prawidłowe.Może to być jeden lub więcej wartości maski opisanych w LVITEM Structure w Windows SDK.Prawidłowe wartości można łączyć bitowym operatorem OR.
nState
Wskazuje stan elementu, obraz stanu i nakładki obrazu.Zobacz Windows SDK tematy LVITEM Structure więcej informacji i List-View Item States listę prawidłowe flagi.
nStateMask
Wskazuje, które bity Państwo Członkowskie będzie pobierana lub zmodyfikowane.Zobacz LVITEM Structure w Windows SDK Aby uzyskać więcej informacji.
lParam
Wartości specyficznych dla aplikacji 32-bitowych skojarzone z elementem.Jeśli ten parametr jest określony, należy ustawić nMask atrybutu LVIF_PARAM.

Wartość zwracana

Indeks nowy element, jeśli kończy się pomyślnie, lub inaczej -1.

Uwagi

Wywołania tej metody może spowodować LVM_INSERTITEM komunikat do wysłania do okna formantu.Ustawić tekst elementu, pod pewnymi warunkami obsługi wiadomości związanym formant może zakończyć się niepowodzeniem (jak przy użyciu okna stylów, takich jak LVS_OWNERDRAW).Aby uzyskać więcej informacji na te warunki odnoszą się do LVM_INSERTITEM w Windows SDK.

Przykład

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