PrintDialog Klasse

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Quelle:

PrintDialog.cs

Ermöglicht Es Benutzern, einen Drucker auszuwählen und auszuwählen, welche Abschnitte des Dokuments aus einer Windows Forms-Anwendung gedruckt werden sollen.

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

Vererbung

Object

MarshalByRefObject

Component

CommonDialog

PrintDialog

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie das Steuerelement zum Festlegen der PrintDialogAllowSomePagesEigenschaften ShowHelpund Document Eigenschaften verwendet wird. Zum Ausführen dieses Beispiels fügen Sie den folgenden Code in ein Formular ein, das ein PrintDialog Steuerelement mit dem Namen und eine Schaltfläche mit dem Namen PrintDialog1Button1enthält. In diesem Beispiel muss das Ereignis der Schaltfläche Click und das PrintPage Ereignis docToPrint mit den in diesem Beispiel definierten Ereignisbehandlungsmethoden verbunden sein.

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

Hinweise

Wenn Sie eine Instanz von PrintDialogerstellen, werden die Lese-/Schreibeigenschaften auf anfangswerte festgelegt. Eine Liste dieser Werte finden Sie im PrintDialog Konstruktor. Verwenden Sie die PrinterSettings Eigenschaft, um Druckereinstellungen abzurufen, die vom Benutzer mit der PrintDialogEigenschaft geändert werden.

Weitere Informationen zum Drucken mit Windows Forms finden Sie in der System.Drawing.Printing Namespaceübersicht. Wenn Sie aus einer Windows Presentation Foundation-Anwendung drucken möchten, lesen Sie den System.Printing Namespace.

Konstruktoren

Name	Beschreibung
PrintDialog()	Initialisiert eine neue Instanz der PrintDialog-Klasse.

Eigenschaften

Name	Beschreibung
AllowCurrentPage	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob die Optionsschaltfläche " Aktuelle Seite " angezeigt wird.
AllowPrintToFile	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das Kontrollkästchen " In Datei drucken " aktiviert ist.
AllowSelection	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob die Optionsschaltfläche "Auswahl " aktiviert ist.
AllowSomePages	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob die Optionsschaltfläche "Seiten " aktiviert ist.
Document	Dient zum Abrufen oder Festlegen eines Werts, der den PrintDocument zum Abrufen PrinterSettingsverwendeten Wert angibt.
PrinterSettings	Dient zum Abrufen oder Festlegen der Druckereinstellungen, die das Dialogfeld ändert.
PrintToFile	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das Kontrollkästchen "In Datei drucken " aktiviert ist.
ShowHelp	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob die Schaltfläche "Hilfe " angezeigt wird.
ShowNetwork	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob die Netzwerkschaltfläche angezeigt wird.
Tag	Dient zum Abrufen oder Festlegen eines Objekts, das Daten zum Steuerelement enthält. (Geerbt von CommonDialog)
UseEXDialog	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das Dialogfeld im Windows XP-Stil für Systeme mit Windows XP Home Edition, Windows XP Professional, Windows Server 2003 oder höher angezeigt werden soll.

Methoden

Name	Beschreibung
HookProc(IntPtr, Int32, IntPtr, IntPtr)	Definiert die allgemeine Dialogfeld-Hook-Prozedur, die überschrieben wird, um einem allgemeinen Dialogfeld bestimmte Funktionen hinzuzufügen. (Geerbt von CommonDialog)
OnHelpRequest(EventArgs)	Löst das HelpRequest-Ereignis aus. (Geerbt von CommonDialog)
OwnerWndProc(IntPtr, Int32, IntPtr, IntPtr)	Definiert die Besitzerfensterprozedur, die überschrieben wird, um einem allgemeinen Dialogfeld bestimmte Funktionen hinzuzufügen. (Geerbt von CommonDialog)
Reset()	Setzt alle Optionen, den letzten ausgewählten Drucker und die Seiteneinstellungen auf ihre Standardwerte zurück.
RunDialog(IntPtr)	Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird ein allgemeines Dialogfeld angegeben. (Geerbt von CommonDialog)
ShowDialog()	Führt ein allgemeines Dialogfeld mit einem Standardbesitzer aus. (Geerbt von CommonDialog)
ShowDialog(IWin32Window)	Führt ein allgemeines Dialogfeld mit dem angegebenen Besitzer aus. (Geerbt von CommonDialog)

Ereignisse

Name	Beschreibung
HelpRequest	Tritt auf, wenn der Benutzer auf die Schaltfläche "Hilfe" in einem allgemeinen Dialogfeld klickt. (Geerbt von CommonDialog)

Weitere Informationen

• PageSetupDialog
• PrintPreviewDialog
• PrintDialog-Komponente (Windows Forms)