Esta documentación está archivada y no tiene mantenimiento.

PageSetupDialog (Clase)

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

Espacio de nombres: System.Windows.Forms
Ensamblado: System.Windows.Forms (en system.windows.forms.dll)

public sealed class PageSetupDialog : CommonDialog
public final class PageSetupDialog extends CommonDialog
public final class PageSetupDialog extends CommonDialog
No aplicable.

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

Cuando se crea una instancia de la clase PageSetupDialog, se establecen las propiedades de lectura y escritura en sus valores iniciales. Para obtener una lista de esos valores, vea el constructor PageSetupDialog.

Dado que el control PageSetupDialog necesita la configuración de la página que se va a mostrar, hay que establecer la propiedad Document, PrinterSettingso PageSettings antes de llamar ShowDialog; en caso contrario, ocurre una excepción.

En el siguiente ejemplo de código se muestra PageSetupDialog mediante las propiedades PageSettings, PrinterSettings y ShowNetwork. Para ejecutar este ejemplo, péguelo en un formulario que contenga un control Button denominado Button1, un control ListBox denominado ListBox1y un control PageSetupDialog denominado PageSetupDialog1. Asegúrese de que el evento Click del botón está conectado al método de control de eventos definido 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.
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 void button1_Click(System.Object sender, System.EventArgs e)
{
    // Initialize the dialog's PrinterSettings property to hold user
    // defined printer settings.
    pageSetupDialog1.set_PageSettings(
        new System.Drawing.Printing.PageSettings());
    // Initialize dialog's PrinterSettings property to hold user
    // set printer settings.
    pageSetupDialog1.set_PrinterSettings(
        new System.Drawing.Printing.PrinterSettings());
    //Do not show the network in the printer dialog.
    pageSetupDialog1.set_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.Equals(get_DialogResult().OK)) {
        Object results[] = new Object[] {
            pageSetupDialog1.get_PageSettings().get_Margins(),
            pageSetupDialog1.get_PageSettings().get_PaperSize(),
            ((System.Boolean)pageSetupDialog1.get_PageSettings().
            get_Landscape()),
            pageSetupDialog1.get_PrinterSettings().get_PrinterName(),
            pageSetupDialog1.get_PrinterSettings().get_PrintRange()};
        listBox1.get_Items().AddRange(results);
    }

} //button1_Click

System.Object
   System.MarshalByRefObject
     System.ComponentModel.Component
       System.Windows.Forms.CommonDialog
        System.Windows.Forms.PageSetupDialog

Los miembros estáticos públicos (Shared en Visual Basic) de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.

Windows 98, Windows 2000 Service Pack 4, Windows CE, Windows Millennium, Windows Mobile para Pocket PC, Windows Mobile para Smartphone, Windows Server 2003, Windows XP Media Center, Windows XP Professional x64, Windows XP SP2, Windows XP Starter

Microsoft .NET Framework 3.0 es compatible con Windows Vista, Microsoft Windows XP SP2 y Windows Server 2003 SP1.

.NET Framework

Compatible con: 3.0, 2.0, 1.1, 1.0
Mostrar: