PrintPreviewDialog-Klasse

Stellt ein Dialogfeld dar, das ein PrintPreviewControl enthält.

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in system.windows.forms.dll)

Syntax

'Declaration
<ComVisibleAttribute(True)> _
<ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch)> _
Public Class PrintPreviewDialog
    Inherits Form
'Usage
Dim instance As PrintPreviewDialog

[ComVisibleAttribute(true)] 
[ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch)] 
public class PrintPreviewDialog : Form

[ComVisibleAttribute(true)] 
[ClassInterfaceAttribute(ClassInterfaceType::AutoDispatch)] 
public ref class PrintPreviewDialog : public Form

/** @attribute ComVisibleAttribute(true) */ 
/** @attribute ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch) */ 
public class PrintPreviewDialog extends Form

ComVisibleAttribute(true) 
ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch) 
public class PrintPreviewDialog extends Form

Hinweise

Wenn Sie eine Instanz der PrintPreviewDialog-Klasse erstellen, werden einige Lese-/Schreibeigenschaften auf die Anfangswerte festgelegt. Eine Liste dieser Werte finden Sie unter PrintPreviewDialog-Konstruktor.

Beispiel

Im folgenden Codebeispiel wird das Festlegen der Document-Eigenschaft und der UseAntiAlias-Eigenschaft durch den PrintPreviewDialog veranschaulicht. Dabei wird davon ausgegangen, dass das Formular eine TreeView mit dem Namen TreeView1 mit TreeNode-Objekten enthält. Die Tag-Eigenschaft der einzelnen TreeNode-Objekte muss auf einen voll qualifizierten Dokumentnamen festgelegt sein, auf den der Computer zugreifen kann, auf dem das Beispiel ausgeführt wird. Legen Sie jede TreeNode.Text-Eigenschaft auf eine Zeichenfolge fest, die die durch die TreeNode.Tag-Eigenschaft angegebene Datei kennzeichnet. Sie können TreeNode1.Tag z. B. auf "C:\Eigene Dateien\Rezept.doc" und TreeNode1.Text auf "Rezept.doc" festlegen. Im vorliegenden Beispiel wird außerdem davon ausgegangen, dass das Formular einen PrintPreviewDialog mit dem Namen PrintPreviewDialog1 und eine Schaltfläche mit dem Namen Button1 enthält. Rufen Sie zum Ausführen dieses Beispiels die InitializePrintPreviewDialog-Methode im Konstruktor oder im Load-Ereignishandler des Formulars auf.

' Declare the dialog.
Friend WithEvents PrintPreviewDialog1 As PrintPreviewDialog

' Declare a PrintDocument object named document.
Private WithEvents document As New System.Drawing.Printing.PrintDocument

' Initalize the dialog.
Private Sub InitializePrintPreviewDialog()

    ' Create a new PrintPreviewDialog using constructor.
    Me.PrintPreviewDialog1 = New PrintPreviewDialog

    'Set the size, location, and name.
    Me.PrintPreviewDialog1.ClientSize = New System.Drawing.Size(400, 300)
    Me.PrintPreviewDialog1.Location = New System.Drawing.Point(29, 29)
    Me.PrintPreviewDialog1.Name = "PrintPreviewDialog1"

    ' Set the minimum size the dialog can be resized to.
    Me.PrintPreviewDialog1.MinimumSize = New System.Drawing.Size(375, 250)

    ' Set the UseAntiAlias property to true, which will allow the 
    ' operating system to smooth fonts.
    Me.PrintPreviewDialog1.UseAntiAlias = True
End Sub

Private Sub Button1_Click(ByVal sender As Object, _
    ByVal e As System.EventArgs) Handles Button1.Click

    If Not (TreeView1.SelectedNode Is Nothing) Then

        ' Set the PrintDocument object's name to the selectedNode
        ' object's  tag, which in this case contains the 
        ' fully-qualified name of the document. This value will 
        ' show when the dialog reports progress.
        document.DocumentName = TreeView1.SelectedNode.Tag
    End If

    ' Set the PrintPreviewDialog.Document property to
    ' the PrintDocument object selected by the user.
    PrintPreviewDialog1.Document = document

    ' Call the ShowDialog method. This will trigger the document's
    '  PrintPage event.
    PrintPreviewDialog1.ShowDialog()
