PrintDialog

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

PrintDialog イベント

パブリック イベント

	名前	説明
	Disposed	コンポーネントの Disposed イベントを待機するイベント ハンドラを追加します。 ( Component から継承されます。)
	HelpRequest	ユーザーがコモン ダイアログ ボックスの [?] ボタンをクリックすると発生します。 ( CommonDialog から継承されます。)

参照

関連項目

PrintDialog クラス
System.Windows.Forms 名前空間
PageSetupDialog クラス
PrintPreviewDialog

PrintDialog クラス

ユーザーがプリンタを選択し、印刷するドキュメント部分を選択できるようにします。

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

Visual Basic (宣言)

Public NotInheritable Class
 PrintDialog
    Inherits CommonDialog

Visual Basic (使用法)

Dim instance As PrintDialog

C#

public sealed class PrintDialog : CommonDialog

C++

public ref class PrintDialog sealed : public
 CommonDialog

J#

public final class PrintDialog extends CommonDialog

JScript

public final class PrintDialog extends
 CommonDialog

解説

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

メモ
AMD64 プロセッサの場合、このクラスは、UseEXDialog プロパティを true に設定しないと動作しない可能性があります。

使用例

PrintDialog コントロールを使用して、AllowSomePages、ShowHelp、および Document の各プロパティを設定するコード例を次に示します。この例を実行するには、PrintDialog1 という名前の PrintDialog コントロールと Button1 という名前のボタンが配置されているフォームに次のコードを貼り付けます。この例は、ボタンの Click イベントおよび docToPrint の PrintPage イベントが、この例で定義されているイベント処理メソッドに関連付けられていることを前提にしています。

Visual Basic

' 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

C#

// 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);
}

C++

// 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 );
}

J#

// 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(Object sender, System.EventArgs
 e)
{
    // Allow the user to choose the page range he or she would
    // like to print.
    printDialog1.set_AllowSomePages(true);
    // Show the help button.
    printDialog1.set_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.set_Document(docToPrint);

    DialogResult result = printDialog1.ShowDialog();
    // If the result is OK then print the document.
    if (result.Equals(DialogResult.OK)) {
        docToPrint.Print();
    }
} //button1_Click

// 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.get_Graphics().DrawString(text, printFont,
        System.Drawing.Brushes.get_Black(), 10, 10);
} //Document_PrintPage

継承階層

System.Object
   System.MarshalByRefObject
     System.ComponentModel.Component
       System.Windows.Forms.CommonDialog
        System.Windows.Forms.PrintDialog

スレッド セーフ

この型の 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

参照

関連項目
PrintDialog メンバ
System.Windows.Forms 名前空間
PageSetupDialog クラス
PrintPreviewDialog

PrintDialog コンストラクタ

PrintDialog クラスの新しいインスタンスを初期化します。

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

Visual Basic (宣言)

Public Sub New

Visual Basic (使用法)

Dim instance As New PrintDialog

C#

public PrintDialog ()

C++

public:
PrintDialog ()

J#

public PrintDialog ()

JScript

public function PrintDialog ()

解説

PrintDialog のインスタンスを作成すると、次の読み書き可能プロパティが初期値に設定されます。

プロパティ	初期値
AllowSomePages	false
AllowPrintToFile	true
AllowSelection	false
Document	null 参照 (Visual Basic では Nothing)
PrinterSettings	null 参照 (Visual Basic では Nothing)
PrintToFile	false
ShowHelp	false
ShowNetwork	true

これらのプロパティの値は、各プロパティを個別に呼び出して変更できます。

プラットフォーム

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

参照

関連項目
PrintDialog クラス
PrintDialog メンバ
System.Windows.Forms 名前空間
PrintDocument
PrinterSettings
CommonDialog クラス

PrintDialog プロパティ

パブリック プロパティ

( プロテクト プロパティ も参照)

	名前	説明
	AllowCurrentPage	[現在のページ] オプション ボタンが表示されているかどうかを示す値を取得または設定します。
	AllowPrintToFile	[ファイルへ出力] チェック ボックスがオンかオフかを示す値を取得または設定します。
	AllowSelection	[選択した部分] オプション ボタンが有効かどうかを示す値を取得または設定します。
	AllowSomePages	[ページ指定] オプション ボタンが有効かどうかを示す値を取得または設定します。
	Container	Component を格納している IContainer を取得します。 ( Component から継承されます。)
	Document	PrinterSettings を取得するために使用する PrintDocument を示す値を取得または設定します。
	PrinterSettings	ダイアログ ボックスで変更するプリンタ設定を取得または設定します。
	PrintToFile	[ファイルへ出力] チェック ボックスがオンかオフかを示す値を取得または設定します。
	ShowHelp	[ヘルプ] ボタンが表示されているかどうかを示す値を取得または設定します。
	ShowNetwork	[ネットワーク] ボタンが表示されているかどうかを示す値を取得または設定します。
	Site	Component の ISite を取得または設定します。 ( Component から継承されます。)
	Tag	コントロールに関するデータを格納するオブジェクトを取得または設定します。 ( CommonDialog から継承されます。)
	UseEXDialog

プロテクト プロパティ

	名前	説明
	CanRaiseEvents	コンポーネントがイベントを発生させることがきるかどうかを示す値を取得します。 ( Component から継承されます。)
	DesignMode	Component が現在デザイン モードかどうかを示す値を取得します。 ( Component から継承されます。)
	Events	Component に結び付けられているイベント ハンドラのリストを取得します。 ( Component から継承されます。)

参照

関連項目

PrintDialog クラス
System.Windows.Forms 名前空間
PageSetupDialog クラス
PrintPreviewDialog

