PAGESETUPDLG

Die PAGESETUPDLG -Struktur enthält Informationen, die die PageSetupDlg -Funktion verwendet, um das Dialogfeld Seite Einrichten gemeinsame initialisieren. Nachdem der Benutzer das Dialogfeld geschlossen wurde, gibt das System Informationen über die Seite benutzerdefinierte Parameter in dieser Struktur.

typedef Struct TagPSD {/ / Psd DWORD lStructSize; 
    HWND HwndOwner; 
    HGLOBAL hDevMode; 
    HGLOBAL hDevNames; 
    DWORD Flags; 
    Punkt PtPaperSize; 
    RECT RtMinMargin; 
    RECT RtMargin; 
    HINSTANCE hInstance; 
    LPARAM lCustData; 
    LPPAGESETUPHOOK LpfnPageSetupHook; 
    LPPAGEPAINTHOOK LpfnPagePaintHook; 
    LPCTSTR LpPageSetupTemplateName; 
    HGLOBAL hPageSetupTemplate; 
} PAGESETUPDLG, * LPPAGESETUPDLG 

 

Mitglieder

lStructSize
Gibt die Größe in Bytes, der Struktur.
hwndOwner
Identifiziert das Fenster, das das Dialogfeld besitzt. Dieser Member kann gültiges Fensterhandle, oder es kann NULL sein, wenn das Dialogfeld keine Besitzer hat.
hDevMode
Handle für ein Objekt globalen Speicher, enthält eine DEVMODE -Struktur. Bei der Eingabe wird ein Handle angegeben, werden die Werte in die entsprechenden DEVMODE -Struktur verwendet, um die Steuerelemente im Dialogfeld zu initialisieren. Bei der Ausgabe im Dialogfeld Box-Sets hDevMode um ein globales Speicherhandle für eine DEVMODE -Struktur, die enthält Werte, die Angabe der Benutzerauswahl. Wenn die Benutzerauswahl nicht verfügbar sind, wird das Dialogfeld hDevMode auf NULL.
hDevNames
Handle für einen globalen Speicher-Objekt, das eine DEVNAMES -Struktur enthält. Diese Struktur enthält drei Zeichenfolgen, die den Treibernamen, den Namen des Druckers und den Ausgabenamen Port angeben. Bei der Eingabe wird ein Handle angegeben, werden die Zeichenfolgen in der entsprechenden DEVNAMES -Struktur verwendet, um Steuerelemente im Dialogfeld zu initialisieren. Bei der Ausgabe im Dialogfeld Box-Sets hDevNames um ein globales Speicherhandle für eine DEVNAMES -Struktur, die Angabe der Benutzerauswahl Zeichenfolgen enthält. Wenn die Benutzerauswahl nicht verfügbar sind, wird das Dialogfeld hDevNames auf NULL.
Flaggen
Ein Satz von Bitflags, die Sie verwenden können, um das allgemeine Dialogfeld Seite Einrichten zu initialisieren. Wenn das Dialogfeld zurückgegeben wird, legt diese Flags an die Eingabe des Benutzers fest. Dieser Member kann eine Kombination der folgenden Flags sein:
PSD_DEFAULTMINMARGINS
Legt die minimale Werte, die der Benutzer für die Seitenränder werden die minimalen Seitenränder erlaubt durch den Drucker angeben können. Dies ist die Standardeinstellung. Dieses Flag wird ignoriert, wenn die Flags PSD_MARGINS und PSD_MINMARGINS ebenfalls angegeben werden.
PSD_DISABLEMARGINS
Deaktiviert die Randeinstellungen, verhindert, dass des Benutzers die Seitenränder festlegen.
PSD_DISABLEORIENTATION
Deaktiviert die Ausrichtung Steuerelemente, verhindert, dass des Benutzers die Seitenausrichtung festlegen.
PSD_DISABLEPAGEPAINTING
Verhindert, dass das Dialogfeld zeichnen den Inhalt der Seite. Wenn Sie eine PagePaintHook -Hook-Prozedur aktivieren, können Sie immer noch den Inhalt von der Seite zeichnen.
PSD_DISABLEPAPER
Deaktiviert die Papier-Steuerelementen verhindert, dass des Benutzers festlegen Seitenparameter wie das Papierformat und die Quelle.
PSD_DISABLEPRINTER
Deaktiviert die Schaltfläche Drucker , verhindert, dass des Benutzers ein Dialogfeld mit zusätzlichen Drucker-Setup-Informationen aufrufen.
PSD_ENABLEPAGEPAINTHOOK
Ermöglicht die Hook-Prozedur in den LpfnPagePaintHook angegeben.
PSD_ENABLEPAGESETUPHOOK
Ermöglicht die Hook-Prozedur in den LpfnPageSetupHook angegeben.
PSD_ENABLEPAGESETUPTEMPLATE
Gibt an, dass die hInstance und LpPageSetupTemplateName Mitglieder eine Dialogfeld Feld Vorlage statt der Standardvorlage verwenden angeben.
PSD_ENABLEPAGESETUPTEMPLATEHANDLE
Gibt an, dass das hPageSetupTemplate Mitglied ein Datenblockes identifiziert, das eine vorgespannte Dialogfeld Feld Vorlage enthält. Das System ignoriert den LpPageSetupTemplateName Member, wenn dieses Flag angegeben ist.
PSD_INHUNDREDTHSOFMILLIMETERS
Gibt an, dass Hundertstel Millimeter die Maßeinheit für Seitenränder sind und Papierformat. Die Werte in die Member RtMargin, RtMinMarginund PtPaperSize sind in Hundertstel Millimeter. Sie können dieses Flag für Eingabe überschreiben die Standardmaßeinheit für das Gebietsschema des Benutzers festlegen. Wenn die Funktion zurückgibt, verwendet der Dialog-Box-Sets dieses Flag an die Einheiten.
PSD_INTHOUSANDTHSOFINCHES
Gibt an, dass Tausendstel Zoll die Maßeinheit für Seitenränder sind und Papierformat. Die Werte in die Member RtMargin, RtMinMarginund PtPaperSize sind in tausendstel von Zoll. Sie können dieses Flag für Eingabe überschreiben die Standardmaßeinheit für das Gebietsschema des Benutzers festlegen. Wenn die Funktion zurückgibt, verwendet der Dialog-Box-Sets dieses Flag an die Einheiten.
PSD_INWININIINTLMEASURE
Nicht implementiert.
PSD_MARGINS
Bewirkt, dass das System die Werte in den RtMargin als die anfängliche Breite für die Left, Top, rechten und unteren Seitenrand angegeben verwenden. Wenn PSD_MARGINS nicht festgelegt ist, setzt das System die ersten Breite auf ein Zoll für alle Ränder.
PSD_MINMARGINS
Bewirkt, dass das System die Werte in den RtMinMargin als die zulässige Mindestbreite für die Left, Top, rechten und unteren Seitenrand angegeben verwenden. Das System verhindert, dass Benutzer eingeben, die kleiner als die angegebene minimale Breite. Wenn PSD_MINMARGINS nicht angegeben wird, setzt das System die zulässige Mindestbreite für diejenigen erlaubt durch den Drucker.
PSD_NONETWORKBUTTON
Ausgeblendet und deaktiviert die Schaltfläche Netzwerk.
PSD_NOWARNING
Verhindert, dass das System eine Warnmeldung anzeigen, wenn es kein Standarddrucker ist.
PSD_RETURNDEFAULT
PageSetupDlg wird das Dialogfeld nicht angezeigt. Stattdessen setzt das hDevNames und hDevMode Mitglieder auf Handles zu DEVMODE und DEVNAMES -Strukturen, die für den System-Standarddrucker initialisiert werden. PageSetupDlg gibt einen Fehler zurück, wenn entweder hDevNames oder hDevMode nicht NULL ist.
PSD_SHOWHELP
Bewirkt, dass das Dialogfeld die Schaltfläche Hilfe anzeigen. Das HwndOwner -Mitglied muss angeben, dass das Fenster die HELPMSGSTRING empfangen Nachrichten registriert, die im Dialogfeld sendet, wenn der Benutzer die Schaltfläche Hilfe klickt.

