共用方式為


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,如中所述。 結構的 iItemiSubItem 成員識別項目或子項目,,和結構的 遮罩 成員指定為集合中的哪些屬性。 如需 遮罩 成員的詳細資訊,請參閱 備註

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

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

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

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

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

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

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

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

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

傳回值

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

備註

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

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

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

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

範例

CListCtrl::HitTest。請參閱範例。

需求

Header: afxcmn.h

請參閱

參考

CListCtrl 類別

階層架構圖表

CListCtrl::GetItem