PrintForm.Print 方法 (Form, PrintForm.PrintOption)
將 Windows Form 的映像傳送到所指定之目的地PrintAction屬性，指定表單及列印選項
命名空間： 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
類型：Form
備註
Print方法會列印在表單上的所有可見的物件。 這包括任何文字或圖形，以繪製Graphics方法。
如果表單中指定printForm參數沒有焦點，而且PrintOption參數設定為CompatibleModeClientAreaOnly或CompatibleModeFullWindow，引發例外狀況。 如果PrintOption設為ClientAreaOnly， FullWindow，或Scrollable，，也可能會指定應用程式中的任何表單，即使它並沒有焦點。
.gif "注意事項") 注意事項 |
|---|
當PrintOption參數設定為CompatibleModeClientAreaOnly或CompatibleModeFullWindow，所指定的格式Form屬性必須具有焦點。如果不存在，則會引發例外狀況。若要避免這個問題，呼叫Focus表單才能呼叫方法Print。 |
根據預設，只有表單的用戶端區域會列印。 如果您想要列印的映像中包含標題列、 捲軸和框線，設定PrintOption參數為CompatibleModeFullWindow或FullWindow。
根據預設，會列印目前可見部分的用戶端區域或表單。 如果使用者已在執行階段調整表單的大小，它會列印為目前螢幕上顯示。 如果，不過，表單的部分已移出螢幕的邊緣，如同它是完全可見仍會列印表單。
如果您想要列印的表單，其設計的大小，設定PrintOption參數Scrollable。
Print方法會使用兩個基礎實作的其中一個進行列印。 實作由PrintOption參數。 當此參數設為CompatibleModeClientAreaOnly或CompatibleModeFullWindow，與 Visual Basic 6.0 的回溯相容的實作PrintForm使用方法。 當此參數設為ClientAreaOnly，FullWindow或Scrollable，會使用不同的實作不需要具有焦點的表單。
| 注意事項 |
|---|
在某些作業系統、 文字或圖形，以繪製Graphics方法可能無法正確顯示。此外，如果您設定PrintOption參數ClientAreaOnly，FullWindow或Scrollable，您可能要呼叫Refresh表單只有在您呼叫之後立即方法Print。如果未呼叫此方法，成品可能會出現在表單上。 |
範例
下列範例會列印目前的表單，以系統預設印表機，列印只有用戶端區域的目前顯示大小和使用列印功能的非相容方法。 此範例中您需要PrintForm名 PrintForm1 為表單上的元件。
PrintForm1.PrintAction = Printing.PrintAction.PrintToPrinter
PrintForm1.Print(Me, ClientAreaOnly)
Me.Refresh
.NET Framework 安全性
- 完全信任立即呼叫者。這個成員無法供部分信任的程式碼使用。如需詳細資訊，請參閱從部分受信任程式碼使用程式庫。
請參閱
參考
Microsoft.VisualBasic.PowerPacks.Printing 命名空間
其他資源
如何：使用 PrintForm 元件列印表單 (Visual Basic)