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 un PrintTicket et une PrintQueue selon les entrées d’utilisateur puis imprime 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 == 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

PrintDialog()

Initialise une nouvelle instance de la classe PrintDialog.

Propriétés

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é qui est 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 lorsque PageRangeSelection a la valeur UserPages.
PageRangeSelection	Obtient ou définit la PageRangeSelection pour 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 une PrintQueue qui représente l'imprimante sélectionnée.
PrintTicket	Obtient ou définit le PrintTicket utilisé par la PrintDialog quand l’utilisateur clique sur Imprimer pour le travail d’impression actuel.
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 l’option de spécifier des plages de pages à imprimer.

Méthodes

Equals(Object)	Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object)
GetHashCode()	Fait office de fonction de hachage par défaut. (Hérité de Object)
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
PrintDocument(DocumentPaginator, String)	Imprime un objet DocumentPaginator dans la PrintQueue actuellement sélectionnée.
PrintVisual(Visual, String)	Imprime un objet visuel (non-texte) dérivé de la classe Visual dans la PrintQueue qui est sélectionnée actuellement.
ShowDialog()	Appelle PrintDialog en tant que boîte de dialogue modale.
ToString()	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object)