PrintDialog Classe

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Source:

PrintDialog.cs

Permet aux utilisateurs de sélectionner une imprimante et de choisir les sections du document à imprimer à partir d’une application Windows Forms.

public ref class PrintDialog sealed : System::Windows::Forms::CommonDialog

public sealed class PrintDialog : System.Windows.Forms.CommonDialog

type PrintDialog = class
    inherit CommonDialog

Public NotInheritable Class PrintDialog
Inherits CommonDialog

Héritage

Object

MarshalByRefObject

Component

CommonDialog

PrintDialog

Exemples

L’exemple de code suivant montre comment utiliser le PrintDialog contrôle pour définir les propriétés et Document les AllowSomePagesShowHelppropriétés. Pour exécuter cet exemple, collez le code suivant dans un formulaire qui contient un PrintDialog contrôle nommé PrintDialog1 et un bouton nommé Button1. Cet exemple nécessite que l’événement du Click bouton et l’événement PrintPage d’avoir docToPrint été connectés aux méthodes de gestion des événements définies dans cet exemple.

// Declare the PrintDocument object.
System::Drawing::Printing::PrintDocument^ docToPrint;

// This method will set properties on the PrintDialog object and
// then display the dialog.
void Button1_Click( System::Object^ /*sender*/, System::EventArgs^ /*e*/ )
{
   // Allow the user to choose the page range he or she would
   // like to print.
   PrintDialog1->AllowSomePages = true;
   
   // Show the help button.
   PrintDialog1->ShowHelp = true;
   
   // Set the Document property to the PrintDocument for 
   // which the PrintPage Event has been handled. To display the
   // dialog, either this property or the PrinterSettings property 
   // must be set 
   PrintDialog1->Document = docToPrint;
   if ( docToPrint == nullptr )
         System::Windows::Forms::MessageBox::Show(  "null" );

   ;
   ;
   if ( PrintDialog1 == nullptr )
         System::Windows::Forms::MessageBox::Show(  "pnull" );

   ;
   ;
   System::Windows::Forms::DialogResult result = PrintDialog1->ShowDialog();
   System::Windows::Forms::MessageBox::Show( result.ToString() );
   ;
   ;
   
   // If the result is OK then print the document.
   if ( result == ::DialogResult::OK )
   {
      docToPrint->Print();
   }

}

// The PrintDialog will print the document
// by handling the document's PrintPage event.
void document_PrintPage( Object^ /*sender*/, System::Drawing::Printing::PrintPageEventArgs^ e )
{
   // Insert code to render the page here.
   // This code will be called when the control is drawn.
   // The following code will render a simple
   // message on the printed document.
   String^ text = "In document_PrintPage method.";
   System::Drawing::Font^ printFont = gcnew System::Drawing::Font( "Arial",35,System::Drawing::FontStyle::Regular );
   
   // Draw the content.
   e->Graphics->DrawString( text, printFont, System::Drawing::Brushes::Black, 10, 10 );
}

// Declare the PrintDocument object.
private System.Drawing.Printing.PrintDocument docToPrint = 
    new System.Drawing.Printing.PrintDocument();

// This method will set properties on the PrintDialog object and
// then display the dialog.
private void Button1_Click(System.Object sender, 
    System.EventArgs e)
{

    // Allow the user to choose the page range he or she would
    // like to print.
    PrintDialog1.AllowSomePages = true;

    // Show the help button.
    PrintDialog1.ShowHelp = true;

    // Set the Document property to the PrintDocument for 
    // which the PrintPage Event has been handled. To display the
    // dialog, either this property or the PrinterSettings property 
    // must be set 
    PrintDialog1.Document = docToPrint;

    DialogResult result = PrintDialog1.ShowDialog();

    // If the result is OK then print the document.
    if (result==DialogResult.OK)
    {
        docToPrint.Print();
    }
}

// The PrintDialog will print the document
// by handling the document's PrintPage event.
private void document_PrintPage(object sender, 
    System.Drawing.Printing.PrintPageEventArgs e)
{

    // Insert code to render the page here.
    // This code will be called when the control is drawn.

    // The following code will render a simple
    // message on the printed document.
    string text = "In document_PrintPage method.";
    System.Drawing.Font printFont = new System.Drawing.Font
        ("Arial", 35, System.Drawing.FontStyle.Regular);

    // Draw the content.
    e.Graphics.DrawString(text, printFont, 
        System.Drawing.Brushes.Black, 10, 10);
}

' Declare the PrintDocument object.
Private WithEvents docToPrint As New Printing.PrintDocument