PrintDialog メソッド

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	CreateObjRef	リモート オブジェクトとの通信に使用するプロキシの生成に必要な情報をすべて格納しているオブジェクトを作成します。 ( MarshalByRefObject から継承されます。)
	Dispose	オーバーロードされます。 Component によって使用されているリソースを解放します。 ( Component から継承されます。)
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
	GetLifetimeService	対象のインスタンスの有効期間ポリシーを制御する、現在の有効期間サービス オブジェクトを取得します。 ( MarshalByRefObject から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	InitializeLifetimeService	対象のインスタンスの有効期間ポリシーを制御する、有効期間サービス オブジェクトを取得します。 ( MarshalByRefObject から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	Reset	オーバーライドされます。 すべてのオプション、最後に選択したプリンタ、ページ設定をそれぞれの既定値にリセットします。
	ShowDialog	オーバーロードされます。 コモン ダイアログ ボックスを実行します。 ( CommonDialog から継承されます。)
	ToString	Component の名前を格納している String を返します (存在する場合)。このメソッドはオーバーライドできません。 ( Component から継承されます。)

プロテクト メソッド

	名前	説明
	Dispose	オーバーロードされます。 Component によって使用されているリソースを解放します。 ( Component から継承されます。)
	Finalize	Component がガベージ コレクションによってクリアされる前に、アンマネージ リソースを解放し、その他のクリーンアップ操作を実行します。 ( Component から継承されます。)
	GetService	Component またはその Container で提供されるサービスを表すオブジェクトを返します。 ( Component から継承されます。)
	MemberwiseClone	オーバーロードされます。 ( MarshalByRefObject から継承されます。)

参照

関連項目

PrintDialog クラス
System.Windows.Forms 名前空間
PageSetupDialog クラス
PrintPreviewDialog

PrintDialog メンバ

ユーザーがプリンタを選択し、印刷するドキュメント部分を選択できるようにします。

PrintDialog データ型で公開されるメンバを以下の表に示します。

パブリック コンストラクタ

	名前	説明
	PrintDialog	PrintDialog クラスの新しいインスタンスを初期化します。

パブリック プロパティ

( プロテクト プロパティ も参照)

	名前	説明
	AllowCurrentPage	[現在のページ] オプション ボタンが表示されているかどうかを示す値を取得または設定します。
	AllowPrintToFile	[ファイルへ出力] チェック ボックスがオンかオフかを示す値を取得または設定します。
	AllowSelection	[選択した部分] オプション ボタンが有効かどうかを示す値を取得または設定します。
	AllowSomePages	[ページ指定] オプション ボタンが有効かどうかを示す値を取得または設定します。
	Container	Component を格納している IContainer を取得します。(Component から継承されます。)
	Document	PrinterSettings を取得するために使用する PrintDocument を示す値を取得または設定します。
	PrinterSettings	ダイアログ ボックスで変更するプリンタ設定を取得または設定します。
	PrintToFile	[ファイルへ出力] チェック ボックスがオンかオフかを示す値を取得または設定します。
	ShowHelp	[ヘルプ] ボタンが表示されているかどうかを示す値を取得または設定します。
	ShowNetwork	[ネットワーク] ボタンが表示されているかどうかを示す値を取得または設定します。
	Site	Component の ISite を取得または設定します。(Component から継承されます。)
	Tag	コントロールに関するデータを格納するオブジェクトを取得または設定します。 (CommonDialog から継承されます。)
	UseEXDialog

プロテクト プロパティ

	名前	説明
	CanRaiseEvents	コンポーネントがイベントを発生させることがきるかどうかを示す値を取得します。(Component から継承されます。)
	DesignMode	Component が現在デザイン モードかどうかを示す値を取得します。(Component から継承されます。)
	Events	Component に結び付けられているイベント ハンドラのリストを取得します。(Component から継承されます。)

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	CreateObjRef	リモート オブジェクトとの通信に使用するプロキシの生成に必要な情報をすべて格納しているオブジェクトを作成します。 (MarshalByRefObject から継承されます。)
	Dispose	オーバーロードされます。 Component によって使用されているリソースを解放します。 (Component から継承されます。)
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
	GetLifetimeService	対象のインスタンスの有効期間ポリシーを制御する、現在の有効期間サービス オブジェクトを取得します。 (MarshalByRefObject から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	InitializeLifetimeService	対象のインスタンスの有効期間ポリシーを制御する、有効期間サービス オブジェクトを取得します。 (MarshalByRefObject から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	Reset	オーバーライドされます。 すべてのオプション、最後に選択したプリンタ、ページ設定をそれぞれの既定値にリセットします。
	ShowDialog	オーバーロードされます。 コモン ダイアログ ボックスを実行します。 (CommonDialog から継承されます。)
	ToString	Component の名前を格納している String を返します (存在する場合)。このメソッドはオーバーライドできません。 (Component から継承されます。)

プロテクト メソッド

	名前	説明
	Dispose	オーバーロードされます。 Component によって使用されているリソースを解放します。 (Component から継承されます。)
	Finalize	Component がガベージ コレクションによってクリアされる前に、アンマネージ リソースを解放し、その他のクリーンアップ操作を実行します。 (Component から継承されます。)
	GetService	Component またはその Container で提供されるサービスを表すオブジェクトを返します。 (Component から継承されます。)
	MemberwiseClone	オーバーロードされます。 ( MarshalByRefObject から継承されます。)

パブリック イベント

	名前	説明
	Disposed	コンポーネントの Disposed イベントを待機するイベント ハンドラを追加します。(Component から継承されます。)
	HelpRequest	ユーザーがコモン ダイアログ ボックスの [?] ボタンをクリックすると発生します。(CommonDialog から継承されます。)

参照

関連項目

PrintDialog クラス
System.Windows.Forms 名前空間
PageSetupDialog クラス
PrintPreviewDialog