End Sub

Private Sub document_PrintPage(ByVal sender As Object, _
    ByVal e As System.Drawing.Printing.PrintPageEventArgs) _
        Handles document.PrintPage

    ' Insert code to render the page here.
    ' This code will be called when the PrintPreviewDialog.Show 
    ' method is called.

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

    e.Graphics.DrawString(text, printFont, _
        System.Drawing.Brushes.Black, 0, 0)

End Sub

// Declare the dialog.
internal PrintPreviewDialog PrintPreviewDialog1;

// Declare a PrintDocument object named document.
private System.Drawing.Printing.PrintDocument document =
    new System.Drawing.Printing.PrintDocument();

// Initalize the dialog.
private void InitializePrintPreviewDialog()
{

    // Create a new PrintPreviewDialog using constructor.
    this.PrintPreviewDialog1 = new PrintPreviewDialog();

    //Set the size, location, and name.
    this.PrintPreviewDialog1.ClientSize = 
        new System.Drawing.Size(400, 300);
    this.PrintPreviewDialog1.Location = 
        new System.Drawing.Point(29, 29);
    this.PrintPreviewDialog1.Name = "PrintPreviewDialog1";
    
    // Associate the event-handling method with the 
    // document's PrintPage event.
    this.document.PrintPage += 
        new System.Drawing.Printing.PrintPageEventHandler
        (document_PrintPage);

    // Set the minimum size the dialog can be resized to.
    this.PrintPreviewDialog1.MinimumSize = 
        new System.Drawing.Size(375, 250);

    // Set the UseAntiAlias property to true, which will allow the 
    // operating system to smooth fonts.
    this.PrintPreviewDialog1.UseAntiAlias = true;
}

private void Button1_Click(object sender, System.EventArgs e)
{

    if (TreeView1.SelectedNode != null)

        // Set the PrintDocument object's name to the selectedNode
        // object's  tag, which in this case contains the 
        // fully-qualified name of the document. This value will 
        // show when the dialog reports progress.
    {
        document.DocumentName = TreeView1.SelectedNode.Tag.ToString();
    }

    // Set the PrintPreviewDialog.Document property to
    // the PrintDocument object selected by the user.
    PrintPreviewDialog1.Document = document;

    // Call the ShowDialog method. This will trigger the document's
    //  PrintPage event.
    PrintPreviewDialog1.ShowDialog();
}

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 PrintPreviewDialog.Show 
    // method is called.

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

    e.Graphics.DrawString(text, printFont, 
        System.Drawing.Brushes.Black, 0, 0);

}

   // Declare the dialog.
internal:
   PrintPreviewDialog^ PrintPreviewDialog1;

private:

   // Declare a PrintDocument object named document.
   System::Drawing::Printing::PrintDocument^ document;

   // Initalize the dialog.
   void InitializePrintPreviewDialog()
   {
      
      // Create a new PrintPreviewDialog using constructor.
      this->PrintPreviewDialog1 = gcnew PrintPreviewDialog;
      
      //Set the size, location, and name.
      this->PrintPreviewDialog1->ClientSize = System::Drawing::Size( 400, 300 );
      this->PrintPreviewDialog1->Location = System::Drawing::Point( 29, 29 );
      this->PrintPreviewDialog1->Name = "PrintPreviewDialog1";
      
      // Associate the event-handling method with the 
      // document's PrintPage event.
      this->document->PrintPage += gcnew System::Drawing::Printing::PrintPageEventHandler( this, &Form1::document_PrintPage );
      
      // Set the minimum size the dialog can be resized to.
      this->PrintPreviewDialog1->MinimumSize = System::Drawing::Size( 375, 250 );
      
      // Set the UseAntiAlias property to true, which will allow the 
      // operating system to smooth fonts.
      this->PrintPreviewDialog1->UseAntiAlias = true;
   }

   void Button1_Click( Object^ /*sender*/, System::EventArgs^ /*e*/ )
   {
      if ( TreeView1->SelectedNode != nullptr )
      {
         document->DocumentName = TreeView1->SelectedNode->Tag->ToString();
      }

      // Set the PrintPreviewDialog.Document property to
      // the PrintDocument object selected by the user.
      PrintPreviewDialog1->Document = document;
      
      // Call the ShowDialog method. This will trigger the document's
      //  PrintPage event.
      PrintPreviewDialog1->ShowDialog();
   }

   void document_PrintPage( Object^ /*sender*/, System::Drawing::Printing::PrintPageEventArgs^ e )
   {
      
      // Insert code to render the page here.
      // This code will be called when the PrintPreviewDialog.Show 
      // method is called.
      // The following code will render a simple
      // message on the document in the dialog.
      String^ text = "In document_PrintPage method.";
      System::Drawing::Font^ printFont = gcnew System::Drawing::Font( "Arial",35,System::Drawing::FontStyle::Regular );
      e->Graphics->DrawString( text, printFont, System::Drawing::Brushes::Black, 0, 0 );
   }

