PageSetupDialog Klasse

Referenz

Definition

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Ermöglicht Benutzern das Ändern seitenbezogener Druckeinstellungen, einschließlich Ränder und Seitenausrichtung. Diese Klasse kann nicht vererbt werden.

public ref class PageSetupDialog sealed : System::Windows::Forms::CommonDialog

public sealed class PageSetupDialog : System.Windows.Forms.CommonDialog

type PageSetupDialog = class
    inherit CommonDialog

Public NotInheritable Class PageSetupDialog
Inherits CommonDialog

Vererbung: Object

MarshalByRefObject

Component

CommonDialog
PageSetupDialog

Beispiele

Im folgenden Codebeispiel wird die Verwendung der PageSetupDialog PageSettingsEigenschaften , PrinterSettingsund ShowNetwork veranschaulicht. Um dieses Beispiel auszuführen, platzieren Sie es in einem Formular mit dem Namen , einem ListBox namens ListBox1und einem PageSetupDialog mit dem Namen PageSetupDialog1.Button1Button Stellen Sie sicher, dass das Klickereignis der Schaltfläche mit der Ereignisbehandlungsmethode in diesem Beispiel verbunden ist.

//This method displays a PageSetupDialog object. If the
// user clicks OK in the dialog, selected results of
// the dialog are displayed in ListBox1.
void Button1_Click( System::Object^ /*sender*/, System::EventArgs^ /*e*/ )
{
   
   // Initialize the dialog's PrinterSettings property to hold user
   // defined printer settings.
   PageSetupDialog1->PageSettings = gcnew System::Drawing::Printing::PageSettings;
   
   // Initialize dialog's PrinterSettings property to hold user
   // set printer settings.
   PageSetupDialog1->PrinterSettings = gcnew System::Drawing::Printing::PrinterSettings;
   
   //Do not show the network in the printer dialog.
   PageSetupDialog1->ShowNetwork = false;
   
   //Show the dialog storing the result.
   System::Windows::Forms::DialogResult result = PageSetupDialog1->ShowDialog();
   
   // If the result is OK, display selected settings in
   // ListBox1. These values can be used when printing the
   // document.
   if ( result == ::DialogResult::OK )
   {
      array<Object^>^results = {PageSetupDialog1->PageSettings->Margins,PageSetupDialog1->PageSettings->PaperSize,PageSetupDialog1->PageSettings->Landscape,PageSetupDialog1->PrinterSettings->PrinterName,PageSetupDialog1->PrinterSettings->PrintRange};
      ListBox1->Items->AddRange( results );
   }
   
}


//This method displays a PageSetupDialog object. If the
// user clicks OK in the dialog, selected results of
// the dialog are displayed in ListBox1.
private void Button1_Click(System.Object sender, System.EventArgs e)
{

    // Initialize the dialog's PrinterSettings property to hold user
    // defined printer settings.
    PageSetupDialog1.PageSettings =
        new System.Drawing.Printing.PageSettings();

    // Initialize dialog's PrinterSettings property to hold user
    // set printer settings.
    PageSetupDialog1.PrinterSettings =
        new System.Drawing.Printing.PrinterSettings();

    //Do not show the network in the printer dialog.
    PageSetupDialog1.ShowNetwork = false;

    //Show the dialog storing the result.
    DialogResult result = PageSetupDialog1.ShowDialog();

    // If the result is OK, display selected settings in
    // ListBox1. These values can be used when printing the
    // document.
    if (result == DialogResult.OK)
    {
        object[] results = new object[]{ 
            PageSetupDialog1.PageSettings.Margins, 
            PageSetupDialog1.PageSettings.PaperSize, 
            PageSetupDialog1.PageSettings.Landscape, 
            PageSetupDialog1.PrinterSettings.PrinterName, 
            PageSetupDialog1.PrinterSettings.PrintRange};
        ListBox1.Items.AddRange(results);
    }
}


