CListCtrl::InsertItem

Artikel
06/10/2015

Fügt ein Element in das ListView-Steuerelement ein.

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

Parameter

pItem
Zeiger auf eine LVITEM-Struktur, die die Attribute des Elements angibt, wie in Windows SDK beschrieben.
nItem
Index des Elements eingefügt werden.
lpszItem
Adresse einer Zeichenfolge, die die Bezeichnung des Elements enthält, oder LPSTR_TEXTCALLBACK, wenn das Element ein Rückrufelement ist. Informationen zum Rückrufelemente, finden Sie unter CListCtrl::GetCallbackMask.
nImage
Index des Bilds des Elements oder I_IMAGECALLBACK, wenn das Element ein Rückrufelement ist. Informationen zum Rückrufelemente, finden Sie unter CListCtrl::GetCallbackMask.
nMask
Der Parameter gibt an, nMask den Elementattribute übergeben haben, wie Parameter gültig sind. Er kann eine oder mehrere der Maskenwerte sein, die in LVITEM Structure in Windows SDK beschrieben werden. Die gültigen Werte können mit dem bitweisen Operator OR kombiniert werden.
nState
Gibt den Zustand des Elements, das Zustandsbild und das Overlaybild an. Siehe die Windows SDK Themen LVITEM Structure weitere Informationen und List-View Item States für eine Liste gültiger Flags.
nStateMask
Gibt an, welche Bits des Zustandsmembers abgerufen oder geändert werden. Siehe LVITEM Structure in Windows SDK weitere Informationen.
lParam
Ein anwendungsspezifisches 32-Bit-Wert mit dem - Element zugeordnet. Wenn dieser Parameter angegeben wird, müssen Sie das - Attribut nMaskLVIF_PARAM festlegen.

Rückgabewert

Der Index des neuen Elements, wenn erfolgreich oder andernfalls -1.

Hinweise

Durch Aufrufen dieser Methode bewirkt möglicherweise die LVM_INSERTITEM Meldung, dem Steuerelementfenster gesendet werden. Der zugeordnete Meldungshandler für das Steuerelement kann möglicherweise den Elementtext unter bestimmten Bedingungen fest (nicht die Verwendung von Fensterstilen wie LVS_OWNERDRAW). Weitere Informationen über diese Anforderungen, finden Sie unter LVM_INSERTITEM in Windows SDK an.

Beispiel

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