共用方式為


CListCtrl::SetItemState

將某個項目的狀態在清單檢視控制項。

BOOL SetItemState(
   int nItem,
   LVITEM* pItem 
);
BOOL SetItemState(
   int nItem,
   UINT nState,
   UINT nMask 
);

參數

  • nItem
    位置所要設定之項目的索引。

  • pItem
    LVITEM 結構的位址 Windows SDK,如中所述。 結構的 stateMask 成員指定哪些狀態欄位變更和結構的 state 成員包含這些欄位的新值。 其他成員會被略過。

  • nState
    狀態欄位的新值。 如需可能值的清單,請參閱 CListCtrl::GetNextItemLVITEM 狀態成員。

  • nMask
    遮罩指定變更哪些狀態位元。 這個值對應於 LVITEM 結構的 stateMask 成員。

傳回值

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

備註

項目的「狀態」是指定項目的可用性的值,表示使用者動作或反映項目的狀態。 清單檢視控制項變更某些狀態欄位,例如,當使用者選取項目。 應用程式可能會變更其他狀態、停用或隱藏項目,或是指定覆疊影像或狀態影像。

範例

CListCtrl::GetTopIndex。請參閱範例。

需求

Header: afxcmn.h

請參閱

參考

類別 CListCtrl

階層架構圖

CListCtrl::GetItemState