共用方式為


CListCtrl::InsertItem

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

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

需求

Header: afxcmn.h

請參閱

參考

CListCtrl 類別

階層架構圖表

CListCtrl::DeleteItem

CListCtrl::DeleteAllItems

LVM_INSERTITEM