PageSetupDialog Clase

Definición

Espacio de nombres:

System.Windows.Forms

Ensamblado:

System.Windows.Forms.dll

Source:

PageSetupDialog.cs

Permite a los usuarios cambiar la configuración de impresión relacionada con la página, incluidos los márgenes y la orientación del papel. Esta clase no puede heredarse.

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

Herencia

Object

MarshalByRefObject

Component

CommonDialog

PageSetupDialog

Ejemplos

En el ejemplo de código siguiente se muestra el uso de PageSetupDialog las PageSettingspropiedades , PrinterSettingsy ShowNetwork . Para ejecutar este ejemplo, colóquelo en un formulario que contenga un Button denominado Button1, un ListBox denominado ListBox1y un PageSetupDialog denominado PageSetupDialog1. Asegúrese de que el evento click del botón está conectado al método de control de eventos en este ejemplo.

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

Comentarios

El PageSetupDialog cuadro de diálogo modifica la PageSettings información y PrinterSettings de un determinado Document. El usuario puede habilitar secciones del cuadro de diálogo para manipular la impresión y los márgenes; orientación, tamaño y origen del papel; y para mostrar los botones de ayuda y red. La MinMargins propiedad define los márgenes mínimos que puede seleccionar un usuario.

Al crear una instancia de la PageSetupDialog clase , las propiedades de lectura y escritura se establecen en valores iniciales. Para obtener una lista de estos valores, consulte el PageSetupDialog constructor .

Dado que necesita PageSetupDialog que se muestre la configuración de la página, debe establecer la Documentpropiedad , PrinterSettingso PageSettings antes de llamar a ShowDialog; de lo contrario, se producirá una excepción.

Constructores

Nombre	Description
PageSetupDialog()	Inicializa una nueva instancia de la clase PageSetupDialog.

Propiedades

Nombre	Description
AllowMargins	Obtiene o establece un valor que indica si la sección de márgenes del cuadro de diálogo está habilitada.
AllowOrientation	Obtiene o establece un valor que indica si la sección de orientación del cuadro de diálogo (horizontal frente a vertical) está habilitada.
AllowPaper	Obtiene o establece un valor que indica si la sección de papel del cuadro de diálogo (tamaño de papel y origen de papel) está habilitada.
AllowPrinter	Obtiene o establece un valor que indica si el botón Impresora está habilitado.
Document	Obtiene o establece un valor que indica la configuración de la página desde la PrintDocument que se va a obtener la configuración de la página.
EnableMetric	Obtiene o establece un valor que indica si la configuración del margen, cuando se muestra en milímetros, se debe convertir automáticamente a y desde centésimas de pulgada.
MinMargins	Obtiene o establece un valor que indica los márgenes mínimos, en centésimas de pulgada, que el usuario puede seleccionar.
PageSettings	Obtiene o establece un valor que indica la configuración de página que se va a modificar.
PrinterSettings	Obtiene o establece la configuración de impresora que se modifica cuando el usuario hace clic en el botón Impresora del cuadro de diálogo.
ShowHelp	Obtiene o establece un valor que indica si el botón Ayuda está visible.
ShowNetwork	Obtiene o establece un valor que indica si el botón Red está visible.
Tag	Obtiene o establece un objeto que contiene datos sobre el control. (Heredado de CommonDialog)

Métodos

Nombre	Description
HookProc(IntPtr, Int32, IntPtr, IntPtr)	Define el procedimiento de enlace de cuadro de diálogo común que se invalida para agregar funcionalidad específica a un cuadro de diálogo común. (Heredado de CommonDialog)
OnHelpRequest(EventArgs)	Genera el evento HelpRequest. (Heredado de CommonDialog)
OwnerWndProc(IntPtr, Int32, IntPtr, IntPtr)	Define el procedimiento de ventana de propietario que se invalida para agregar funcionalidad específica a un cuadro de diálogo común. (Heredado de CommonDialog)
Reset()	Restablece todas las opciones a sus valores predeterminados.
RunDialog(IntPtr)	Cuando se invalida en una clase derivada, especifica un cuadro de diálogo común. (Heredado de CommonDialog)
ShowDialog()	Ejecuta un cuadro de diálogo común con un propietario predeterminado. (Heredado de CommonDialog)
ShowDialog(IWin32Window)	Ejecuta un cuadro de diálogo común con el propietario especificado. (Heredado de CommonDialog)

Eventos

Nombre	Description
HelpRequest	Se produce cuando el usuario hace clic en el botón Ayuda en un cuadro de diálogo común. (Heredado de CommonDialog)

Consulte también

• CommonDialog
• Margins
• PageSettings
• PrintDocument
• PrinterSettings