共用方式為

CListCtrl::SetItem

  • 發行項

設定部分或所有的清單檢視項目的屬性。

BOOL SetItem(
   const LVITEM* pItem 
);
BOOL SetItem(
   int nItem,
   int nSubItem,
   UINT nMask,
   LPCTSTR lpszItem,
   int nImage,
   UINT nState,
   UINT nStateMask,
   LPARAM lParam 
);
BOOL SetItem(
   int nItem,
   int nSubItem,
   UINT nMask,
   LPCTSTR lpszItem,
   int nImage,
   UINT nState,
   UINT nStateMask,
   LPARAM lParam,
   int nIndent 
);

參數

  • pItem
    包含新項目屬性的 LVITEM 結構的位址 Windows SDK，如中所述。 結構的 iItem 和 iSubItem 成員識別項目或子項目，，和結構的 遮罩 成員指定為集合中的哪些屬性。 如需 遮罩 成員的詳細資訊，請參閱 備註。

  • nItem
    屬性 (Property) 會設定項目的索引。

  • nSubItem
    屬性 (Property) 會設定子項目的索引。

  • nMask
    指定哪些屬性要設定 (請參閱備註)。

  • lpszItem
    指定項目的標籤 (Label) 的 NULL 結尾字串的位址。

  • nImage
    項目的影像索引在影像清單中的。

  • nState
    指定值對要變更狀態 (請參閱備註)。

  • nStateMask
    指定要變更哪些狀態 (請參閱備註)。

  • lParam
    與相關聯的 32 位元應用程式專屬值與項目。

  • nIndent
    的寬度，以像素為單位，縮排。 如果 nIndent 超過系統定義的最小寬度，新的寬度設定為系統定義的最小

傳回值

如果不是零，則成功，則為零。

備註

LVITEM 結構和 nItem 和 nSubItem 參數的 iItem 和 iSubItem 成員識別屬性要設定的項目和子項目。

LVITEM 結構的 遮罩 成員和 nMask 參數指定哪些項目屬性要設定:

  • LVIF_TEXTpszText 成員或 lpszItem 參數為 null 結尾字串的位址， cchTextMax 成員會被略過。

  • LVIF_STATEstateMask 成員或 nStateMask 參數指定哪些項目狀態變更和 state 成員或 nState 參數包含這些狀態的值。

範例

CListCtrl::HitTest。請參閱範例。

需求

Header: afxcmn.h

請參閱

參考

類別 CListCtrl

階層架構圖

CListCtrl::GetItem