NM_CUSTOMDRAW (Strukturansicht) Benachrichtigungscode
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 |
|---|---|
|
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. |
|
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. |
|
Das Steuerelement benachrichtigt das übergeordnete Element nach dem Löschen eines Elements. Dies tritt auf, wenn dwDrawStage gleich CDDS_PREPAINT. |
|
Das Steuerelement benachrichtigt das übergeordnete Element nach dem Zeichnen eines Elements. Dies tritt auf, wenn dwDrawStage gleich CDDS_PREPAINT. |
|
Version 4.71. Das Steuerelement benachrichtigt das übergeordnete Element, wenn ein Unterelement der Listenansicht gezeichnet wird. Dies tritt auf, wenn dwDrawStage gleich CDDS_PREPAINT. |
|
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. |
|
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 |
|