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
)

參數

備註

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 安全性

請參閱

參考

PrintForm 類別

Print 多載

Microsoft.VisualBasic.PowerPacks.Printing 命名空間

其他資源

PrintForm 元件 (Visual Basic)

HOW TO：使用 PrintForm 元件列印表單 (Visual Basic)

HOW TO：列印表單的工作區 (Visual Basic)

HOW TO：列印表單的工作區和非工作區 (Visual Basic)

HOW TO：列印可捲動的表單 (Visual Basic)

部署參考 PrintForm 元件的應用程式 (Visual Basic)