PageSetupDialog Klasa

Definicja

Namespace:

System.Windows.Forms

Montaż:

System.Windows.Forms.dll

Źródło:

PageSetupDialog.cs

Umożliwia użytkownikom zmianę ustawień drukowania związanych ze stroną, w tym marginesów i orientacji papieru. Klasa ta nie może być dziedziczona.

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

Dziedziczenie

Object

MarshalByRefObject

Component

CommonDialog

PageSetupDialog

Przykłady

Poniższy przykład kodu przedstawia PageSetupDialog użycie właściwości PageSettings, PrinterSettingsi ShowNetwork . Aby uruchomić ten przykład, umieść go w formularzu zawierającym nazwę , nazwaną ListBox1i nazwaną PageSetupDialog1PageSetupDialog .ListBoxButton1Button Upewnij się, że zdarzenie kliknięcia przycisku jest połączone z metodą obsługi zdarzeń w tym przykładzie.

//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

Uwagi

Okno PageSetupDialog dialogowe modyfikuje PageSettings informacje i PrinterSettings dla danego Documentelementu . Użytkownik może włączyć sekcje okna dialogowego w celu manipulowania drukowaniem i marginesami; orientacja papieru, rozmiar i źródło; i wyświetlić przyciski Pomoc i sieć. Właściwość MinMargins definiuje minimalne marginesy, które użytkownik może wybrać.

Podczas tworzenia wystąpienia PageSetupDialog klasy właściwości odczytu/zapisu są ustawione na wartości początkowe. Aby uzyskać listę tych wartości, zobacz PageSetupDialog konstruktor.

PageSetupDialog Ponieważ wymagane są ustawienia strony do wyświetlenia, należy ustawić Documentwłaściwość , PrinterSettingslub PageSettings przed wywołaniem metody ShowDialog; w przeciwnym razie wystąpi wyjątek.

Konstruktorów

Nazwa	Opis
PageSetupDialog()	Inicjuje nowe wystąpienie klasy PageSetupDialog.

Właściwości

Nazwa	Opis
AllowMargins	Pobiera lub ustawia wartość wskazującą, czy sekcja marginesów okna dialogowego jest włączona.
AllowOrientation	Pobiera lub ustawia wartość wskazującą, czy jest włączona sekcja orientacji okna dialogowego (pozioma i pionowa).
AllowPaper	Pobiera lub ustawia wartość wskazującą, czy jest włączona sekcja papieru okna dialogowego (rozmiar papieru i źródło papieru).
AllowPrinter	Pobiera lub ustawia wartość wskazującą, czy przycisk Drukarka jest włączony.
Document	Pobiera lub ustawia wartość wskazującą PrintDocument , z których mają być wyświetlane ustawienia strony.
EnableMetric	Pobiera lub ustawia wartość wskazującą, czy ustawienia marginesu, gdy są wyświetlane w milimetrach, powinny być automatycznie konwertowane na i z setek cala.
MinMargins	Pobiera lub ustawia wartość wskazującą minimalne marginesy, w setkach cala, użytkownik może wybrać.
PageSettings	Pobiera lub ustawia wartość wskazującą ustawienia strony do zmodyfikowania.
PrinterSettings	Pobiera lub ustawia ustawienia drukarki, które są modyfikowane po kliknięciu przycisku Drukarka w oknie dialogowym.
ShowHelp	Pobiera lub ustawia wartość wskazującą, czy przycisk Pomoc jest widoczny.
ShowNetwork	Pobiera lub ustawia wartość wskazującą, czy przycisk Sieć jest widoczny.
Tag	Pobiera lub ustawia obiekt zawierający dane dotyczące kontrolki. (Dziedziczone od CommonDialog)

Metody

Nazwa	Opis
HookProc(IntPtr, Int32, IntPtr, IntPtr)	Definiuje wspólną procedurę zaczepienia okna dialogowego, która jest zastępowana w celu dodania określonych funkcji do wspólnego okna dialogowego. (Dziedziczone od CommonDialog)
OnHelpRequest(EventArgs)	HelpRequest Zgłasza zdarzenie. (Dziedziczone od CommonDialog)
OwnerWndProc(IntPtr, Int32, IntPtr, IntPtr)	Definiuje procedurę okna właściciela, która jest zastępowana, aby dodać określone funkcje do wspólnego okna dialogowego. (Dziedziczone od CommonDialog)
Reset()	Resetuje wszystkie opcje do ich wartości domyślnych.
RunDialog(IntPtr)	W przypadku zastąpienia w klasie pochodnej określa wspólne okno dialogowe. (Dziedziczone od CommonDialog)
ShowDialog()	Uruchamia wspólne okno dialogowe z domyślnym właścicielem. (Dziedziczone od CommonDialog)
ShowDialog(IWin32Window)	Uruchamia wspólne okno dialogowe z określonym właścicielem. (Dziedziczone od CommonDialog)

Zdarzenia

Nazwa	Opis
HelpRequest	Występuje, gdy użytkownik kliknie przycisk Pomoc w typowym oknie dialogowym. (Dziedziczone od CommonDialog)

Zobacz także

• CommonDialog
• Margins
• PageSettings
• PrintDocument
• PrinterSettings