LVM_GETITEM訊息

擷取部分或所有清單檢視專案的屬性。 您可以明確傳送此訊息，或使用 ListView_GetItem 宏。

參數

wParam

必須為零。

lParam

LVITEM結構的指標，指定要擷取及接收清單檢視專案的相關資訊。

傳回值

如果成功，則傳回 TRUE ，否則傳回 FALSE 。

備註

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

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

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

規格需求

需求	值
最低支援的用戶端	Windows Vista [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2003 [僅限傳統型應用程式]
標頭	Commctrl.h
Unicode 與 ANSI 名稱	LVM_GETITEMW (Unicode ) 和 LVM_GETITEMA (ANSI)