PrintDialog Classe

Définition

public ref class PrintDialog

public class PrintDialog

type PrintDialog = class

Public Class PrintDialog

Héritage

Object

PrintDialog

Exemples

L’exemple suivant montre comment créer une instance et afficher une instance simple PrintDialog à l’aide du balisage et du code XAML (Extensible Application Markup Language).

<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

Remarques

Un utilisateur peut utiliser la boîte de dialogue Imprimer pour sélectionner une imprimante, la configurer et effectuer un travail d’impression.

Strictement parlant, vous pouvez utiliser la PrintDocument méthode sans jamais ouvrir le dialogue. Dans ce sens, le contrôle peut être utilisé comme composant d’impression invisible. Mais pour des raisons de performances, il serait préférable d’utiliser la AddJob méthode ou l’une des nombreuses Write et WriteAsync méthodes du XpsDocumentWriter. Pour plus d’informations, consultez Guide pratique pour imprimer des fichiers XPS par programmation.

Ne confondez pas cette classe, System.Windows.Controls.PrintDialogavec System.Windows.Forms.PrintDialog. Ce dernier est utilisé avec Windows Forms applications. System.Windows.Controls.PrintDialogest utilisé avec les applications Windows Presentation Foundation.

Constructeurs

Propriétés

Méthodes

S’applique à