ptPaperSize
Gibt die Größe des vom Benutzer ausgewählten Papiers. Die PSD_INTHOUSANDTHSOFINCHES oder PSD_INHUNDREDTHSOFMILLIMETERS-Flag gibt an, die Maßeinheiten.
rtMinMargin
Gibt die zulässige Mindestbreite für die Left, Top, rechten und unteren Seitenrand. Das System ignoriert diese Member, wenn das PSD_MINMARGINS-Flag nicht gesetzt ist. Diese Werte müssen kleiner oder gleich den Werten in der RtMargin -Mitglied sein. Die PSD_INTHOUSANDTHSOFINCHES oder PSD_INHUNDREDTHSOFMILLIMETERS-Flag gibt an, die Maßeinheiten.
rtMargin
Gibt die Breite der die Left, Top, rechten und unteren Seitenrand. Wenn Sie das PSD_MARGINS-Flag festgelegt, gibt RtMargin die initial Margin-Werte. Wenn PageSetupDlg zurückgibt, enthält RtMargin die breiten Rand vom Benutzer ausgewählten. Die PSD_INHUNDREDTHSOFMILLIMETERS oder PSD_INTHOUSANDTHSOFINCHES-Flag gibt an, die Maßeinheiten.
hInstance
Wenn das PSD_ENABLEPAGESETUPTEMPLATE-Flag in den Flags festgelegt ist, ist hInstance das Handle der Anwendung oder Modul-Instanz, die das Dialogfeld Feld Vorlage durch das LpPageSetupTemplateName -Element mit dem Namen enthält.
lCustData
Gibt anwendungsdefinierten Daten, die das System an die Hook-Prozedur durch das LpfnPageSetupHook -Element identifiziert wird. Wenn das System die WM_INITDIALOG -Meldung an die Hook-Prozedur sendet, ist die Nachricht lParam -Parameter ein Zeiger auf die Struktur PAGESETUPDLG angegeben, wenn das Dialogfeld erstellt wurde. Die Hook-Prozedur können diesen Zeiger zum Abrufen des Werts lCustData.
lpfnPageSetupHook
Zeiger auf ein PageSetupHook Haken Verfahren, die Nachrichten für das Dialogfeld verarbeiten kann. Dieser Member wird ignoriert, es sei denn, das PSD_ENABLEPAGESETUPHOOK-Flag in den Flags gesetzt ist.
lpfnPagePaintHook
Zeiger auf eine PagePaintHook hook-Prozedur, die im Dialogfeld WM_PSD_-Nachrichten empfängt, wenn die Beispielseite neu gezeichnet wird. Durch die Verarbeitung der Nachrichten, kann die Hook-Prozedur das Erscheinungsbild der Beispielseite. Dieser Member wird ignoriert, es sei denn, das PSD_ENABLEPAGEPAINTHOOK-Flag in den Flags gesetzt ist.
lpPageSetupTemplateName
Zeiger auf eine auf Null endende Zeichenfolge, die Vorlage die Dialogfeldressource im Modul identifiziert das hInstance -Mitglied benennt. Diese Vorlage ist für das standard-Dialogfeld Feld Vorlage ersetzt. Für nummerierte Dialogfeld Feld Ressourcen können LpPageSetupTemplateName einen Wert des Makros MAKEINTRESOURCE zurückgegeben werden. Dieser Member wird ignoriert, es sei denn, das PSD_ENABLEPAGESETUPTEMPLATE-Flag in den Flags gesetzt ist.
hPageSetupTemplate
Wenn das PSD_ENABLEPAGESETUPTEMPLATEHANDLE-Flag in den Flags festgelegt ist, ist hPageSetupTemplate das Handle für ein Objekt mit eine Dialogfeldvorlage.

