PageSetupDialog Classe

Definizione

Spazio dei nomi:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Origine:: PageSetupDialog.cs

Origine:: PageSetupDialog.cs

Origine:: PageSetupDialog.cs

Origine:: PageSetupDialog.cs

Origine:: PageSetupDialog.cs

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 carta. Questa 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 formato contenente un Button denominato , un ListBoxListBox1denominato Button1e 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 sezioni della finestra di dialogo per modificare la stampa e i margini; orientamento della carta, dimensioni e fonte; e per visualizzare i pulsanti guida e di 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 della pagina, è necessario impostare la Documentproprietà , PrinterSettingso PageSettings prima di chiamare ShowDialog. In caso contrario, si verificherà un'eccezione.

Costruttori

Nome	Descrizione
PageSetupDialog()	Inizializza una nuova istanza della classe PageSetupDialog.

Proprietà

Nome	Descrizione
AllowMargins	Ottiene o imposta un valore che indica se la sezione margini della finestra di dialogo è abilitata.
AllowOrientation	Ottiene o imposta un valore che indica se la sezione di orientamento della finestra di dialogo (orizzontale o verticale) è abilitata.
AllowPaper	Ottiene o imposta un valore che indica se la sezione carta della finestra di dialogo (formato carta e origine carta) è 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 contenente l'oggetto Component. (Ereditato da Component)
DesignMode	Ottiene un valore che indica se è Component attualmente in modalità progettazione. (Ereditato da Component)
Document	Ottiene o imposta un valore che indica l'oggetto PrintDocument da cui ottenere le impostazioni della pagina.
EnableMetric	Ottiene o imposta un valore che indica se le impostazioni del margine, se visualizzate in millimetri, devono essere convertite automaticamente in e da centesimi di pollice.
Events	Ottiene l'elenco dei gestori eventi associati a questo Componentoggetto . (Ereditato da Component)
MinMargins	Ottiene o imposta un valore che indica i margini minimi, in centesimi di pollice, che l'utente può selezionare.
PageSettings	Ottiene o imposta un valore che indica le impostazioni della pagina da modificare.
PrinterSettings	Ottiene o imposta le impostazioni della stampante modificate quando l'utente fa clic sul 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 dell'oggetto Component. (Ereditato da Component)
Tag	Ottiene o imposta un oggetto che contiene dati sul controllo. (Ereditato da CommonDialog)

Metodi

Nome	Descrizione
CreateObjRef(Type)	Crea un oggetto che contiene tutte le informazioni pertinenti necessarie per generare un proxy utilizzato per comunicare 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, rilascia 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. Recupera l'oggetto servizio di durata corrente che controlla i criteri di durata per questa istanza. (Ereditato da MarshalByRefObject)
GetService(Type)	Restituisce un oggetto che rappresenta un servizio fornito da Component o da Container. (Ereditato da Component)
GetType()	Ottiene il Type dell'istanza corrente. (Ereditato da Object)
HookProc(IntPtr, Int32, IntPtr, IntPtr)	Definisce la routine hook della finestra di dialogo comune sottoposta a 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 del Objectcorrente. (Ereditato da Object)
MemberwiseClone(Boolean)	Crea una copia superficiale dell'oggetto corrente MarshalByRefObject . (Ereditato da MarshalByRefObject)
OnHelpRequest(EventArgs)	Genera l'evento HelpRequest. (Ereditato da CommonDialog)
OwnerWndProc(IntPtr, Int32, IntPtr, IntPtr)	Definisce la routine della finestra di proprietario sottoposta a override per aggiungere funzionalità specifiche a una finestra di dialogo comune. (Ereditato da CommonDialog)
Reset()	Reimposta tutti i valori predefiniti di tutte le opzioni.
RunDialog(IntPtr)	In caso di 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 contenente il nome dell'oggetto Component, se presente. Questo metodo non deve essere sottoposto a override. (Ereditato da Component)

Eventi

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

Si applica a

Vedi anche

Commenti e suggerimenti

Questa pagina è stata utile?