共用方式為

ListView_SetItem巨集 （commctrl.h）

  • 發行項

設定清單檢視專案的一些或所有屬性。 您也可以使用 ListView_SetItem 來設定子專案的文字。 您可以使用此巨集或明確傳送 LVM_SETITEM 訊息。

語法

BOOL ListView_SetItem(
         HWND     hwnd,
   const LPLVITEM pitem
);

參數

hwnd

類型：HWND

清單檢視控件的句柄。

pitem

類型：const LPLVITEM

包含新項目屬性之 LVITEM 結構的指標。 iItem 和 iSubItem 成員會識別專案或子專案，而 遮罩 成員會指定要設定的屬性。 如果 遮罩 成員指定LVIF_TEXT值，pszText 成員是 null 終止字串的位址，而且會忽略 cchTextMax 成員。 如果 遮罩 成員指定LVIF_STATE值，stateMask 成員會指定要變更的項目狀態，而 狀態 成員包含這些狀態的值。

傳回值

類型：BOOL

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

言論

若要設定清單檢視專案的屬性，請將 LVITEM 結構 iItem 成員設定為專案的索引，並將 iSubItem 成員設定為零。 針對專案，您可以使用 狀態、pszText、iImage，以及 lParam LVITEM 結構 的成員來修改這些專案參數。

若要設定子專案的文字，請設定 iItem，並 iSubItem 成員來指出特定子專案，並使用 pszText 成員來指定文字。 或者，您可以使用 ListView_SetItemText 巨集來設定子項目的文字。 您無法為子項目設定 狀態 或 lParam 成員，因為子項目沒有這些屬性。 在 4.70 版和更新版本中，您可以設定子專案的 iImage 成員。 如果清單檢視控件具有 LVS_EX_SUBITEMIMAGES 擴充樣式，則會顯示子專案影像。 舊版會忽略子專案映像。

要求

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