PrintDialog Classe

Définition

Espace de noms:

System.Windows.Controls

Assembly:

PresentationFramework.dll

Appelle une boîte de dialogue d’impression Microsoft Windows standard qui configure une PrintTicket entrée utilisateur et PrintQueue qui imprime ensuite un document.

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.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

Remarques

Un utilisateur peut utiliser la boîte de dialogue Imprimer pour sélectionner une imprimante, la configurer et effectuer une tâche 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 les applications Windows Forms. System.Windows.Controls.PrintDialog est utilisé avec les applications Windows Presentation Foundation.

Constructeurs

Nom	Description
PrintDialog()	Initialise une nouvelle instance de la classe PrintDialog.

Propriétés

Nom	Description
CurrentPageEnabled	Obtient ou définit une valeur qui indique si l’option d’impression de la page active est activée.
MaxPage	Obtient ou définit le numéro de page le plus élevé autorisé dans les plages de pages.
MinPage	Obtient ou définit le numéro de page le plus bas autorisé dans les plages de pages.
PageRange	Obtient ou définit la plage de pages à imprimer quand PageRangeSelection elle est définie sur UserPages.
PageRangeSelection	Obtient ou définit la PageRangeSelection valeur de cette instance de PrintDialog.
PrintableAreaHeight	Obtient la hauteur de la zone imprimable de la page.
PrintableAreaWidth	Obtient la largeur de la zone imprimable de la page.
PrintQueue	Obtient ou définit un PrintQueue qui représente l’imprimante sélectionnée.
PrintTicket	Obtient ou définit celui PrintTicket utilisé par l’utilisateur PrintDialog lorsque l’utilisateur clique sur Imprimer pour la tâche d’impression actuelle.
SelectedPagesEnabled	Obtient ou définit une valeur qui indique si l’option d’impression des pages sélectionnées est activée.
UserPageRangeEnabled	Obtient ou définit une valeur qui indique si les utilisateurs de la boîte de dialogue Imprimer ont la possibilité de spécifier des plages de pages à imprimer.

Méthodes

Nom	Description
PrintDocument(DocumentPaginator, String)	Imprime un DocumentPaginator objet dans l’objet PrintQueue actuellement sélectionné.
PrintVisual(Visual, String)	Imprime un objet visuel (non texte), dérivé de la classe, à l’objet VisualPrintQueue actuellement sélectionné.
ShowDialog()	Appelle la PrintDialog boîte de dialogue modale.