共用方式為

ListView_GetItem巨集 （commctrl.h）

  • 發行項

取得清單檢視專案的一些或所有屬性。 您可以使用此巨集或明確傳送 LVM_GETITEM 訊息。

語法

BOOL ListView_GetItem(
   HWND     hwnd,
   LPLVITEM pitem
);

參數

hwnd

類型：HWND

清單檢視控件的句柄。

pitem

類型：LPLVITEM

LVITEM 結構的指標，指定要擷取和接收清單檢視專案的相關信息。

傳回值

類型：BOOL

如果成功，則傳回 true true，否則會 傳回 false。

言論

傳送 LVM_GETITEM 訊息時，iItem 和 iSubItem 成員會識別要擷取之專案或子專案的相關信息，而 遮罩 成員會指定要擷取的屬性。 如需可能值的清單，請參閱 LVITEM 結構的描述。

如果在 LVITEM 結構的 遮罩 成員中設定LVIF_TEXT旗標，pszText 成員必須指向有效的緩衝區，且 cchTextMax 成員必須設定為該緩衝區中的字元數。 應用程式不應該假設文字必須放在指定的緩衝區中。 控件可能會改為變更結構 pszText 成員，以指向新的文字，而不是將它放在緩衝區中。

如果 遮罩 成員指定LVIF_STATE值，stateMask 成員必須指定要擷取的項目狀態位。 在輸出中，狀態 成員包含指定狀態位的值。

要求

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