Bemerkungen

Wenn die Flags PSD_INHUNDREDTHSOFMILLIMETERS und PSD_INTHOUSANDTHSOFINCHES nicht angegeben sind, fragt das System den LOCALE_IMEASURE-Wert, der die Standard-Benutzergebietsschema zu bestimmen, die Maßeinheit (Hundertstel Millimeter) oder Tausendstel Zoll breiten Rand und Papierformat.

Wenn hDevNames und hDevMode gültig angegeben Griffe und den Namen des Druckers von der wDeviceOffset -Member der Struktur DEVNAMES mit denen ist nicht identisch mit dem Namen angegeben von der DmDeviceName -Member der DEVMODE -Struktur, verwendet das System den Namen von wDeviceOffset angegebenen Konfliktprotokolls durch Standard.

QuickInfo

&Nbsp; Windows NT: Version 3.51 oder höher erforderlich.
Windows:Erfordert Windows 95 oder höher.
Windows CE:Nicht unterstützt.
Header:In commdlg.h deklariert.
Unicode:Als Unicode und ANSI Strukturen definiert.

Siehe auch

Übersicht über Common Dialog Box Library, gemeinsamen Dialog Box Strukturen, DEVMODE, DEVNAMES, MAKEINTRESOURCE, PagePaintHook, PageSetupDlg, PageSetupHook, WM_INITDIALOG

Index