CListCtrl::InsertItem

Článek
03/04/2013

Vloží ovládací prvek seznamu zobrazení položky.

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
Ukazatel LVITEM struktury, která určuje atributy položky, jak je popsáno v .
nItem
Index položky vložit.
lpszItem
Adresa řetězec obsahující popisek položky nebo LPSTR_TEXTCALLBACK Pokud zboží je zboží zpětného volání.Informace o zpětné volání položky, CListCtrl::GetCallbackMask.
nImage
Index obrázku položky nebo I_IMAGECALLBACK Pokud zboží je zboží zpětného volání.Informace o zpětné volání položky, CListCtrl::GetCallbackMask.
nMask
nMask Parametr určuje, které položky jsou platné atributy předána jako parametry.Může být jedna nebo více hodnot maska popsané v LVITEM Structure v .Platné hodnoty lze kombinovat s bitového operátoru OR.
nState
Označuje stav položky, stavu obrazu a překrytí obrazu.Najdete témata LVITEM Structure informace a List-View Item States seznam platné příznaky.
nStateMask
Určuje, které bity členského státu bude načtena nebo změněna.Viz LVITEM Structure v Další informace.
lParam
Hodnota 32bitové aplikace související s položkou.Pokud je tento parametr zadán, je nutné nastavit nMask atributu LVIF_PARAM .

Vrácená hodnota

Index nové položky, pokud je úspěšná nebo jinak -1.

Poznámky

Volání této metody může způsobit, že LVM_INSERTITEM zprávy zasílané do okna Ovládací prvek.Nastavit text položky za určitých podmínek může selhat popisovač související zprávy ovládacího prvku (například pomocí okna styly jako LVS_OWNERDRAW).Další informace o těchto podmínkách naleznete v LVM_INSERTITEM v .

Příklad

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