NM_CUSTOMDRAW (Strukturansicht) Benachrichtigungscode

Artikel
06/13/2023

Wird von einem Strukturansichtssteuerelement gesendet, um das übergeordnete Fenster über Zeichnungsvorgänge zu benachrichtigen. Dieser Benachrichtigungscode wird in Form einer WM_NOTIFY Nachricht gesendet.

NM_CUSTOMDRAW

    lpNMCustomDraw = (LPNMTVCUSTOMDRAW) lParam;

Parameter

lParam: Zeiger auf eine NMTVCUSTOMDRAW-Struktur , die Informationen zum Zeichnungsvorgang enthält und empfängt. Das dwItemSpec-Element des nmcd-Members dieser Struktur enthält das Handle des gezeichneten Elements. Das lItemlParam-Element des nmcd-Members dieser Struktur enthält die lParam des gezeichneten Elements.

Rückgabewert

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

Rückgabecode	Beschreibung
CDRF_DODEFAULT	Das Steuerelement zeichnet sich selbst. Es sendet keine zusätzlichen NM_CUSTOMDRAW-Codes für diesen Farbzyklus. Dies tritt auf, wenn dwDrawStage gleich CDDS_PREPAINT.
CDRF_NOTIFYITEMDRAW	Das Steuerelement benachrichtigt das übergeordnete Element aller elementbezogenen Zeichnungsvorgänge. Es sendet NM_CUSTOMDRAW Benachrichtigungscodes vor und nach dem Zeichnen von Elementen. Dies tritt auf, wenn dwDrawStage gleich CDDS_PREPAINT.
CDRF_NOTIFYPOSTERASE	Das Steuerelement benachrichtigt das übergeordnete Element nach dem Löschen eines Elements. Dies tritt auf, wenn dwDrawStage gleich CDDS_PREPAINT.
CDRF_NOTIFYPOSTPAINT	Das Steuerelement benachrichtigt das übergeordnete Element nach dem Zeichnen eines Elements. Dies tritt auf, wenn dwDrawStage gleich CDDS_PREPAINT.
CDRF_NOTIFYSUBITEMDRAW	Version 4.71. Das Steuerelement benachrichtigt das übergeordnete Element, wenn ein Unterelement der Listenansicht gezeichnet wird. Dies tritt auf, wenn dwDrawStage gleich CDDS_PREPAINT.
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.
CDRF_SKIPDEFAULT	Ihre Anwendung hat das Element manuell gezeichnet. Das Steuerelement zeichnet das Element nicht. Dies tritt auf, wenn dwDrawStage gleich CDDS_ITEMPREPAINT.

Bemerkungen

Version 5.80. Wenn Sie die Schriftart ändern, indem Sie CDRF_NEWFONT zurückgeben, zeigt das Strukturansichtssteuerelement möglicherweise abgeschnittenen Text an. Dieses Verhalten ist für die Abwärtskompatibilität mit früheren Versionen der allgemeinen Steuerelemente erforderlich. Wenn Sie die Schriftart eines Strukturansichtssteuerelements ändern möchten, erhalten Sie bessere Ergebnisse, wenn Sie eine CCM_SETVERSION Nachricht senden, bei der der wParam-Wert auf 5 festgelegt ist, bevor Sie dem Steuerelement Elemente hinzufügen.

Anforderungen

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

Siehe auch

Verwenden des benutzerdefinierten Zeichnens

Freigeben über