CListCtrl::InsertItem

發行項
02/28/2013

將項目插入清單檢視控制項。

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

參數

pItem
為指定的項目之屬性的 LVITEM 結構的指標 Windows SDK，如中所述。
nItem
要插入之項目的索引。
lpszItem
包含項目的標籤的字串的位址或 LPSTR_TEXTCALLBACK ，如果項目是回呼項目。如需回呼項目的詳細資訊，請參閱 CListCtrl::GetCallbackMask。
nImage
項目的影像的索引或 I_IMAGECALLBACK ，如果項目是回呼項目。如需回呼項目的詳細資訊，請參閱 CListCtrl::GetCallbackMask。
nMask
nMask 參數指定哪些項目屬性傳遞，因為參數是有效的。它可以是在 Windows SDK的 LVITEM Structure 描述的一或多個遮罩值。有效值可結合了位元 OR 運算子。
nState
表示項目的狀態影像、狀態和覆疊影像。請參閱 Windows SDK 主題 LVITEM Structure 。如需詳細資訊和 List-View Item States 為有效旗標清單。
nStateMask
表示狀態成員中的哪些欄位要擷取或修改資料。請參閱在 Windows SDK 的 LVITEM Structure 以取得詳細資訊。
lParam
32 位元的應用程式專屬值與項目。如果有指定此參數，就必須將 nMask 屬性 LVIF_PARAM。

傳回值

新的索引的項目，如果成功或-1 則為。

備註

呼叫這個方法可以讓 LVM_INSERTITEM 傳送訊息至控制項的視窗。控制項的關聯的訊息處理常式可能不會設定項目文字在特定情況下 (例如使用的視窗樣式 (例如 LVS_OWNERDRAW)。如需這些情況的詳細資訊，請參閱 Windows SDK的 LVM_INSERTITEM 。

範例

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