LPPAGEPAINTHOOK-Rückruffunktion (commdlg.h)

  • Artikel

Empfängt Nachrichten, mit denen Sie die Zeichnung der Beispielseite im Dialogfeld Seite einrichten anpassen können. Die PagePaintHook-Hookprozedur ist eine anwendungsdefinierte oder bibliotheksdefinierte Rückruffunktion, die mit der PageSetupDlg-Funktion verwendet wird.

Der LPPAGEPAINTHOOK-Typ definiert einen Zeiger auf diese Rückruffunktion. PagePaintHook ist ein Platzhalter für den anwendungsdefinierte oder bibliotheksdefinierte Funktionsnamen.

Syntax

LPPAGEPAINTHOOK Lppagepainthook;

UINT_PTR Lppagepainthook(
  HWND unnamedParam1,
  UINT unnamedParam2,
  WPARAM unnamedParam3,
  LPARAM unnamedParam4
)
{...}

Parameter

unnamedParam1

Ein Handle für das Dialogfeld Seite einrichten .

unnamedParam2

Der Bezeichner der empfangenen Nachricht.

unnamedParam3

Zusätzliche Informationen zur Meldung. Die genaue Bedeutung hängt vom Wert des parameters unnamedParam2 ab.

unnamedParam4

Zusätzliche Informationen zur Meldung. Die genaue Bedeutung hängt vom Wert des parameters unnamedParam2 ab.

Rückgabewert

Wenn die Hookprozedur true für eine der ersten drei Nachrichten einer Zeichnungssequenz (WM_PSD_PAGESETUPDLG, WM_PSD_FULLPAGERECT oder WM_PSD_MINMARGINRECT) zurückgibt, sendet das Dialogfeld keine weiteren Nachrichten und zeichnet erst auf der Beispielseite, wenn das System die Beispielseite das nächste Mal neu zeichnen muss. Wenn die Hookprozedur für alle drei Nachrichten FALSE zurückgibt, sendet das Dialogfeld die restlichen Meldungen der Zeichnungssequenz.

Wenn die Hookprozedur true für eine der verbleibenden Nachrichten in einer Zeichnungssequenz zurückgibt, zeichnet das Dialogfeld den entsprechenden Teil der Beispielseite nicht. Wenn die Hookprozedur false für eine dieser Nachrichten zurückgibt, zeichnet das Dialogfeld diesen Teil der Beispielseite.

Hinweise

Das Dialogfeld Seite einrichten enthält ein Bild einer Beispielseite, die zeigt, wie sich die Auswahl des Benutzers auf die Darstellung der gedruckten Ausgabe auswirkt. Das Bild besteht aus einem Rechteck, das den ausgewählten Papier- oder Umschlagtyp darstellt, mit einem gepunkteten Rechteck, das die aktuellen Ränder darstellt, und aus partiellen Zeichen (griechischem Text), um zu zeigen, wie Text auf der gedruckten Seite aussieht. Wenn Sie die PageSetupDlg-Funktion zum Erstellen eines Dialogfelds Seiteneinrichtung verwenden, können Sie eine PagePaintHook-Hookprozedur bereitstellen, um die Darstellung der Beispielseite anzupassen.

Um die Hookprozedur zu aktivieren, verwenden Sie die PAGESETUPDLG-Struktur , die Sie an die Erstellungsfunktion übergeben haben. Geben Sie den Zeiger auf die Hookprozedur im lpfnPagePaintHook-Member an, und geben Sie das PSD_ENABLEPAGEPAINTHOOK-Flag im Flags-Element an.

Wenn das Dialogfeld den Inhalt der Beispielseite zeichnen soll, empfängt die Hookprozedur die folgenden Meldungen in der Reihenfolge, in der sie aufgelistet sind.

Nachricht Bedeutung
WM_PSD_PAGESETUPDLG Das Dialogfeld ist dabei, die Beispielseite zu zeichnen. Die Hookprozedur kann diese Meldung verwenden, um den Inhalt der Beispielseite vorzubereiten.
WM_PSD_FULLPAGERECT Das Dialogfeld ist dabei, die Beispielseite zu zeichnen. Diese Meldung gibt das begrenzungsbasierte Rechteck der Beispielseite an.
WM_PSD_MINMARGINRECT Das Dialogfeld ist dabei, die Beispielseite zu zeichnen. Diese Meldung gibt das Randrechteck an.
WM_PSD_MARGINRECT Das Dialogfeld zeichnet das Randrechteck.
WM_PSD_GREEKTEXTRECT Das Dialogfeld zeichnet den griechischen Text im Randrechteck.
WM_PSD_ENVSTAMPRECT Das Dialogfeld zeichnet das Umschlag-Stempel-Rechteck einer Umschlagbeispielseite ein. Diese Nachricht wird nur für Umschläge gesendet.
WM_PSD_YAFULLPAGERECT Das Dialogfeld zeichnet den Teil der Rücksendeadresse einer Umschlagbeispielseite. Diese Nachricht wird für Umschläge und andere Papierformate gesendet.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile commdlg.h (einschließlich Windows.h)

Weitere Informationen

Allgemeine Dialogfeldbibliothek

Konzept

PAGESETUPDLG

PageSetupDlg

Referenz