PrintDialog Klasse

Referenz

Definition

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

In einer Windows Forms-Anwendung können in diesem Dialogfeld ein Drucker und die zu druckenden Abschnitte des Dokuments ausgewählt werden.

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 sie das PrintDialog -Steuerelement verwenden, um die AllowSomePagesEigenschaften , ShowHelpund Document festzulegen. Fügen Sie zum Ausführen dieses Beispiels den folgenden Code in ein Formular ein, das ein PrintDialog Steuerelement mit dem Namen PrintDialog1 und eine Schaltfläche mit dem Namen Button1enthält. Dieses Beispiel erfordert, dass das Ereignis der Schaltfläche Click und das PrintPage Ereignis von docToPrint mit den in diesem Beispiel definierten Ereignisbehandlungsmethoden verbunden sind.

// 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 instance von PrintDialogerstellen, werden die Lese-/Schreibeigenschaften auf Anfangswerte festgelegt. Eine Liste dieser Werte finden Sie im PrintDialog Konstruktor. Verwenden Sie PrinterSettings die -Eigenschaft, um Druckereinstellungen abzurufen, die PrintDialogvom Benutzer mit 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, sehen Sie sich den Namespace anSystem.Printing.

Konstruktoren

PrintDialog()

Initialisiert eine neue Instanz der PrintDialog-Klasse.

Eigenschaften

AllowCurrentPage	Ruft einen Wert ab, der angibt, ob die Optionsschaltfläche Aktuelle Seite angezeigt wird, oder legt diesen fest.
AllowPrintToFile	Ruft einen Wert ab, der angibt, ob das Kontrollkästchen Ausgabe in Datei aktiviert ist, oder legt diesen fest.
AllowSelection	Ruft einen Wert ab, der angibt, ob die Optionsschaltfläche Auswahl aktiviert ist, oder legt diesen fest.
AllowSomePages	Ruft einen Wert ab, der angibt, ob die Optionsschaltfläche Seiten aktiviert ist, oder legt diesen fest.
CanRaiseEvents	Ruft einen Wert ab, der angibt, ob die Komponente ein Ereignis auslösen kann. (Geerbt von Component)
Container	Ruft die IContainer ab, die in der Component enthalten ist. (Geerbt von Component)
DesignMode	Ruft einen Wert ab, der angibt, ob sich Component gegenwärtig im Entwurfsmodus befindet. (Geerbt von Component)
Document	Ruft einen Wert ab, der das PrintDocument angibt, aus dem die PrinterSettings abgerufen werden, oder legt diesen fest.
Events	Ruft die Liste der Ereignishandler ab, die dieser Component angefügt sind. (Geerbt von Component)
PrinterSettings	Ruft die Druckereinstellungen ab, die im Dialogfeld geändert werden, oder legt diese fest.
PrintToFile	Ruft einen Wert ab, der angibt, ob das Kontrollkästchen Ausgabe in Datei ausgewählt ist, oder legt diesen fest.
ShowHelp	Ruft einen Wert ab, mit dem angegeben wird, ob die Schaltfläche Hilfe angezeigt wird, oder legt diesen fest.
ShowNetwork	Ruft einen Wert ab, der angibt, ob die Schaltfläche Netzwerk angezeigt wird, oder legt diesen fest.
Site	Ruft den ISite von Component ab oder legt ihn fest. (Geerbt von Component)
Tag	Ruft ein Objekt ab, das Daten bezüglich des Steuerelements enthält, oder legt dieses Objekt fest. (Geerbt von CommonDialog)
UseEXDialog	Ruft einen Wert ab, 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, oder legt den Wert fest.

Methoden

CreateObjRef(Type)	Erstellt ein Objekt mit allen relevanten Informationen, die zum Generieren eines Proxys für die Kommunikation mit einem Remoteobjekt erforderlich sind. (Geerbt von MarshalByRefObject)
Dispose()	Gibt alle vom Component verwendeten Ressourcen frei. (Geerbt von Component)
Dispose(Boolean)	Gibt die von Component verwendeten nicht verwalteten Ressourcen und optional die verwalteten Ressourcen frei. (Geerbt von Component)
Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetLifetimeService()	Veraltet. Ruft das aktuelle Lebensdauerdienstobjekt ab, das die Lebensdauerrichtlinien für diese Instanz steuert. (Geerbt von MarshalByRefObject)
GetService(Type)	Gibt ein Objekt zurück, das einen von der Component oder von deren Container bereitgestellten Dienst darstellt. (Geerbt von Component)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
HookProc(IntPtr, Int32, IntPtr, IntPtr)	Definiert die Hookprozedur für Standarddialogfelder, die überschrieben wird, um einem Standarddialogfeld spezifische Funktionen hinzuzufügen. (Geerbt von CommonDialog)
InitializeLifetimeService()	Veraltet. Ruft ein Lebensdauerdienstobjekt zur Steuerung der Lebensdauerrichtlinie für diese Instanz ab. (Geerbt von MarshalByRefObject)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
MemberwiseClone(Boolean)	Erstellt eine flache Kopie des aktuellen MarshalByRefObject-Objekts. (Geerbt von MarshalByRefObject)
OnHelpRequest(EventArgs)	Löst das HelpRequest-Ereignis aus. (Geerbt von CommonDialog)
OwnerWndProc(IntPtr, Int32, IntPtr, IntPtr)	Definiert die Prozedur des Besitzerfensters, die überschrieben wird, um einem Standarddialogfeld spezifische Funktionen hinzuzufügen. (Geerbt von CommonDialog)
Reset()	Setzt alle Optionen, den zuletzt ausgewählten Drucker und die Seiteneinstellungen auf die jeweiligen Standardwerte zurück.
RunDialog(IntPtr)	Wenn dies in einer abgeleiteten Klasse überschrieben wird, wird hierdurch ein Standarddialogfeld angegeben. (Geerbt von CommonDialog)
ShowDialog()	Führt ein Standarddialogfeld mit einem Standardbesitzer aus. (Geerbt von CommonDialog)
ShowDialog(IWin32Window)	Führt ein Standarddialogfeld mit dem angegebenen Besitzer aus. (Geerbt von CommonDialog)
ToString()	Gibt einen String zurück, der den Namen der Component enthält (sofern vorhanden). Diese Methode darf nicht überschrieben werden. (Geerbt von Component)

Ereignisse

Disposed	Tritt auf, wenn die Komponente von einem Aufruf der Dispose()-Methode verworfen wird. (Geerbt von Component)
HelpRequest	Tritt ein, wenn der Benutzer in einem Standarddialogfeld auf die Hilfeschaltfläche klickt. (Geerbt von CommonDialog)

Gilt für:

Teilen über