'This method displays a PageSetupDialog object. If the
' user clicks OK in the dialog, selected results of
' the dialog are displayed in ListBox1.
Private Sub Button1_Click(ByVal sender As System.Object, _
    ByVal e As System.EventArgs) Handles Button1.Click

    ' Initialize the dialog's PrinterSettings property to hold user
    ' defined printer settings.
    PageSetupDialog1.PageSettings = _
        New System.Drawing.Printing.PageSettings

    ' Initialize dialog's PrinterSettings property to hold user
    ' set printer settings.
    PageSetupDialog1.PrinterSettings = _
        New System.Drawing.Printing.PrinterSettings

    'Do not show the network in the printer dialog.
    PageSetupDialog1.ShowNetwork = False

    'Show the dialog storing the result.
    Dim result As DialogResult = PageSetupDialog1.ShowDialog()

    ' If the result is OK, display selected settings in
    ' ListBox1. These values can be used when printing the
    ' document.
    If (result = DialogResult.OK) Then
        Dim results() As Object = New Object() _
            {PageSetupDialog1.PageSettings.Margins, _
             PageSetupDialog1.PageSettings.PaperSize, _
             PageSetupDialog1.PageSettings.Landscape, _
             PageSetupDialog1.PrinterSettings.PrinterName, _
             PageSetupDialog1.PrinterSettings.PrintRange}
        ListBox1.Items.AddRange(results)
    End If

End Sub

Hinweise

Das PageSetupDialog Dialogfeld ändert die PageSettings Informationen und PrinterSettings für eine bestimmte Document. Der Benutzer kann Abschnitte des Dialogfelds aktivieren, um Druck und Seitenränder zu bearbeiten. Papierausrichtung, Größe und Quelle; und, um Hilfe- und Netzwerkschaltflächen anzuzeigen. Die MinMargins -Eigenschaft definiert die Mindestränder, die ein Benutzer auswählen kann.

Wenn Sie eine instance der PageSetupDialog -Klasse erstellen, werden die Lese-/Schreibeigenschaften auf Anfangswerte festgelegt. Eine Liste dieser Werte finden Sie im PageSetupDialog Konstruktor.

Da seiteneinstellungen PageSetupDialog angezeigt werden müssen, müssen Sie die Document- PrinterSettingsoder PageSettings -Eigenschaft vor dem Aufruf ShowDialogfestlegen. Andernfalls tritt eine Ausnahme auf.

Konstruktoren

PageSetupDialog()

Initialisiert eine neue Instanz der PageSetupDialog-Klasse.

Eigenschaften

AllowMargins	Ruft einen Wert ab, der angibt, ob der Bereich Seitenränder des Dialogfelds aktiviert ist, oder legt diesen fest.
AllowOrientation	Ruft einen Wert ab, der angibt, ob der Bereich Ausrichtung des Dialogfelds (Querformat bzw. Hochformat) aktiviert ist, oder legt diesen fest.
AllowPaper	Ruft einen Wert ab, der angibt, ob der Bereich Papier des Dialogfelds (Papiergröße und Papierzufuhr) aktiviert ist, oder legt diesen fest.
AllowPrinter	Ruft einen Wert ab, der angibt, ob die Schaltfläche Drucker aktiviert ist, oder legt diesen fest.
CanRaiseEvents	Ruft einen Wert ab, der angibt, ob die Komponente ein Ereignis auslösen kann. (Geerbt von Component)
Container	Ruft die IContainer ab, die in der Component enthalten ist. (Geerbt von Component)
DesignMode	Ruft einen Wert ab, der angibt, ob sich Component gegenwärtig im Entwurfsmodus befindet. (Geerbt von Component)
Document	Ruft einen Wert ab, der das PrintDocument angibt, dessen Seiteneinstellungen übernommen werden sollen, oder legt diesen fest.
EnableMetric	Ruft einen Wert ab, der angibt, ob in Millimeter angezeigte Randeinstellungen automatisch in oder aus hundertstel Zoll konvertiert werden sollen, oder legt diesen fest.
Events	Ruft die Liste der Ereignishandler ab, die dieser Component angefügt sind. (Geerbt von Component)
MinMargins	Ruft einen Wert ab, der die von den Benutzern auswählbare minimale Randbreite in 1/100 Zoll angibt, oder legt diesen fest.
PageSettings	Ruft einen Wert ab, der die zu ändernden Seiteneinstellungen angibt, oder legt diesen fest.
PrinterSettings	Ruft die Druckereinstellungen ab, die geändert werden, wenn der Benutzer im Dialogfeld auf die Druckerschaltfläche klickt, oder legt diese fest.
ShowHelp	Ruft einen Wert ab, der angibt, ob die Schaltfläche Hilfe sichtbar ist, oder legt diesen fest.
ShowNetwork	Ruft einen Wert ab, der angibt, ob die Schaltfläche Netzwerk sichtbar ist, oder legt diesen fest.
Site	Ruft den ISite von Component ab oder legt ihn fest. (Geerbt von Component)
Tag	Ruft ein Objekt ab, das Daten bezüglich des Steuerelements enthält, oder legt dieses Objekt fest. (Geerbt von CommonDialog)

