PageSetupDialog (Clase)
Actualización: noviembre 2007
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.
Ensamblado: System.Windows.Forms (en System.Windows.Forms.dll)
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.MarshalByRefObject
System.ComponentModel.Component
System.Windows.Forms.CommonDialog
System.Windows.Forms.PageSetupDialog
Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98
.NET Framework y .NET Compact Framework no admiten todas las versiones de cada plataforma. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.
