PageSetupDialog Classe

Definizione

Consente agli utenti di modificare le impostazioni di stampa relative alla pagina, inclusi i margini e l'orientamento della pagina.Enables users to change page-related print settings, including margins and paper orientation. Questa classe non può essere ereditata.This class cannot be inherited.

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
Ereditarietà

Esempi

Nell'esempio di codice riportato di PageSetupDialog seguito viene PageSettingsillustrato l'utilizzo ShowNetwork delle proprietà, PrinterSettingse.The following code example demonstrates the PageSetupDialog using the PageSettings, PrinterSettings, and ShowNetwork properties. Per eseguire questo esempio, posizionarlo in un form contenente un Button oggetto Button1denominato, ListBox un ListBox1oggetto denominato e PageSetupDialog un PageSetupDialog1oggetto denominato.To run this example, place it in a form containing a Button named Button1, a ListBox named ListBox1, and a PageSetupDialog named PageSetupDialog1. Verificare che l'evento click del pulsante sia connesso al metodo di gestione degli eventi in questo esempio.Ensure the button's click event is connected to the event-handling method in this example.

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

Commenti

La PageSetupDialog finestra di dialogo Modifica PageSettings le PrinterSettings informazioni e per un Documentdato.The PageSetupDialog dialog box modifies the PageSettings and PrinterSettings information for a given Document. L'utente può abilitare le sezioni della finestra di dialogo per modificare la stampa e i margini; orientamento, dimensioni e origine della carta; e per visualizzare i pulsanti guida e rete.The user can enable sections of the dialog box to manipulate printing and margins; paper orientation, size, and source; and to show Help and network buttons. La MinMargins proprietà definisce i margini minimi che un utente può selezionare.The MinMargins property defines the minimum margins a user can select.

Quando si crea un'istanza della PageSetupDialog classe, le proprietà di lettura/scrittura vengono impostate sui valori iniziali.When you create an instance of the PageSetupDialog class, the read/write properties are set to initial values. Per un elenco di questi valori, vedere il PageSetupDialog costruttore.For a list of these values, see the PageSetupDialog constructor.

Poiché un PageSetupDialog oggetto necessita di impostazioni della pagina da visualizzare, è necessario Documentimpostare PrinterSettingsla proprietà PageSettings , o prima ShowDialogdi chiamare. in caso contrario, si verificherà un'eccezione.Because a PageSetupDialog needs page settings to display, you need to set the Document, PrinterSettings, or PageSettings property before calling ShowDialog; otherwise, an exception will occur.

Costruttori

PageSetupDialog()

Inizializza una nuova istanza della classe PageSetupDialog.Initializes a new instance of the PageSetupDialog class.

Proprietà

AllowMargins

Ottiene o imposta un valore che indica se è abilitata la sezione dei margini della finestra di dialogo.Gets or sets a value indicating whether the margins section of the dialog box is enabled.

AllowOrientation

Ottiene o imposta un valore che indica se è abilitata la sezione della finestra di dialogo relativa all'orientamento (orizzontale o verticale).Gets or sets a value indicating whether the orientation section of the dialog box (landscape versus portrait) is enabled.

AllowPaper

Ottiene o imposta un valore che indica se la sezione relativa al foglio della finestra di dialogo (dimensione foglio e alimentazione) è abilitata.Gets or sets a value indicating whether the paper section of the dialog box (paper size and paper source) is enabled.

AllowPrinter

Ottiene o imposta un valore che indica se il pulsante Stampante è abilitato.Gets or sets a value indicating whether the Printer button is enabled.

CanRaiseEvents

Ottiene un valore che indica se il componente può generare un evento.Gets a value indicating whether the component can raise an event.

(Ereditato da Component)
Container

Ottiene il IContainer che contiene il Component.Gets the IContainer that contains the Component.

(Ereditato da Component)
DesignMode

Ottiene un valore che indica se il Component si trova in modalità progettazione.Gets a value that indicates whether the Component is currently in design mode.

(Ereditato da Component)
Document

Ottiene o imposta un valore che indica l'oggetto PrintDocument da cui ottenere le impostazioni di pagina.Gets or sets a value indicating the PrintDocument to get page settings from.

EnableMetric

Ottiene o imposta un valore che indica se le impostazioni del margine, se visualizzate in millimetri, devono essere convertite automaticamente da/in centesimi di pollice.Gets or sets a value indicating whether the margin settings, when displayed in millimeters, should be automatically converted to and from hundredths of an inch.

Events

Ottiene l'elenco dei gestori eventi allegati a questo Component.Gets the list of event handlers that are attached to this Component.

(Ereditato da Component)
MinMargins

Ottiene o imposta un valore che indica i margini minimi, in centesimi di pollice, selezionabili dall'utente.Gets or sets a value indicating the minimum margins, in hundredths of an inch, the user is allowed to select.

