PrintForm.Print メソッド (Form, PrintForm.PrintOption)
フォームを指定し、オプションを印刷する PrintAction のプロパティで指定されたターゲットに Windows フォームのイメージを示します
名前空間: Microsoft.VisualBasic.PowerPacks.Printing
アセンブリ: Microsoft.VisualBasic.PowerPacks.Vs (Microsoft.VisualBasic.PowerPacks.Vs.dll 内)
構文
'宣言
Public Sub Print ( _
form As Form, _
printOption As PrintForm.PrintOption _
)
public void Print(
Form form,
PrintForm.PrintOption printOption
)
public:
void Print(
Form^ form,
PrintForm::PrintOption printOption
)
member Print :
form:Form *
printOption:PrintForm.PrintOption -> unit
public function Print(
form : Form,
printOption : PrintForm..::..PrintOption
)
パラメーター
- form
型 : System.Windows.Forms.Form
- printOption
型 : Microsoft.VisualBasic.PowerPacks.Printing.PrintForm.PrintOption
解説
Print のメソッドは、フォームに表示されているすべてのオブジェクトが出力されます。これは Graphics のメソッドに描画されたテキストやグラフィックスが含まれています。
printForm のパラメーターで指定されたフォームにフォーカスが設定されておらず、PrintOption のパラメーターが CompatibleModeClientAreaOnly または CompatibleModeFullWindow に設定されている場合、例外が発生します。PrintOption が ClientAreaOnly、FullWindow、または Scrollable に設定されている場合、フォーカスを持っていない場合でも、アプリケーション内のフォームが指定される場合があります。
[!メモ]
PrintOption のパラメーターが CompatibleModeClientAreaOnly または CompatibleModeFullWindow に設定すると、Form のプロパティで指定されたフォームにフォーカスが設定されている必要があります。そうでない場合は、例外が発生します。Print を呼び出す前に、これを回避するには、フォームの Focus のメソッドを呼び出します。
既定では、フォームのクライアント領域だけが印刷されます。印刷されたイメージのタイトル バー、境界、スクロール バーを含める場合は CompatibleModeFullWindow または FullWindow に PrintOption のパラメーターを設定します。
既定では、クライアント領域の現在表示されている部分またはフォームだけが印刷されます。ユーザーが実行時にフォームのサイズを変更する場合は、画面の表示として現在印刷されます。しかし、フォームの部分が画面の端から離れる場合、フォームは、完全に表示されていたように出力されます。
デザインしたサイズでフォームを印刷する場合は、Scrollable に PrintOption のパラメーターを設定します。
Print のメソッドでは、印刷は、2 種類の基になる実装の 1 つを使用します。実装は PrintOption のパラメーターによって決まります。このパラメーターが CompatibleModeClientAreaOnly または CompatibleModeFullWindow に設定すると、Visual Basic 6.0 の PrintForm のメソッドとの下位互換性のある実装が使用されます。このパラメーターが ClientAreaOnly、FullWindow または Scrollable に設定すると、フォームがフォーカスを持つことなく異なる実装が使用されます。
[!メモ]
一部のオペレーティング システムでは、Graphics のメソッドに描画されたテキストやグラフィックスが正しく表示されないことがあります。また、ClientAreaOnly、FullWindow または Scrollable に PrintOption のパラメーターを設定すると、Print を呼び出した直後にフォームの Refresh のメソッドを呼び出す必要がある場合があります。このメソッドを呼び出して、成果物は、フォームに表示されることがあります。
例
次の例は、クライアント領域だけ現在表示されているサイズで印刷、印刷の互換性のないメソッドを使用して、システム既定のプリンターに現在のフォームを印刷します。この例では、フォームの PrintForm1 という名前の PrintForm のコンポーネントが必要です。
PrintForm1.PrintAction = Printing.PrintAction.PrintToPrinter
PrintForm1.Print(Me, ClientAreaOnly)
Me.Refresh
.NET Framework セキュリティ
- 直前の呼び出し元に対する完全な信頼。このメンバーは、部分的に信頼されているコードから使用することはできません。詳細については、「部分信頼コードからのライブラリの使用」を参照してください。
参照
関連項目
Microsoft.VisualBasic.PowerPacks.Printing 名前空間
その他の技術情報
PrintForm コンポーネント (Visual Basic)
方法: PrintForm コンポーネントを使用してフォームを印刷する (Visual Basic)
方法: フォームのクライアント領域を印刷する (Visual Basic)
方法: フォームのクライアント領域と非クライアント領域を印刷する (Visual Basic)