NM_CUSTOMDRAW (Listenansicht) Benachrichtigungscode

  • Artikel

Wird von einem Listenansichtssteuerelement gesendet, um seine übergeordneten Fenster über Zeichnungsvorgänge zu benachrichtigen. Dieser Benachrichtigungscode wird in Form einer WM_NOTIFY Nachricht gesendet.

NM_CUSTOMDRAW

    lpNMCustomDraw = (LPNMLVCUSTOMDRAW) lParam;

Parameter

lParam

Zeiger auf eine NMLVCUSTOMDRAW-Struktur , die Informationen zum Zeichnungsvorgang enthält. Das erste Element dieser Struktur, nmcd, ist ein Zeiger auf eine NMCUSTOMDRAW-Struktur . Das dwItemSpec-Element der Struktur, auf die von nmcd verwiesen wird, enthält den Bezeichner des gezeichneten Elements und das lItemlParam-Element seine anwendungsdefinierten Daten.

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 Benachrichtigungscodes für diesen Farbzyklus. Dies tritt auf, wenn dwDrawStage gleich CDDS_PREPAINT.
CDRF_DOERASE
 Windows Vista Das Steuerelement zeichnet nur den Hintergrund.
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_NEWFONT
 Die 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_NOTIFYSUBITEMDRAW
 Version 4.71. Ihre Anwendung erhält einen NM_CUSTOMDRAW-Steuerelementcode , wobei dwDrawStage auf CDDS_ITEMPREPAINT | CDDS_SUBITEM, bevor jedes Listenansichtsunterelement gezeichnet wird. Anschließend können Sie Schriftart und Farbe für jedes Unterelement separat angeben oder CDRF_DODEFAULT für die Standardverarbeitung zurückgeben. Dies tritt auf, wenn dwDrawStage gleich CDDS_ITEMPREPAINT.
CDRF_SKIPDEFAULT
 Die Anwendung hat das Element manuell gezeichnet. Das Steuerelement zeichnet das Element nicht. Dies tritt auf, wenn dwDrawStage gleich CDDS_ITEMPREPAINT.
CDRF_SKIPPOSTPAINT
 Windows Vista Das Steuerelement zeichnet das Fokusrechteck nicht.

Bemerkungen

Version 5.80. Wenn Sie die Schriftart ändern, indem Sie CDRF_NEWFONT zurückgeben, zeigt das Listenansicht-Steuerelement 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 Listenansichtssteuerelements ä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