PrintPreviewControl クラス

印刷プレビューの生のプレビュー部分を表します。ダイアログ ボックスやボタンは表示されません。ほとんどの PrintPreviewControl オブジェクトは PrintPreviewDialog オブジェクト上で見つかりますが、それ以外の場合もあります。

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)

構文

'宣言
<ComVisibleAttribute(True)> _
<ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch)> _
Public Class PrintPreviewControl
    Inherits Control
'使用
Dim instance As PrintPreviewControl

[ComVisibleAttribute(true)] 
[ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch)] 
public class PrintPreviewControl : Control

[ComVisibleAttribute(true)] 
[ClassInterfaceAttribute(ClassInterfaceType::AutoDispatch)] 
public ref class PrintPreviewControl : public Control

/** @attribute ComVisibleAttribute(true) */ 
/** @attribute ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch) */ 
public class PrintPreviewControl extends Control

ComVisibleAttribute(true) 
ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch) 
public class PrintPreviewControl extends Control

解説

PrintPreviewControl クラスのインスタンスを作成すると、一部の読み書き可能プロパティが初期値に設定されます。これらの初期値の一覧については、PrintPreviewControl コンストラクタのトピックを参照してください。

使用例

PrintPreviewControl の Document、UseAntiAlias、Zoom の各プロパティを使ったコード例を次に示します。この例を実行するには、次のコードをフォームに配置し、フォームのコンストラクタまたは Load イベント処理メソッドで InitializePrintPreviewControl メソッドを呼び出します。

'Declare the PrintPreviewControl object and the PrintDocument object.
Friend WithEvents PrintPreviewControl1 As PrintPreviewControl
Private WithEvents docToPrint As New Printing.PrintDocument

Private Sub InitializePrintPreviewControl()

    ' Construct the PrintPreviewControl.
    Me.PrintPreviewControl1 = New PrintPreviewControl

    ' Set location, name, and dock style for PrintPreviewControl1.
    Me.PrintPreviewControl1.Location = New Point(88, 80)
    Me.PrintPreviewControl1.Name = "PrintPreviewControl1"
    Me.PrintPreviewControl1.Dock = DockStyle.Fill

    ' Set the Document property to the PrintDocument 
    ' for which the PrintPage event has been handled.
    Me.PrintPreviewControl1.Document = docToPrint

    ' Set the zoom to 25 percent.
    Me.PrintPreviewControl1.Zoom = 0.25

    ' Set the document name. This will show be displayed when 
    ' the document is loading into the control.
    Me.PrintPreviewControl1.Document.DocumentName = "c:\someFile"

    ' Set the UseAntiAlias property to true so fonts are smoothed
    ' by the operating system.
    Me.PrintPreviewControl1.UseAntiAlias = True

    ' Add the control to the form.
    Me.Controls.Add(Me.PrintPreviewControl1)
End Sub

' The PrintPreviewControl will display the document
' by handling the documents PrintPage event
Private Sub docToPrint_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 document in the control.
    Dim text As String = "In docToPrint_PrintPage method."
    Dim printFont As New Font _
        ("Arial", 35, System.Drawing.FontStyle.Regular)

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

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

private void InitializePrintPreviewControl()
{

    // Construct the PrintPreviewControl.
    this.PrintPreviewControl1 = new PrintPreviewControl();

    // Set location, name, and dock style for PrintPreviewControl1.
    this.PrintPreviewControl1.Location = new Point(88, 80);
    this.PrintPreviewControl1.Name = "PrintPreviewControl1";
    this.PrintPreviewControl1.Dock = DockStyle.Fill;

    // Set the Document property to the PrintDocument 
    // for which the PrintPage event has been handled.
    this.PrintPreviewControl1.Document = docToPrint;

    // Set the zoom to 25 percent.
    this.PrintPreviewControl1.Zoom = 0.25;

    // Set the document name. This will show be displayed when 
    // the document is loading into the control.
    this.PrintPreviewControl1.Document.DocumentName = "c:\\someFile";

    // Set the UseAntiAlias property to true so fonts are smoothed
    // by the operating system.
    this.PrintPreviewControl1.UseAntiAlias = true;

    // Add the control to the form.
    this.Controls.Add(this.PrintPreviewControl1);
    
    // Associate the event-handling method with the
    // document's PrintPage event.
    this.docToPrint.PrintPage += 
        new System.Drawing.Printing.PrintPageEventHandler(
        docToPrint_PrintPage);
}