// Declare the dialog.
PrintPreviewDialog printPreviewDialog1;

// Declare a PrintDocument object named document.
private System.Drawing.Printing.PrintDocument document =
    new System.Drawing.Printing.PrintDocument();

// Initalize the dialog.
private void InitializePrintPreviewDialog()
{
    // Create a new PrintPreviewDialog using constructor.
    this.printPreviewDialog1 = new PrintPreviewDialog();
    //Set the size, location, and name.
    this.printPreviewDialog1.set_ClientSize(
        new System.Drawing.Size(400, 300));
    this.printPreviewDialog1.set_Location(new System.Drawing.Point(29, 29));
    this.printPreviewDialog1.set_Name("PrintPreviewDialog1");
    // Associate the event-handling method with the 
    // document's PrintPage event.
    this.document.add_PrintPage(
        new System.Drawing.Printing.PrintPageEventHandler(
        document_PrintPage));
    // Set the minimum size the dialog can be resized to.
    this.printPreviewDialog1.set_MinimumSize(
        new System.Drawing.Size(375, 250));
    // Set the UseAntiAlias property to true, which will allow the 
    // operating system to smooth fonts.
    this.printPreviewDialog1.set_UseAntiAlias(true);
} //InitializePrintPreviewDialog

private void button1_Click(Object sender, System.EventArgs e)
{
    if (treeView1.get_SelectedNode() != null) {
        // Set the PrintDocument object's name to the selectedNode
        // object's  tag, which in this case contains the 
        // fully-qualified name of the document. This value will 
        // show when the dialog reports progress.
        document.set_DocumentName(
            treeView1.get_SelectedNode().get_Tag().ToString());
    }
    // Set the PrintPreviewDialog.Document property to
    // the PrintDocument object selected by the user.
    printPreviewDialog1.set_Document(document);
    // Call the ShowDialog method. This will trigger the document's
    //  PrintPage event.
    printPreviewDialog1.ShowDialog();
} //button1_Click

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 PrintPreviewDialog.Show 
    // method is called.
    // The following code will render a simple
    // message on the document in the dialog.
    String text = "In document_PrintPage method.";
    System.Drawing.Font printFont =
        new System.Drawing.Font("Arial", 35,
        System.Drawing.FontStyle.Regular);

    e.get_Graphics().DrawString(text, printFont,
        System.Drawing.Brushes.get_Black(), 0, 0);
} //document_PrintPage

Vererbungshierarchie

System.Object
   System.MarshalByRefObject
     System.ComponentModel.Component
       System.Windows.Forms.Control
         System.Windows.Forms.ScrollableControl
           System.Windows.Forms.ContainerControl
             System.Windows.Forms.Form
              System.Windows.Forms.PrintPreviewDialog

Threadsicherheit

Alle öffentlichen statischen (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

PrintPreviewDialog-Member
System.Windows.Forms-Namespace
PageSetupDialog-Klasse
PrintDialog-Klasse
PrintPreviewControl-Klasse