PageSettings

Ottiene o imposta un valore che indica le impostazioni di pagina da modificare.Gets or sets a value indicating the page settings to modify.

PrinterSettings

Ottiene o imposta le impostazioni della stampante che verranno modificate quando l'utente sceglie il pulsante Stampante nella finestra di dialogo.Gets or sets the printer settings that are modified when the user clicks the Printer button in the dialog.

ShowHelp

Ottiene o imposta un valore che indica se il pulsante ? è visibile.Gets or sets a value indicating whether the Help button is visible.

ShowNetwork

Ottiene o imposta un valore che indica se il pulsante Rete è visibile.Gets or sets a value indicating whether the Network button is visible.

Site

Ottiene o imposta l'oggetto ISite di Component.Gets or sets the ISite of the Component.

(Ereditato da Component)
Tag

Ottiene o imposta un oggetto che contiene i dati relativi al controllo.Gets or sets an object that contains data about the control.

(Ereditato da CommonDialog)

Metodi

CreateObjRef(Type)

Consente di creare un oggetto che contiene tutte le informazioni rilevanti necessarie per la generazione del proxy utilizzato per effettuare la comunicazione con un oggetto remoto.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Ereditato da MarshalByRefObject)
Dispose()

Rilascia tutte le risorse usate da Component.Releases all resources used by the Component.

(Ereditato da Component)
Dispose(Boolean)

Rilascia le risorse non gestite usate da Component e, facoltativamente, le risorse gestite.Releases the unmanaged resources used by the Component and optionally releases the managed resources.

(Ereditato da Component)
Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

(Ereditato da Object)
GetHashCode()

Funge da funzione hash predefinita.Serves as the default hash function.

(Ereditato da Object)
GetLifetimeService()

Consente di recuperare l'oggetto servizio di durata corrente per controllare i criteri di durata per l'istanza.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Ereditato da MarshalByRefObject)
GetService(Type)

Consente di restituire un oggetto che rappresenta un servizio fornito da Component o dal relativo Container.Returns an object that represents a service provided by the Component or by its Container.

(Ereditato da Component)
GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Ereditato da Object)
HookProc(IntPtr, Int32, IntPtr, IntPtr)

Consente di definire la routine di hook della finestra di dialogo comune di cui viene eseguito l'override per aggiungere funzionalità specifiche a una finestra di dialogo comune.Defines the common dialog box hook procedure that is overridden to add specific functionality to a common dialog box.

(Ereditato da CommonDialog)
InitializeLifetimeService()

Ottiene un oggetto servizio di durata per controllare i criteri di durata per questa istanza.Obtains a lifetime service object to control the lifetime policy for this instance.

(Ereditato da MarshalByRefObject)
MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Ereditato da Object)
MemberwiseClone(Boolean)

Crea una copia dei riferimenti dell'oggetto MarshalByRefObject corrente.Creates a shallow copy of the current MarshalByRefObject object.

(Ereditato da MarshalByRefObject)
OnHelpRequest(EventArgs)

Genera l'evento HelpRequest.Raises the HelpRequest event.

(Ereditato da CommonDialog)
OwnerWndProc(IntPtr, Int32, IntPtr, IntPtr)

Consente di definire la routine della finestra proprietaria di cui viene eseguito l'override per aggiungere funzionalità specifiche a una finestra di dialogo comune.Defines the owner window procedure that is overridden to add specific functionality to a common dialog box.

(Ereditato da CommonDialog)
Reset()

Reimposta tutte le opzioni sui valori predefiniti.Resets all options to their default values.

RunDialog(IntPtr)

Quando ne viene eseguito l'override in una classe derivata, specifica una finestra di dialogo comune.When overridden in a derived class, specifies a common dialog box.

(Ereditato da CommonDialog)
ShowDialog()

Consente di eseguire una finestra di dialogo comune con un proprietario predefinito.Runs a common dialog box with a default owner.

(Ereditato da CommonDialog)
ShowDialog(IWin32Window)

Consente di eseguire una finestra di dialogo comune con il proprietario specificato.Runs a common dialog box with the specified owner.

(Ereditato da CommonDialog)
ToString()

Restituisce un oggetto String che contiene il nome dell'eventuale oggetto Component.Returns a String containing the name of the Component, if any. Questo metodo non deve essere sottoposto a override.This method should not be overridden.

(Ereditato da Component)

Eventi

Disposed

Si verifica quando il componente viene eliminato da una chiamata al metodo Dispose().Occurs when the component is disposed by a call to the Dispose() method.

(Ereditato da Component)
HelpRequest

Viene generato quando l'utente sceglie il pulsante della Guida in una finestra di dialogo comune.Occurs when the user clicks the Help button on a common dialog box.

(Ereditato da CommonDialog)

Si applica a

Vedi anche