PAGESETUPDLGA-Struktur (commdlg.h)

Enthält Informationen, die die PageSetupDlg-Funktion zum Initialisieren des Dialogfelds Seite einrichten verwendet. Nachdem der Benutzer das Dialogfeld geschlossen hat, gibt das System Informationen zu den benutzerdefinierten Seitenparametern in dieser Struktur zurück.

Syntax

typedef struct tagPSDA {
  DWORD           lStructSize;
  HWND            hwndOwner;
  HGLOBAL         hDevMode;
  HGLOBAL         hDevNames;
  DWORD           Flags;
  POINT           ptPaperSize;
  RECT            rtMinMargin;
  RECT            rtMargin;
  HINSTANCE       hInstance;
  LPARAM          lCustData;
  LPPAGESETUPHOOK lpfnPageSetupHook;
  LPPAGEPAINTHOOK lpfnPagePaintHook;
  LPCSTR          lpPageSetupTemplateName;
  HGLOBAL         hPageSetupTemplate;
} PAGESETUPDLGA, *LPPAGESETUPDLGA;

Member

lStructSize

Art: DWORD

Die Größe (in Bytes) dieser Struktur.

hwndOwner

Typ: HWND

Ein Handle für das Fenster, das das Dialogfeld besitzt. Bei diesem Member kann es sich um ein beliebiges gültiges Fensterhandle handeln, oder es kann NULL sein, wenn das Dialogfeld keinen Besitzer hat.

hDevMode

Typ: HGLOBAL

Ein Handle für ein globales Speicherobjekt, das eine DEVMODE-Struktur enthält. Wenn bei der Eingabe ein Handle angegeben wird, werden die Werte in der entsprechenden DEVMODE-Struktur verwendet, um die Steuerelemente im Dialogfeld zu initialisieren. Bei der Ausgabe legt das Dialogfeld hDevMode auf ein globales Speicherhandle auf eine DEVMODE-Struktur fest, die Werte enthält, die die Auswahl des Benutzers angeben. Wenn die Auswahl des Benutzers nicht verfügbar ist, legt das Dialogfeld hDevMode auf NULL fest.

hDevNames

Typ: HGLOBAL

Ein Handle für ein globales Speicherobjekt, das eine DEVNAMES-Struktur enthält. Diese Struktur enthält drei Zeichenfolgen, die den Treibernamen, den Druckernamen und den Namen des Ausgabeports angeben. Wenn bei der Eingabe ein Handle angegeben wird, werden die Zeichenfolgen in der entsprechenden DEVNAMES-Struktur verwendet, um Steuerelemente im Dialogfeld zu initialisieren. In der Ausgabe legt das Dialogfeld hDevNames auf ein globales Speicherhandle auf eine DEVNAMES-Struktur fest, die Zeichenfolgen enthält, die die Auswahl des Benutzers angeben. Wenn die Auswahl des Benutzers nicht verfügbar ist, legt das Dialogfeld hDevNames auf NULL fest.

Flags

Art: DWORD

Eine Reihe von Bitflags, die Sie verwenden können, um das Dialogfeld Seite einrichten zu initialisieren. Wenn das Dialogfeld zurückgegeben wird, werden diese Flags festgelegt, um die Eingabe des Benutzers anzugeben. Bei diesem Member kann es sich um einen oder mehrere der folgenden Werte handeln.

ptPaperSize

Typ: POINT

Die Abmessungen des vom Benutzer ausgewählten Papiers. Das flag PSD_INTHOUSANDTHSOFINCHES oder PSD_INHUNDREDTHSOFMILLIMETERS gibt die Maßeinheiten an.

rtMinMargin

Typ: RECT

Die zulässigen Mindestbreiten für den linken, oberen, rechten und unteren Rand. Das System ignoriert diesen Member, wenn das flag PSD_MINMARGINS nicht festgelegt ist. Diese Werte müssen kleiner oder gleich den im rtMargin-Element angegebenen Werten sein. Das flag PSD_INTHOUSANDTHSOFINCHES oder PSD_INHUNDREDTHSOFMILLIMETERS gibt die Maßeinheiten an.

rtMargin

Typ: RECT