' This method will set properties on the PrintDialog object and
' then display the dialog.
Private Sub Button1_Click(ByVal sender As System.Object, _
    ByVal e As System.EventArgs) Handles Button1.Click

    ' Allow the user to choose the page range he or she would
    ' like to print.
    PrintDialog1.AllowSomePages = True

    ' Show the help button.
    PrintDialog1.ShowHelp = True

    ' Set the Document property to the PrintDocument for 
    ' which the PrintPage Event has been handled. To display the
    ' dialog, either this property or the PrinterSettings property 
    ' must be set 
    PrintDialog1.Document = docToPrint

    Dim result As DialogResult = PrintDialog1.ShowDialog()

    ' If the result is OK then print the document.
    If (result = DialogResult.OK) Then
        docToPrint.Print()
    End If

End Sub

' The PrintDialog will print the document
' by handling the document's PrintPage event.
Private Sub document_PrintPage(ByVal sender As Object, _
   ByVal e As System.Drawing.Printing.PrintPageEventArgs) _
       Handles docToPrint.PrintPage

    ' Insert code to render the page here.
    ' This code will be called when the control is drawn.

    ' The following code will render a simple
    ' message on the printed document.
    Dim text As String = "In document_PrintPage method."
    Dim printFont As New System.Drawing.Font _
        ("Arial", 35, System.Drawing.FontStyle.Regular)

    ' Draw the content.
    e.Graphics.DrawString(text, printFont, _
        System.Drawing.Brushes.Black, 10, 10)
End Sub

Remarques

Lorsque vous créez une instance de , les propriétés de PrintDialoglecture/écriture sont définies sur les valeurs initiales. Pour obtenir la liste de ces valeurs, consultez le PrintDialog constructeur. Pour obtenir les paramètres d’imprimante modifiés par l’utilisateur avec la PrintDialogpropriété , utilisez la PrinterSettings propriété.

Pour plus d’informations sur l’impression avec Windows Forms, consultez la vue d’ensemble de l’espace System.Drawing.Printing de noms. Si vous souhaitez imprimer à partir d’une application Windows Presentation Foundation, consultez l’espace System.Printing de noms.

Constructeurs

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

Propriétés

Nom	Description
AllowCurrentPage	Obtient ou définit une valeur indiquant si le bouton d’option Page active est affiché.
AllowPrintToFile	Obtient ou définit une valeur indiquant si la case à cocher Imprimer dans le fichier est activée.
AllowSelection	Obtient ou définit une valeur indiquant si le bouton d’option Sélection est activé.
AllowSomePages	Obtient ou définit une valeur indiquant si le bouton d’option Pages est activé.
Document	Obtient ou définit une valeur indiquant l’objet PrintDocument utilisé pour obtenir PrinterSettings.
PrinterSettings	Obtient ou définit les paramètres de l’imprimante que la boîte de dialogue modifie.
PrintToFile	Obtient ou définit une valeur indiquant si la case à cocher Imprimer dans le fichier est cochée.
ShowHelp	Obtient ou définit une valeur indiquant si le bouton Aide s’affiche.
ShowNetwork	Obtient ou définit une valeur indiquant si le bouton Réseau est affiché.
Tag	Obtient ou définit un objet qui contient des données sur le contrôle. (Hérité de CommonDialog)
UseEXDialog	Obtient ou définit une valeur indiquant si la boîte de dialogue doit être affichée dans le style Windows XP pour les systèmes exécutant Windows XP Home Edition, Windows XP Professionnel, Windows Server 2003 ou version ultérieure.

Méthodes

Nom	Description
HookProc(IntPtr, Int32, IntPtr, IntPtr)	Définit la procédure courante de raccordement de boîte de dialogue qui est substituée pour ajouter des fonctionnalités spécifiques à une boîte de dialogue commune. (Hérité de CommonDialog)
OnHelpRequest(EventArgs)	Déclenche l’événement HelpRequest. (Hérité de CommonDialog)
OwnerWndProc(IntPtr, Int32, IntPtr, IntPtr)	Définit la procédure de fenêtre propriétaire substituée pour ajouter des fonctionnalités spécifiques à une boîte de dialogue commune. (Hérité de CommonDialog)
Reset()	Réinitialise toutes les options, la dernière imprimante sélectionnée et les paramètres de page à leurs valeurs par défaut.
RunDialog(IntPtr)	En cas de substitution dans une classe dérivée, spécifie une boîte de dialogue commune. (Hérité de CommonDialog)
ShowDialog()	Exécute une boîte de dialogue commune avec un propriétaire par défaut. (Hérité de CommonDialog)
ShowDialog(IWin32Window)	Exécute une boîte de dialogue commune avec le propriétaire spécifié. (Hérité de CommonDialog)

Événements

Nom	Description
HelpRequest	Se produit lorsque l’utilisateur clique sur le bouton Aide dans une boîte de dialogue commune. (Hérité de CommonDialog)

Voir aussi

• PageSetupDialog
• PrintPreviewDialog
• Composant PrintDialog (Windows Forms)