ListView_GetItemState巨集（commctrl.h）

取得清單檢視項目的狀態。您可以使用此巨集或明確傳送 LVM_GETITEMSTATE 訊息。

語法

UINT ListView_GetItemState(
   HWND hwndLV,
   int  i,
   UINT mask
);

hwndLV

類型：HWND

清單檢視控件的句柄。

i

類型：int

清單檢視專案的索引。

mask

類型：UINT

要擷取的狀態資訊。此參數可以是下列值的組合：

價值	意義
LVIS_CUT	項目會標示為剪貼作業。
LVIS_DROPHILITED	專案會反白顯示為拖放目標。
LVIS_FOCUSED	專案具有焦點，因此會以標準焦點矩形括住。雖然可以選取多個專案，但只有一個專案可以擁有焦點。
LVIS_SELECTED	已選取專案。選取項目的外觀取決於它是否具有焦點，以及用於選取的系統色彩。
LVIS_OVERLAYMASK	使用此遮罩來擷取專案的重疊影像索引。
LVIS_STATEIMAGEMASK	使用此遮罩來擷取項目的狀態影像索引。

類型：UINT

傳回指定專案的目前狀態。傳回值中唯一有效的位是對應至 mask 參數中所設定位的位。

專案的狀態資訊包含一組位旗標，以及表示項目狀態影像和重疊影像的影像清單索引。