共用方式為

NM_CUSTOMDRAW (清單檢視) 通知程式碼

  • 發行項

由清單檢視控制項傳送，以通知其父視窗有關繪圖作業。 此通知碼會以 WM_NOTIFY 訊息的形式傳送。

NM_CUSTOMDRAW

    lpNMCustomDraw = (LPNMLVCUSTOMDRAW) lParam;

參數

lParam

NMLVCUSTOMDRAW結構的指標，其中包含繪圖作業的相關資訊。 這個結構的第一個成員 nmcd是 NMCUSTOMDRAW 結構的指標。 nmcd所指向結構的dwItemSpec成員包含所繪製專案的識別碼，而 lItemlParam成員包含其應用程式定義的資料。

傳回值

您的應用程式可以傳回的值取決於目前的繪圖階段。 相關聯NMCUSTOMDRAW結構的dwDrawStage成員會保留指定繪圖階段的值。 您必須傳回下列其中一個值。

傳回碼 描述
CDRF_DODEFAULT
 控制項會自行繪製。 它不會為此繪製週期傳送任何其他 NM_CUSTOMDRAW 通知碼。 當 dwDrawStage 等於CDDS_PREPAINT時，就會發生這種情況。
CDRF_DOERASE
 Windows Vista。 控制項只會繪製背景。
CDRF_NOTIFYITEMDRAW
 控制項會通知父代任何專案相關的繪圖作業。 它會在繪圖專案前後傳送 NM_CUSTOMDRAW 通知碼。 當 dwDrawStage 等於CDDS_PREPAINT時，就會發生這種情況。
CDRF_NOTIFYPOSTERASE
 清除專案之後，控制項會通知父代。 當 dwDrawStage 等於CDDS_PREPAINT時，就會發生這種情況。
CDRF_NOTIFYPOSTPAINT
 控制項會在繪製專案之後通知父代。 當 dwDrawStage 等於CDDS_PREPAINT時，就會發生這種情況。
CDRF_NEWFONT
 應用程式為專案指定了新的字型;控制項會使用新的字型。 如需變更字型的詳細資訊，請參閱 變更字型和色彩。 當 dwDrawStage 等於CDDS_ITEMPREPAINT時，就會發生這種情況。
CDRF_NOTIFYSUBITEMDRAW
 4.71 版。 您的應用程式會收到NM_CUSTOMDRAW控制項程式碼，並將 dwDrawStage設定為 CDDS_ITEMPREPAINT |在繪製每個清單檢視子專案之前，CDDS_SUBITEM。 然後，您可以個別指定每個子專案的字型和色彩，或傳回 預設處理CDRF_DODEFAULT 。 當 dwDrawStage 等於CDDS_ITEMPREPAINT時，就會發生這種情況。
CDRF_SKIPDEFAULT
 應用程式會手動擷取專案。 控制項不會繪製專案。 當 dwDrawStage 等於CDDS_ITEMPREPAINT時，就會發生這種情況。
CDRF_SKIPPOSTPAINT
 Windows Vista。 控制項不會繪製焦點矩形。

備註

5.80 版。 如果您藉由傳回 CDRF_NEWFONT來變更字型，清單檢視控制項可能會顯示裁剪的文字。 需要此行為，才能與舊版的通用控制項回溯相容性。 如果您想要變更清單檢視控制項的字型，如果您在將任何專案新增至控制項之前傳送wParam值設定為 5的CCM_SETVERSION訊息，將會得到更好的結果。

規格需求

需求 值
最低支援的用戶端
 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器
 Windows Server 2003 [僅限桌面應用程式]
標頭
Commctrl.h