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)
Visual Basic (Declaración)
Public NotInheritable Class PageSetupDialog
Inherits CommonDialog
Dim instance As PageSetupDialog
public sealed class PageSetupDialog : CommonDialog
public ref class PageSetupDialog sealed : public CommonDialog
public final class PageSetupDialog extends CommonDialog
public final class PageSetupDialog extends CommonDialog
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 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
//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.
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.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
Seguridad para subprocesos
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