PageSetupDialog Klasa

Odwołanie

Definicja

Przestrzeń nazw:: System.Windows.Forms

Zestaw:: System.Windows.Forms.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

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.

Konstruktory

PageSetupDialog()

Inicjuje nowe wystąpienie klasy PageSetupDialog.

Właściwości

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.
CanRaiseEvents	Pobiera wartość wskazującą, czy składnik może zgłosić zdarzenie. (Odziedziczone po Component)
Container	Pobiera element IContainer zawierający element Component. (Odziedziczone po Component)
DesignMode	Pobiera wartość wskazującą, czy Component element jest obecnie w trybie projektowania. (Odziedziczone po Component)
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.
Events	Pobiera listę programów obsługi zdarzeń dołączonych do tego Componentelementu . (Odziedziczone po Component)
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.
Site	Pobiera lub ustawia ISite element .Component (Odziedziczone po Component)
Tag	Pobiera lub ustawia obiekt zawierający dane dotyczące kontrolki. (Odziedziczone po CommonDialog)

Metody

CreateObjRef(Type)	Tworzy obiekt zawierający wszystkie istotne informacje wymagane do wygenerowania serwera proxy używanego do komunikowania się z obiektem zdalnym. (Odziedziczone po MarshalByRefObject)
Dispose()	Zwalnia wszelkie zasoby używane przez element Component. (Odziedziczone po Component)
Dispose(Boolean)	Zwalnia zasoby niezarządzane używane przez element Component i opcjonalnie zwalnia zasoby zarządzane. (Odziedziczone po Component)
Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetLifetimeService()	Przestarzałe. Pobiera bieżący obiekt usługi okresu istnienia, który kontroluje zasady okresu istnienia dla tego wystąpienia. (Odziedziczone po MarshalByRefObject)
GetService(Type)	Zwraca obiekt reprezentujący usługę dostarczaną przez Component obiekt lub przez obiekt Container. (Odziedziczone po Component)
GetType()	Type Pobiera bieżące wystąpienie. (Odziedziczone po Object)
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. (Odziedziczone po CommonDialog)
InitializeLifetimeService()	Przestarzałe. Uzyskuje obiekt usługi okresu istnienia, aby kontrolować zasady okresu istnienia dla tego wystąpienia. (Odziedziczone po MarshalByRefObject)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
MemberwiseClone(Boolean)	Tworzy płytkią kopię bieżącego MarshalByRefObject obiektu. (Odziedziczone po MarshalByRefObject)
OnHelpRequest(EventArgs)	HelpRequest Zgłasza zdarzenie. (Odziedziczone po 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. (Odziedziczone po 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. (Odziedziczone po CommonDialog)
ShowDialog()	Uruchamia wspólne okno dialogowe z domyślnym właścicielem. (Odziedziczone po CommonDialog)
ShowDialog(IWin32Window)	Uruchamia wspólne okno dialogowe z określonym właścicielem. (Odziedziczone po CommonDialog)
ToString()	Zwraca wartość String zawierającą nazwę Componentobiektu , jeśli istnieje. Ta metoda nie powinna być zastępowana. (Odziedziczone po Component)

Zdarzenia

Disposed	Występuje, gdy składnik jest usuwany przez wywołanie Dispose() metody . (Odziedziczone po Component)
HelpRequest	Występuje, gdy użytkownik kliknie przycisk Pomoc w typowym oknie dialogowym. (Odziedziczone po CommonDialog)

Dotyczy