NM _ CUSTOMDRAW-Benachrichtigungscode

Benachrichtigt das übergeordnete Fenster eines Steuerelements über benutzerdefinierte Zeichnungsvorgänge. Dieser Benachrichtigungscode wird in Form einer WM _ NOTIFY-Nachricht gesendet.

NM_CUSTOMDRAW

#ifdef LIST_VIEW_CUSTOM_DRAW

    lpNMCustomDraw = (LPNMLVCUSTOMDRAW) lParam;

#elif TOOL_TIPS_CUSTOM_DRAW

    lpNMCustomDraw = (LPNMTTCUSTOMDRAW) lParam;

#elif TREE_VIEW_CUSTOM_DRAW

    lpNMCustomDraw = (LPNMTVCUSTOMDRAW) lParam;

#elif TOOL_BAR_CUSTOM_DRAW

    lpNMCustomDraw = (LPNMTBCUSTOMDRAW) lParam;

#else

    lpNMCustomDraw = (LPNMCUSTOMDRAW) lParam;

#endif

Parameter

lParam

Ein Zeiger auf eine benutzerdefinierte Zeichnungsstruktur, die Informationen zum Zeichnungsvorgang enthält. In der folgenden Liste sind die Steuerelemente und ihre zugeordneten Strukturen angegeben.

Control Benutzerdefinierte Draw-Struktur
Rebar, Trackbar und Header NMCUSTOMDRAW
Listenansicht NMLVCUSTOMDRAW
QuickInfo NMTTCUSTOMDRAW
Strukturansicht NMTVCUSTOMDRAW
Symbolleiste NMTBCUSTOMDRAW

Rückgabewert

Der Wert, den Ihre Anwendung zurückgeben kann, hängt von der aktuellen Zeichnungsphase ab. Das dwDrawStage-Element der zugeordneten NMCUSTOMDRAW-Struktur enthält einen Wert, der die Zeichnungsphase angibt. Sie müssen einen der folgenden Werte zurückgeben.

Rückgabecode Beschreibung
CDRF _ DODEFAULT
Das Steuerelement wird sich selbst zeichnen. Es werden keine zusätzlichen NM _ CUSTOMDRAW-Benachrichtigungscodes für diesen Farbzyklus gesendet. Dieses Flag kann nicht mit einem anderen Flag verwendet werden.
CDRF _ DOERASE
Das Steuerelement zeichnen nur den Hintergrund.
CDRF _ NEWFONT
Ihre Anwendung hat eine neue Schriftart für das Element angegeben. Das -Steuerelement verwendet die neue Schriftart. Weitere Informationen zum Ändern von Schriftarten finden Sie unter Ändern von Schriftarten und Farben. Dies tritt auf, wenn dwDrawStage gleich CDDS _ ITEMPREPAINT ist.
CDRF _ NOTIFYITEMDRAW
Das -Steuerelement benachrichtigt das übergeordnete Element über elementbezogene Zeichnungsvorgänge. Vor und nach dem Zeichnen von Elementen werden NM _ CUSTOMDRAW-Benachrichtigungscodes gesendet. Dies tritt auf, wenn dwDrawStage gleich CDDS _ PREPAINT ist.
CDRF _ NOTIFYPOSTERASE
Das -Steuerelement benachrichtigt das übergeordnete Element nach dem Löschen eines Elements. Dies tritt auf, wenn dwDrawStage gleich CDDS _ PREPAINT ist.
CDRF _ NOTIFYPOSTPAINT
Das Steuerelement sendet einen NM _ CUSTOMDRAW-Benachrichtigungscode, wenn der Malzyklus für das gesamte Steuerelement abgeschlossen ist. Dies tritt auf, wenn dwDrawStage gleich CDDS _ PREPAINT ist.
CDRF _ NOTIFYSUBITEMDRAW
Ihre Anwendung erhält einen NM _ CUSTOMDRAW-Benachrichtigungscode, bei dem dwDrawStage auf CDDS ITEMPREPAINT CDDS SUBITEM festgelegt ist, bevor jedes _ Listenansichtsunterelement | _ gezeichnet wird. Anschließend können Sie Schriftart und Farbe für jedes Unterem separat angeben oder CDRF _ DODEFAULT für die Standardverarbeitung zurückgeben. Dies tritt auf, wenn dwDrawStage gleich CDDS _ ITEMPREPAINT ist.
CDRF _ SKIPDEFAULT
Ihre Anwendung hat das Element manuell geerbt. Das -Steuerelement zeichnen das Element nicht. Dies tritt auf, wenn dwDrawStage gleich CDDS _ ITEMPREPAINT ist.
CDRF _ SKIPPOSTPAINT
Das Steuerelement zeichnen das Fokusrechteck um ein Element nicht.

Hinweise

Derzeit unterstützen die folgenden Steuerelemente benutzerdefinierte Zeichnen-Funktionen: Header, Listenansicht, Rebar, Symbolleiste, QuickInfo, Trackleiste und Strukturansicht. Benutzerdefiniertes Zeichnen wird auch für Schaltflächensteuerelemente unterstützt, wenn Sie über ein Anwendungsmanifest verfügen, um sicherzustellen, Comctl32.dll Version 6 verfügbar ist.

Wenn diese Meldung in einer Dialogprozedur behandelt wird, müssen Sie den Rückgabewert als Teil der Fensterdaten festlegen, bevor SIE TRUE zurückgeben. Weitere Informationen finden Sie unter DialogProc.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows Nur [ Vista-Desktop-Apps]
Unterstützte Mindestversion (Server)
Windows Nur Server [ 2003-Desktop-Apps]
Header
Commctrl.h

Weitere Informationen

Konzeptionellen

Benutzerdefiniertes Zeichnen