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
型別:System.Windows.Forms.Form
備註
Print方法會列印表單上的所有可見的物件。 這包括任何文字或圖形,以繪製Graphics方法。
如果表單中所指定printForm參數沒有焦點,並PrintOption參數設為其中一個CompatibleModeClientAreaOnly或CompatibleModeFullWindow,就會引發例外狀況。 如果PrintOption設定為 [ ClientAreaOnly, FullWindow,或Scrollable,,也可能會指定應用程式中的任何表單,即使它沒有焦點。
注意事項 |
---|
當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 命名空間
其他資源
HOW TO:使用 PrintForm 元件列印表單 (Visual Basic)
HOW TO:列印表單的工作區 (Visual Basic)
HOW TO:列印表單的工作區和非工作區 (Visual Basic)