// The PrintPreviewControl will display the document
// by handling the documents PrintPage event
private void docToPrint_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 document in the control.
    string text = "In docToPrint_PrintPage method.";
    System.Drawing.Font printFont = 
        new Font("Arial", 35, FontStyle.Regular);

    e.Graphics.DrawString(text, printFont,
        Brushes.Black, 10, 10);
}

internal:
   // Declare the PrintPreviewControl object and the 
   // PrintDocument object.
   PrintPreviewControl^ PrintPreviewControl1;

private:
   System::Drawing::Printing::PrintDocument^ docToPrint;
   void InitializePrintPreviewControl()
   {
      // Construct the PrintPreviewControl.
      this->PrintPreviewControl1 = gcnew PrintPreviewControl;
      
      // Set location, name, and dock style for PrintPreviewControl1.
      this->PrintPreviewControl1->Location = Point(88,80);
      this->PrintPreviewControl1->Name = "PrintPreviewControl1";
      this->PrintPreviewControl1->Dock = DockStyle::Fill;
      
      // Set the Document property to the PrintDocument 
      // for which the PrintPage event has been handled.
      this->PrintPreviewControl1->Document = docToPrint;
      
      // Set the zoom to 25 percent.
      this->PrintPreviewControl1->Zoom = 0.25;
      
      // Set the document name. This will show be displayed when 
      // the document is loading into the control.
      this->PrintPreviewControl1->Document->DocumentName = "c:\\someFile";
      
      // Set the UseAntiAlias property to true so fonts are smoothed
      // by the operating system.
      this->PrintPreviewControl1->UseAntiAlias = true;
      
      // Add the control to the form.
      this->Controls->Add( this->PrintPreviewControl1 );
      
      // Associate the event-handling method with the
      // document's PrintPage event.
      this->docToPrint->PrintPage += gcnew System::Drawing::Printing::PrintPageEventHandler( this, &Form1::docToPrint_PrintPage );
   }

   // The PrintPreviewControl will display the document
   // by handling the documents PrintPage event
   void docToPrint_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 document in the control.
      String^ text = "In docToPrint_PrintPage method.";
      System::Drawing::Font^ printFont = gcnew System::Drawing::Font( "Arial",35,FontStyle::Regular );
      e->Graphics->DrawString( text, printFont, Brushes::Black, 10, 10 );
   }

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

private void InitializePrintPreviewControl()
{
    // Construct the PrintPreviewControl.
    this.printPreviewControl1 = new PrintPreviewControl();
    // Set location, name, and dock style for PrintPreviewControl1.
    this.printPreviewControl1.set_Location(new Point(88, 80));
    this.printPreviewControl1.set_Name("PrintPreviewControl1");
    this.printPreviewControl1.set_Dock(DockStyle.Fill);
    // Set the Document property to the PrintDocument 
    // for which the PrintPage event has been handled.
    this.printPreviewControl1.set_Document(docToPrint);
    // Set the zoom to 25 percent.
    this.printPreviewControl1.set_Zoom(0.25);
    // Set the document name. This will show be displayed when 
    // the document is loading into the control.
    this.printPreviewControl1.get_Document().set_DocumentName("c:\\someFile");
    // Set the UseAntiAlias property to true so fonts are smoothed
    // by the operating system.
    this.printPreviewControl1.set_UseAntiAlias(true);
    // Add the control to the form.
    this.get_Controls().Add(this.printPreviewControl1);
    // Associate the event-handling method with the
    // document's PrintPage event.
    this.docToPrint.add_PrintPage(
        new System.Drawing.Printing.PrintPageEventHandler(
        docToPrint_PrintPage));
} //InitializePrintPreviewControl

// The PrintPreviewControl will display the document
// by handling the documents PrintPage event
private void docToPrint_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 document in the control.
    String text = "In docToPrint_PrintPage method.";
    System.Drawing.Font printFont = new Font("Arial", 35, FontStyle.Regular);

    e.get_Graphics().DrawString(text, printFont, Brushes.get_Black(), 10, 10);
} //docToPrint_PrintPage

継承階層

System.Object
   System.MarshalByRefObject
     System.ComponentModel.Component
       System.Windows.Forms.Control
        System.Windows.Forms.PrintPreviewControl

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

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

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework

サポート対象 : 2.0、1.1、1.0

参照

関連項目

PrintPreviewControl メンバ
System.Windows.Forms 名前空間
PrintPreviewDialog