PageSetupDialog Clase

Referencia

Definición

Espacio de nombres:: System.Windows.Forms

Ensamblado:: System.Windows.Forms.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

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 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 PageSetupDialog uso de 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 de papel, tamaño y fuente; y para mostrar los botones de ayuda y red. La MinMargins propiedad define los márgenes mínimos que un usuario puede seleccionar.

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 una configuración de página para mostrar, debe establecer la Documentpropiedad , PrinterSettingso PageSettings antes de llamar a ShowDialog; de lo contrario, se producirá una excepción.

Constructores

PageSetupDialog()

Inicializa una nueva instancia de la clase PageSetupDialog.

Propiedades

AllowMargins	Obtiene o establece un valor que indica si está habilitada la sección de márgenes del cuadro de diálogo.
AllowOrientation	Obtiene o establece un valor que indica si está habilitada la sección de orientación (horizontal o vertical) del cuadro de diálogo.
AllowPaper	Obtiene o establece un valor que indica si se habilita la sección de papel (tamaño y origen de papel) del cuadro de diálogo.
AllowPrinter	Obtiene o establece un valor que indica si el botón Impresora está habilitado.
CanRaiseEvents	Obtiene un valor que indica si el componente puede generar un evento. (Heredado de Component)
Container	Obtiene la interfaz IContainer que contiene la clase Component. (Heredado de Component)
DesignMode	Obtiene un valor que indica si Component está actualmente en modo de diseño. (Heredado de Component)
Document	Obtiene o establece un valor que indica el PrintDocument del que se obtendrá la configuración de 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 para utilizar centésimas de pulgada.
Events	Obtiene la lista de controladores de eventos asociados a Component. (Heredado de Component)
MinMargins	Obtiene o establece un valor que indica los márgenes mínimos en centésimas de pulgada que se permite seleccionar al usuario.
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 está visible el botón Ayuda.
ShowNetwork	Obtiene o establece un valor que indica si está visible el botón Red.
Site	Obtiene o establece ISite de Component. (Heredado de Component)
Tag	Obtiene o establece un objeto que contiene datos sobre el control. (Heredado de CommonDialog)

Métodos

CreateObjRef(Type)	Crea un objeto que contiene toda la información relevante necesaria para generar un proxy utilizado para comunicarse con un objeto remoto. (Heredado de MarshalByRefObject)
Dispose()	Libera todos los recursos que usa Component. (Heredado de Component)
Dispose(Boolean)	Libera los recursos no administrados que usa Component y, de forma opcional, libera los recursos administrados. (Heredado de Component)
Equals(Object)	Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object)
GetHashCode()	Sirve como la función hash predeterminada. (Heredado de Object)
GetLifetimeService()	Obsoletos. Recupera el objeto de servicio de duración actual que controla la directiva de duración de esta instancia. (Heredado de MarshalByRefObject)
GetService(Type)	Devuelve un objeto que representa el servicio suministrado por Component o por Container. (Heredado de Component)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
HookProc(IntPtr, Int32, IntPtr, IntPtr)	Define el procedimiento de enlace para cuadros de diálogo comunes que se reemplaza para agregar una funcionalidad específica a un cuadro de diálogo común. (Heredado de CommonDialog)
InitializeLifetimeService()	Obsoletos. Obtiene un objeto de servicio de duración para controlar la directiva de duración de esta instancia. (Heredado de MarshalByRefObject)
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
MemberwiseClone(Boolean)	Crea una copia superficial del objeto MarshalByRefObject actual. (Heredado de MarshalByRefObject)
OnHelpRequest(EventArgs)	Genera el evento HelpRequest. (Heredado de CommonDialog)
OwnerWndProc(IntPtr, Int32, IntPtr, IntPtr)	Define el procedimiento de ventana propietaria que se reemplaza para agregar una funcionalidad específica a un cuadro de diálogo común. (Heredado de CommonDialog)
Reset()	Restablece todas las opciones en los valores predeterminados.
RunDialog(IntPtr)	Cuando se reemplaza 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)
ToString()	Devuelve una String que contiene el nombre del Component, si existe. Este método no se debe invalidar. (Heredado de Component)

Eventos

Disposed	Tiene lugar cuando una llamada elimina el componente mediante una llamada al método Dispose(). (Heredado de Component)
HelpRequest	Se produce cuando el usuario hace clic en el botón Ayuda de un cuadro de diálogo común. (Heredado de CommonDialog)

Se aplica a

Compartir vía