CListCtrl::InsertItem

Makale
02/26/2013

Bir öğeyi liste görünüm denetimi ekler.

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

Parametreler

pItem
İşaretçi bir LVITEM açıklandığı gibi öğenin özniteliklerini belirten yapı Windows SDK.
nItem
Eklenecek öğenin dizini.
lpszItem
Öğenin etiketini içeren bir dize adresini veya LPSTR_TEXTCALLBACK geri çağırma madde Madde ise.Geri arama öğeleri hakkında daha fazla bilgi için bkz: CListCtrl::GetCallbackMask.
nImage
Öğenin resmindeki dizin ya da I_IMAGECALLBACK geri çağırma madde Madde ise.Geri arama öğeleri hakkında daha fazla bilgi için bkz: CListCtrl::GetCallbackMask.
nMask
nMask Parametresi belirtir hangi öğenin özniteliklerini parametre olarak geçirilebilecek geçerli.Biri olabilir ya da daha fazla maskesi değerleri açıklandığı LVITEM Structure , Windows SDK.Geçerli değerler bitwise or işleciyle birleştirilebilir.
nState
Maddenin durumu, durumu resmi ve kaplama resmi gösterir.Bkz: Windows SDK konuları LVITEM Structure daha fazla bilgi ve List-View Item States geçerli bayrakların bir listesi için.
nStateMask
Hangi bitlerin durumu üyesinin alınma veya değiştirilmiş gösterir.Bkz: LVITEM Structure , Windows SDK daha fazla bilgi için.
lParam
Maddeyle ilişkili bir 32-bit uygulamaya özgü değeri.Bu parametre belirtilmezse, ayarlamalısınız nMask özniteliği LVIF_PARAM.

Dönüş Değeri

Başarılı olursa yeni öğe veya başka türlü -1 dizini.

Notlar

Bu yöntem neden olabilir arama LVM_INSERTITEM denetim pencerenizi gönderilecek ileti.Belirli koşullar altında öğe metnini ayarlamak denetimin ilişkili ileti işleyicisi başarısız olabilir (Pencere stilleri kullanarak gibi lvs_ownerdraw).Bu koşullar hakkında daha fazla bilgi için bakın LVM_INSERTITEM , Windows SDK.

Örnek

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