共用方式為

NM_CUSTOMDRAW (樹狀檢視) 通知程式碼

  • 發行項

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

NM_CUSTOMDRAW

    lpNMCustomDraw = (LPNMTVCUSTOMDRAW) lParam;

參數

lParam

NMTVCUSTOMDRAW結構的指標，其中包含和接收繪圖作業的相關資訊。 這個結構的nmcd成員dwItemSpec成員包含所繪製專案的控制碼。 這個結構之 nmcd成員的lItemlParam成員包含所繪製專案的lParam。

傳回值

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

傳回碼 描述
CDRF_DODEFAULT
 控制項會自行繪製。 它不會傳送此繪製週期的任何其他 NM_CUSTOMDRAW 程式碼。 當 dwDrawStage 等於 CDDS_PREPAINT時，就會發生這種情況。
CDRF_NOTIFYITEMDRAW
 控制項會通知任何專案相關繪圖作業的父代。 它會在繪圖專案前後傳送 NM_CUSTOMDRAW 通知碼。 當 dwDrawStage 等於 CDDS_PREPAINT時，就會發生這種情況。
CDRF_NOTIFYPOSTERASE
 控制項會在清除專案之後通知父代。當 dwDrawStage 等於 CDDS_PREPAINT時，就會發生這種情況。
CDRF_NOTIFYPOSTPAINT
 控制項會在繪製專案之後通知父代。 當 dwDrawStage 等於 CDDS_PREPAINT時，就會發生這種情況。
CDRF_NOTIFYSUBITEMDRAW
 4.71 版。 控制項會在繪製清單檢視子專案時通知父項。 當 dwDrawStage 等於 CDDS_PREPAINT時，就會發生這種情況。
CDRF_NEWFONT
 您的應用程式指定專案的新字型;控制項將使用新的字型。 如需變更字型的詳細資訊，請參閱 變更字型和色彩。 當 dwDrawStage 等於 CDDS_ITEMPREPAINT時，就會發生這種情況。
CDRF_SKIPDEFAULT
 您的應用程式會手動繪製專案。 控制項不會繪製專案。 當 dwDrawStage 等於 CDDS_ITEMPREPAINT時，就會發生這種情況。

備註

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

規格需求

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

另請參閱

使用自訂繪製