ListView_SetItemIndexState巨集 （commctrl.h）

設定指定清單檢視項目的狀態。 使用此巨集或明確傳送 LVM_SETITEMINDEXSTATE 訊息。

語法

HRESULT ListView_SetItemIndexState(
  [in] HWND        hwndLV,
  [in] LVITEMINDEX *plvii,
  [in] UINT        data,
  [in] UINT        mask
);

參數

[in] hwndLV

類型：HWND

清單檢視控件的句柄。

[in] plvii

類型：LVITEMINDEX*

專案的 LVITEMINDEX 結構的指標。 呼叫端負責配置此結構並設定成員。

[in] data

類型：UINT

在項目上設定為 List-View 項目狀態 旗標的一或多個狀態（以位組合）。

[in] mask

類型：UINT

參數所指定之狀態的有效位 資料。 如需詳細資訊，請參閱 stateMaskLVITEM結構的成員。

傳回值

類型：HRESULT

傳回下列其中一個類型值，HRESULT。

傳回碼	描述
E_FAIL	無法設定狀態。
E_UNEXPECTED	清單檢視控件尚未準備好進行作業。
S_OK	作業成功。

要求

要求	價值
最低支援的用戶端	Windows Vista [僅限傳統型應用程式]
支援的最低伺服器	Windows Server 2008 [僅限傳統型應用程式]
目標平臺	窗戶
標頭	commctrl.h