PageSetupDialog Classe

Riferimento

Definizione

Spazio dei nomi:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Consente agli utenti di modificare le impostazioni di stampa relative alla pagina, inclusi i margini e l'orientamento della pagina. La classe non può essere ereditata.

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à: Object

MarshalByRefObject

Component

CommonDialog
PageSetupDialog

Esempio

Nell'esempio di codice seguente viene illustrato l'utilizzo PageSetupDialog delle PageSettingsproprietà , PrinterSettingse ShowNetwork . Per eseguire questo esempio, inserirlo in un modulo contenente un Button denominato , un ListBox oggetto denominato Button1ListBox1e un PageSetupDialog denominato PageSetupDialog1. Verificare che l'evento Click del pulsante sia connesso al metodo di gestione degli eventi in questo esempio.

//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 le PageSettings informazioni e PrinterSettings per un determinato Documentoggetto . 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. La MinMargins proprietà definisce i margini minimi che un utente può selezionare.

Quando si crea un'istanza della PageSetupDialog classe , le proprietà di lettura/scrittura vengono impostate sui valori iniziali. Per un elenco di questi valori, vedere il PageSetupDialog costruttore.

Poiché è PageSetupDialog necessario visualizzare le impostazioni di pagina, è necessario impostare la Documentproprietà , PrinterSettingso PageSettings prima di chiamare ShowDialog. In caso contrario, si verificherà un'eccezione.

Costruttori

PageSetupDialog()

Inizializza una nuova istanza della classe PageSetupDialog.

Proprietà

AllowMargins	Ottiene o imposta un valore che indica se è abilitata la sezione dei margini della finestra di dialogo.
AllowOrientation	Ottiene o imposta un valore che indica se è abilitata la sezione della finestra di dialogo relativa all'orientamento (orizzontale o verticale).
AllowPaper	Ottiene o imposta un valore che indica se la sezione relativa al foglio della finestra di dialogo (dimensione foglio e alimentazione) è abilitata.
AllowPrinter	Ottiene o imposta un valore che indica se il pulsante Stampante è abilitato.
CanRaiseEvents	Ottiene un valore che indica se il componente può generare un evento. (Ereditato da Component)
Container	Ottiene l'oggetto IContainer che contiene Component. (Ereditato da Component)
DesignMode	Ottiene un valore che indica se il Component si trova in modalità progettazione. (Ereditato da Component)
Document	Ottiene o imposta un valore che indica l'oggetto PrintDocument da cui ottenere le impostazioni di pagina.
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.
Events	Ottiene l'elenco dei gestori eventi allegati a questo Component. (Ereditato da Component)
MinMargins	Ottiene o imposta un valore che indica i margini minimi, in centesimi di pollice, selezionabili dall'utente.
PageSettings	Ottiene o imposta un valore che indica le impostazioni di pagina da modificare.
PrinterSettings	Ottiene o imposta le impostazioni della stampante che verranno modificate quando l'utente sceglie il pulsante Stampante nella finestra di dialogo.
ShowHelp	Ottiene o imposta un valore che indica se il pulsante ? è visibile.
ShowNetwork	Ottiene o imposta un valore che indica se il pulsante Rete è visibile.
Site	Ottiene o imposta l'oggetto ISite di Component. (Ereditato da Component)
Tag	Ottiene o imposta un oggetto che contiene i dati relativi al controllo. (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. (Ereditato da MarshalByRefObject)
Dispose()	Rilascia tutte le risorse usate da Component. (Ereditato da Component)
Dispose(Boolean)	Rilascia le risorse non gestite usate da Component e, facoltativamente, le risorse gestite. (Ereditato da Component)
Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetLifetimeService()	Obsoleti. Consente di recuperare l'oggetto servizio di durata corrente per controllare i criteri di durata per l'istanza. (Ereditato da MarshalByRefObject)
GetService(Type)	Consente di restituire un oggetto che rappresenta un servizio fornito da Component o dal relativo Container. (Ereditato da Component)
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
HookProc(IntPtr, Int32, IntPtr, IntPtr)	Definisce 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. (Ereditato da CommonDialog)
InitializeLifetimeService()	Obsoleti. Ottiene un oggetto servizio di durata per controllare i criteri di durata per questa istanza. (Ereditato da MarshalByRefObject)
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
MemberwiseClone(Boolean)	Crea una copia dei riferimenti dell'oggetto MarshalByRefObject corrente. (Ereditato da MarshalByRefObject)
OnHelpRequest(EventArgs)	Genera l'evento HelpRequest. (Ereditato da CommonDialog)
OwnerWndProc(IntPtr, Int32, IntPtr, IntPtr)	Definisce la routine della finestra proprietaria di cui viene eseguito l'override per aggiungere funzionalità specifiche a una finestra di dialogo comune. (Ereditato da CommonDialog)
Reset()	Reimposta tutte le opzioni sui valori predefiniti.
RunDialog(IntPtr)	Quando ne viene eseguito l'override in una classe derivata, specifica una finestra di dialogo comune. (Ereditato da CommonDialog)
ShowDialog()	Esegue una finestra di dialogo comune con un proprietario predefinito. (Ereditato da CommonDialog)
ShowDialog(IWin32Window)	Esegue una finestra di dialogo comune con il proprietario specificato. (Ereditato da CommonDialog)
ToString()	Restituisce un oggetto String che contiene il nome dell'eventuale oggetto Component. Questo metodo non deve essere sottoposto a override. (Ereditato da Component)

Eventi

Disposed	Si verifica quando il componente viene eliminato da una chiamata al metodo Dispose(). (Ereditato da Component)
HelpRequest	Si verifica quando l'utente fa clic sul pulsante della Guida in una finestra di dialogo comune. (Ereditato da CommonDialog)

Si applica a