PrintDialog Clase

Definición

Espacio de nombres:

System.Windows.Controls

Ensamblado:

PresentationFramework.dll

Invoca un cuadro de diálogo de impresión estándar de Microsoft Windows que configura PrintTicket y PrintQueue según los datos proporcionados por el usuario e imprime luego un documento.

public ref class PrintDialog

public class PrintDialog

type PrintDialog = class

Public Class PrintDialog

Herencia

Object

PrintDialog

Ejemplos

En el ejemplo siguiente se muestra cómo crear una instancia de y mostrar una sencilla PrintDialog mediante el marcado y el código del Lenguaje de marcado de aplicaciones extensibles (XAML).

<Button Width="200" Click="InvokePrint">Invoke PrintDialog</Button>

...

private void InvokePrint(object sender, RoutedEventArgs e)
    {
        // Create the print dialog object and set options
        PrintDialog pDialog = new PrintDialog();
        pDialog.PageRangeSelection = PageRangeSelection.AllPages;
        pDialog.UserPageRangeEnabled = true;

        // Display the dialog. This returns true if the user presses the Print button.
        Nullable<Boolean> print = pDialog.ShowDialog();
        if (print == true)
        {
            XpsDocument xpsDocument = new XpsDocument("C:\\FixedDocumentSequence.xps", FileAccess.ReadWrite);
            FixedDocumentSequence fixedDocSeq = xpsDocument.GetFixedDocumentSequence();
            pDialog.PrintDocument(fixedDocSeq.DocumentPaginator, "Test print job");
        }
    }

Private Sub InvokePrint(ByVal sender As Object, ByVal e As RoutedEventArgs)
        ' Create the print dialog object and set options
        Dim pDialog As New PrintDialog()
        pDialog.PageRangeSelection = PageRangeSelection.AllPages
        pDialog.UserPageRangeEnabled = True

        ' Display the dialog. This returns true if the user presses the Print button.
        Dim print? As Boolean = pDialog.ShowDialog()
        If print = True Then
            Dim xpsDocument As New XpsDocument("C:\FixedDocumentSequence.xps", FileAccess.ReadWrite)
            Dim fixedDocSeq As FixedDocumentSequence = xpsDocument.GetFixedDocumentSequence()
            pDialog.PrintDocument(fixedDocSeq.DocumentPaginator, "Test print job")
        End If
End Sub

Comentarios

Un usuario puede usar el cuadro de diálogo Imprimir para seleccionar una impresora, configurarla y realizar un trabajo de impresión.

En sentido estricto, puede usar el PrintDocument método sin abrir nunca el cuadro de diálogo. En ese sentido, el control se puede usar como componente de impresión no visto. Pero por motivos de rendimiento, sería mejor usar el AddJob método o uno de los muchos Write métodos y WriteAsync de XpsDocumentWriter. Para obtener más información sobre esto, vea How to: Programmatically Print XPS Files.

No confunda esta clase, System.Windows.Controls.PrintDialog, con System.Windows.Forms.PrintDialog. Este último se usa con aplicaciones Windows Forms. System.Windows.Controls.PrintDialogse usa con aplicaciones Windows Presentation Foundation.

Constructores

PrintDialog()

Inicializa una nueva instancia de la clase PrintDialog.

Propiedades

CurrentPageEnabled	Obtiene o establece un valor que indica si se habilita la opción de imprimir la página actual.
MaxPage	Obtiene o establece el número de página más alto permitido en los intervalos de páginas.
MinPage	Obtiene o establece el número de página más bajo permitido en los intervalos de páginas.
PageRange	Obtiene o establece el intervalo de páginas para imprimir cuando PageRangeSelection está establecido en UserPages.
PageRangeSelection	Obtiene o establece PageRangeSelection para esta instancia de PrintDialog.
PrintableAreaHeight	Obtiene el alto del área imprimible de la página.
PrintableAreaWidth	Obtiene el ancho del área imprimible de la página.
PrintQueue	Obtiene o establece PrintQueue que representa la impresora que está seleccionada.
PrintTicket	Obtiene o establece el PrintTicket que PrintDialog usa cuando el usuario hace clic en Imprimir para el trabajo de impresión actual.
SelectedPagesEnabled	Obtiene o establece un valor que indica si se habilita la opción de imprimir páginas seleccionadas.
UserPageRangeEnabled	Obtiene o establece un valor que indica si los usuarios del cuadro de diálogo Imprimir tienen la opción de especificar los intervalos de páginas para imprimir.

Métodos

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)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
PrintDocument(DocumentPaginator, String)	Imprime un objeto DocumentPaginator en la PrintQueue que está seleccionada actualmente.
PrintVisual(Visual, String)	Imprime un objeto visual (no texto), que se deriva de la clase Visual, en la PrintQueue que está seleccionada actualmente.
ShowDialog()	Invoca PrintDialog como un cuadro de diálogo modal.
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)