PrintDialog Clase

Definición

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 extensible de aplicaciones (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.Value)
    {
        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.

Estrictamente hablando, 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 y WriteAsync métodos de XpsDocumentWriter. Para obtener más información sobre esto, vea Cómo: Imprimir archivos XPS mediante programación.

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