PrintDocument.PrintController プロパティ

.NET Framework クラス ライブラリ リファレンス

PrintDocument.PrintController プロパティ

印刷プロセスを制御するプリント コントローラを取得または設定します。

名前空間: System.Drawing.Printing
アセンブリ: System.Drawing (system.drawing.dll 内)
構文

Visual Basic (宣言)

Public Property PrintController As
 PrintController

Visual Basic (使用法)

Dim instance As PrintDocument
Dim value As PrintController

value = instance.PrintController

instance.PrintController = value

C#

public PrintController PrintController { get;
 set; }

C++

public:
property PrintController^ PrintController {
    PrintController^ get ();
    void set (PrintController^ value);
}

J#

/** @property */
public PrintController get_PrintController ()

/** @property */
public void set_PrintController (PrintController
 value)

JScript

public function get PrintController
 () : PrintController

public function set PrintController
 (value : PrintController)

プロパティ値
印刷プロセスを制御する PrintController。既定値は、PrintControllerWithStatusDialog クラスの新しいインスタンスです。

解説

プリント コントローラは、いくつかの方法で印刷プロセスを制御します。たとえば、ドキュメントを印刷するために、ドキュメントをGraphics オブジェクトに変換する必要があります。PrintController は、印刷プレビューのイメージや、実際にドキュメントを出力するプリンタ上でのグラフィックの描画位置を指定します。また、プリント コントローラは、ドキュメントをすぐに印刷するか、指定の時間だけ待機するかを指定することもできます。

使用例

次のコード例では、PrintDocument クラスの myPrintDocument というインスタンスが既に作成されている必要があります。この例では、PrintController クラスの新しいインスタンスを作成し、そのインスタンスを myPrintDocument の PrintController プロパティに割り当ててから、ドキュメントを印刷します。

この例では、System.Drawing.Printing 名前空間と System.Windows.Forms 名前空間を使用します。

Visual Basic

Public Sub myPrint()
    If useMyPrintController = True Then
        myPrintDocument.PrintController = New myControllerImplementation()
        If wantsStatusDialog = True Then
            myPrintDocument.PrintController = _
               New PrintControllerWithStatusDialog( _
               myPrintDocument.PrintController)
        End If
    End If
    myPrintDocument.Print()
End Sub

C#

public void myPrint()
{
   if (useMyPrintController == true)
   {
      myPrintDocument.PrintController = 
         new myControllerImplementation();     
      if (wantsStatusDialog == true)
      {
         myPrintDocument.PrintController = 
            new PrintControllerWithStatusDialog
            (myPrintDocument.PrintController);
      }
   }
   myPrintDocument.Print();
}

C++

public:
   void myPrint()
   {
      if ( useMyPrintController == true )
      {
         myPrintDocument->PrintController =
            gcnew myControllerImplementation;
         if ( wantsStatusDialog == true )
         {
            myPrintDocument->PrintController =
               gcnew PrintControllerWithStatusDialog(
                  myPrintDocument->PrintController );
         }
      }
      myPrintDocument->Print();
   }

J#

public void MyPrint()
{
    if (useMyPrintController == true) {
        myPrintDocument.set_PrintController
            (new MyControllerImplementation());
        if (wantsStatusDialog == true) {
            myPrintDocument.set_PrintController
                (new PrintControllerWithStatusDialog
                (myPrintDocument.get_PrintController()));
        }
    }
    myPrintDocument.Print();
} //MyPrint

.NET Framework のセキュリティ

• PrintingPermission  (制限されたダイアログ ボックスから安全に印刷するために必要なアクセス許可)。PrintingPermissionLevel.SafePrinting (関連する列挙体)

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, 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

参照

関連項目
PrintDocument クラス
PrintDocument メンバ
System.Drawing.Printing 名前空間
PrintDocument.DefaultPageSettings プロパティ
PrintDocument.DocumentName プロパティ
PreviewPrintController クラス
PrintController クラス
PrintControllerWithStatusDialog
PrinterSettings
StandardPrintController