Información general sobre el control PrintPreviewDialog (Windows Forms)PrintPreviewDialog control overview (Windows Forms)

El control de PrintPreviewDialog de Windows Forms es un cuadro de diálogo preconfigurado que se usa para mostrar cómo aparecerá PrintDocument cuando se imprima.The Windows Forms PrintPreviewDialog control is a pre-configured dialog box used to display how a PrintDocument will appear when printed. Úselo en su aplicación basada en Windows como una solución sencilla en lugar de configurar su propio cuadro de diálogo.Use it within your Windows-based application as a simple solution instead of configuring your own dialog box. El control contiene botones para imprimir, acercar, mostrar una o varias páginas y cerrar el cuadro de diálogo.The control contains buttons for printing, zooming in, displaying one or multiple pages, and closing the dialog box.

Propiedades y métodos claveKey properties and methods

La propiedad de clave del control es Document, que establece el documento cuya vista previa se va a obtener.The control's key property is Document, which sets the document to be previewed. El documento debe ser un objeto de PrintDocument.The document must be a PrintDocument object. Para mostrar el cuadro de diálogo, debe llamar a su método ShowDialog.In order to display the dialog box, you must call its ShowDialog method. El suavizado de contorno puede hacer que el texto parezca más suave, pero también puede hacer que la pantalla sea más lenta. para usarlo, establezca la propiedad UseAntiAlias en true.Anti-aliasing can make the text appear smoother, but it can also make the display slower; to use it, set the UseAntiAlias property to true.

Algunas propiedades están disponibles a través del PrintPreviewControl que contiene el PrintPreviewDialog.Certain properties are available through the PrintPreviewControl that the PrintPreviewDialog contains. (No tiene que agregar este PrintPreviewControl al formulario; se incluye automáticamente en el PrintPreviewDialog al agregar el cuadro de diálogo al formulario). Algunos ejemplos de propiedades disponibles a través de la PrintPreviewControl son las propiedades Columns y Rows, que determinan el número de páginas que se muestran horizontal y verticalmente en el control.(You do not have to add this PrintPreviewControl to the form; it is automatically contained within the PrintPreviewDialog when you add the dialog to your form.) Examples of properties available through the PrintPreviewControl are the Columns and Rows properties, which determine the number of pages displayed horizontally and vertically on the control. Puede tener acceso a la propiedad Columns como PrintPreviewDialog1.PrintPreviewControl.Columns en Visual Basic, printPreviewDialog1.PrintPreviewControl.Columns en C#visual o printPreviewDialog1->PrintPreviewControl->Columns en Visual C++.You can access the Columns property as PrintPreviewDialog1.PrintPreviewControl.Columns in Visual Basic, printPreviewDialog1.PrintPreviewControl.Columns in Visual C#, or printPreviewDialog1->PrintPreviewControl->Columns in Visual C++.

Rendimiento de PrintPreviewDialogPrintPreviewDialog performance

En las siguientes condiciones, el control de PrintPreviewDialog se inicializa muy lentamente:Under the following conditions, the PrintPreviewDialog control initializes very slowly:

  • Se utiliza una impresora de red.A network printer is used.
  • Se modifican las preferencias de usuario para esta impresora, como la configuración dúplex.User preferences for this printer, such as duplex settings, are modified.

En el caso de las aplicaciones que se ejecutan en el .NET Framework 4.5.2, puede Agregar la siguiente clave a la sección <appSettings > del archivo de configuración para mejorar el rendimiento de la inicialización del control de PrintPreviewDialog:For apps running on the .NET Framework 4.5.2, you can add the following key to the <appSettings> section of your configuration file to improve the performance of PrintPreviewDialog control initialization:

<appSettings>
   <add key="EnablePrintPreviewOptimization" value="true" />
</appSettings>

Si la clave de EnablePrintPreviewOptimization se establece en cualquier otro valor, o si la clave no está presente, no se aplica la optimización.If the EnablePrintPreviewOptimization key is set to any other value, or if the key is not present, the optimization is not applied.

En el caso de las aplicaciones que se ejecutan en el .NET Framework 4,6 o versiones posteriores, puede Agregar el siguiente modificador al elemento <AppContextSwitchOverrides > en la sección > en tiempo de ejecución de< del archivo de configuración de la aplicación:For apps running on the .NET Framework 4.6 or later versions, you can add the following switch to the <AppContextSwitchOverrides> element in the <runtime> section of your app config file:

<runtime >
   <!-- AppContextSwitchOverrides values are in the form of 'key1=true|false;key2=true|false -->
   <AppContextSwitchOverrides value = "Switch.System.Drawing.Printing.OptimizePrintPreview=true" />
</runtime >

Si el modificador no está presente o se establece en cualquier otro valor, no se aplica la optimización.If the switch is not present or if it is set to any other value, the optimization is not applied.

Si usa el evento QueryPageSettings para modificar la configuración de la impresora, el rendimiento del control PrintPreviewDialog no mejorará incluso si se ha establecido un modificador de configuración de optimización.If you use the QueryPageSettings event to modify printer settings, the performance of the PrintPreviewDialog control will not improve even if an optimization configuration switch is set.

Vea tambiénSee also