ListView_GetItem宏 (commctrl.h)

  • 發行項

取得部分或所有清單檢視專案的屬性。 您可以使用這個宏，或明確地傳送 LVM_GETITEM 訊息。

語法

void ListView_GetItem(
   hwnd,
   pitem
);

參數

hwnd

類型： HWND

清單檢視控制項的控制碼。

pitem

類型： LPLVITEM

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

傳回值

無

備註

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

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

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

規格需求

   
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限桌面應用程式]
目標平台 Windows
標頭 commctrl.h