Die Breite des linken, oberen, rechten und unteren Rands. Wenn Sie das PSD_MARGINS-Flag festlegen, gibt rtMargin die anfänglichen Randwerte an. Wenn PageSetupDlg zurückgegeben wird, enthält rtMargin die vom Benutzer ausgewählten Randbreiten. Das flag PSD_INHUNDREDTHSOFMILLIMETERS oder PSD_INTHOUSANDTHSOFINCHES gibt die Maßeinheiten an.

hInstance

Typ: HINSTANCE

Wenn das flag PSD_ENABLEPAGESETUPTEMPLATE im Flags-Element festgelegt ist, ist hInstance ein Handle für die Anwendung oder das Modul instance, das die Dialogfeldvorlage enthält, die vom LpPageSetupTemplateName-Element benannt ist.

lCustData

Typ: LPARAM

Anwendungsdefinierte Daten, die das System an die Hookprozedur übergibt, die vom lpfnPageSetupHook-Element identifiziert wird. Wenn das System die WM_INITDIALOG Nachricht an die Hookprozedur sendet, ist der lParam-Parameter der Nachricht ein Zeiger auf die PAGESETUPDLG-Struktur , die beim Erstellen des Dialogfelds angegeben wurde. Die Hookprozedur kann diesen Zeiger verwenden, um den lCustData-Wert abzurufen.

lpfnPageSetupHook

Typ: LPPAGESETUPHOOK

Ein Zeiger auf eine PageSetupHook-Hookprozedur , die nachrichten verarbeiten kann, die für das Dialogfeld vorgesehen sind. Dieser Member wird ignoriert, es sei denn, das flag PSD_ENABLEPAGESETUPHOOK ist im Flags-Element festgelegt.

lpfnPagePaintHook

Typ: LPPAGEPAINTHOOK

Ein Zeiger auf eine PagePaintHook-Hookprozedur , die WM_PSD_* -Nachrichten aus dem Dialogfeld empfängt, wenn die Beispielseite neu gezeichnet wird. Durch die Verarbeitung der Nachrichten kann die Hookprozedur das Erscheinungsbild der Beispielseite anpassen. Dieser Member wird ignoriert, es sei denn, das flag PSD_ENABLEPAGEPAINTHOOK im Flags-Element festgelegt ist.

lpPageSetupTemplateName

Typ: LPCTSTR

Der Name der Dialogfeldvorlagenressource in dem Modul, das vom hInstance-Element identifiziert wird. Diese Vorlage wird durch die Standarddialogfeldvorlage ersetzt. Für nummerierte Dialogfeldressourcen kann lpPageSetupTemplateName ein Wert sein, der vom MAKEINTRESOURCE-Makro zurückgegeben wird. Dieser Member wird ignoriert, es sei denn , das flag PSD_ENABLEPAGESETUPTEMPLATE ist im Flags-Member festgelegt.

hPageSetupTemplate

Typ: HGLOBAL

Wenn das flag PSD_ENABLEPAGESETUPTEMPLATEHANDLE im Flags-Element festgelegt ist, ist hPageSetupTemplate ein Handle für ein Speicherobjekt, das eine Dialogfeldvorlage enthält.

Hinweise

Wenn die flags PSD_INHUNDREDTHSOFMILLIMETERS und PSD_INTHOUSANDTHSOFINCHES nicht angegeben sind, fragt das System den LOCALE_IMEASURE Wert des Standardbenutzergebietsschemas ab, um die Maßeinheit (entweder Hundertstel Millimeter oder Tausendstel Zoll) für die Randbreiten und das Papierformat zu bestimmen.

Wenn sowohl hDevNames als auch hDevMode über gültige Handles verfügen und der vom wDeviceOffset-Member der DEVNAMES-Struktur angegebene Druckername nicht mit dem namen übereinstimmt, der vom dmDeviceName-Member der DEVMODE-Struktur angegeben wird, verwendet das System standardmäßig den namen, der von wDeviceOffset angegeben wird.

Anforderungen

Weitere Informationen

Allgemeine Dialogfeldbibliothek

Konzept

DEVMODE

DEVNAMES

MAKEINTRESOURCE

Andere Ressourcen

PagePaintHook

PageSetupDlg

PageSetupHook

Referenz

WM_INITDIALOG