Methoden

CreateObjRef(Type)	Erstellt ein Objekt mit allen relevanten Informationen, die zum Generieren eines Proxys für die Kommunikation mit einem Remoteobjekt erforderlich sind. (Geerbt von MarshalByRefObject)
Dispose()	Gibt alle vom Component verwendeten Ressourcen frei. (Geerbt von Component)
Dispose(Boolean)	Gibt die von Component verwendeten nicht verwalteten Ressourcen und optional die verwalteten Ressourcen frei. (Geerbt von Component)
Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetLifetimeService()	Veraltet. Ruft das aktuelle Lebensdauerdienstobjekt ab, das die Lebensdauerrichtlinien für diese Instanz steuert. (Geerbt von MarshalByRefObject)
GetService(Type)	Gibt ein Objekt zurück, das einen von der Component oder von deren Container bereitgestellten Dienst darstellt. (Geerbt von Component)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
HookProc(IntPtr, Int32, IntPtr, IntPtr)	Definiert die Hookprozedur für Standarddialogfelder, die überschrieben wird, um einem Standarddialogfeld spezifische Funktionen hinzuzufügen. (Geerbt von CommonDialog)
InitializeLifetimeService()	Veraltet. Ruft ein Lebensdauerdienstobjekt zur Steuerung der Lebensdauerrichtlinie für diese Instanz ab. (Geerbt von MarshalByRefObject)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
MemberwiseClone(Boolean)	Erstellt eine flache Kopie des aktuellen MarshalByRefObject-Objekts. (Geerbt von MarshalByRefObject)
OnHelpRequest(EventArgs)	Löst das HelpRequest-Ereignis aus. (Geerbt von CommonDialog)
OwnerWndProc(IntPtr, Int32, IntPtr, IntPtr)	Definiert die Prozedur des Besitzerfensters, die überschrieben wird, um einem Standarddialogfeld spezifische Funktionen hinzuzufügen. (Geerbt von CommonDialog)
Reset()	Setzt alle Optionen auf die Standardwerte zurück.
RunDialog(IntPtr)	Wenn dies in einer abgeleiteten Klasse überschrieben wird, wird hierdurch ein Standarddialogfeld angegeben. (Geerbt von CommonDialog)
ShowDialog()	Führt ein Standarddialogfeld mit einem Standardbesitzer aus. (Geerbt von CommonDialog)
ShowDialog(IWin32Window)	Führt ein Standarddialogfeld mit dem angegebenen Besitzer aus. (Geerbt von CommonDialog)
ToString()	Gibt einen String zurück, der den Namen der Component enthält (sofern vorhanden). Diese Methode darf nicht überschrieben werden. (Geerbt von Component)

Ereignisse

Disposed	Tritt auf, wenn die Komponente von einem Aufruf der Dispose()-Methode verworfen wird. (Geerbt von Component)
HelpRequest	Tritt ein, wenn der Benutzer in einem Standarddialogfeld auf die Hilfeschaltfläche klickt. (Geerbt von CommonDialog)

Gilt für: