PrintForm.Print – metoda (Form, PrintForm.PrintOption)

Článek
05/16/2015

Odešle formulář pro systém Windows bitové kopie do cílového umístění určené PrintAction vlastnost, určení formuláře a možnosti tisku

Obor názvů: Microsoft.VisualBasic.PowerPacks.Printing
Sestavení: Microsoft.VisualBasic.PowerPacks.Vs (v Microsoft.VisualBasic.PowerPacks.Vs.dll)

Syntaxe

'Deklarace
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
)

Parametry

form
Typ: Form

printOption
Typ: Microsoft.VisualBasic.PowerPacks.Printing.PrintForm.PrintOption

Poznámky

Print Metoda vytiskne všechny viditelné objekty ve formuláři.To zahrnuje všechny textové nebo grafické nakreslené s Graphics metody.

Pokud formulář zadaný v printForm parametr nemá fokus a PrintOption parametr je nastaven na hodnotu CompatibleModeClientAreaOnly nebo CompatibleModeFullWindow, je vyvolána výjimka.Pokud PrintOption je nastavena na ClientAreaOnly, FullWindow, nebo Scrollable, je možné zadat všechny formuláře v aplikaci, i když nemá fokus.

[!POZNÁMKA]

Když PrintOption parametr je nastaven na hodnotu CompatibleModeClientAreaOnly nebo CompatibleModeFullWindow, formuláře určené Form vlastnost musí být vybrán jako aktivní.Pokud není, je vyvolána výjimka.Chcete-li se tomu vyhnout, zavolejte Focus formuláře před voláním metody Print.

Ve výchozím nastavení je vytištěno pouze klientské oblasti formuláře.Pokud chcete zahrnout záhlaví, posuvníky a ohraničení v tištěné obrázku, nastavte PrintOption parametr, který má buď CompatibleModeFullWindow nebo FullWindow.

Ve výchozím nastavení je vytištěno pouze aktuálně viditelné části oblasti klienta nebo formuláře.Pokud uživatel má velikost formuláře za běhu, budou vytištěny jako aktuálně viditelný na obrazovce.Pokud však část formuláře, bylo přesunuto vypnout okraji obrazovky, budou vytištěny formulář stále jakoby byly zcela viditelná.

Pokud chcete tisknout formulář navržené velikost, nastavte PrintOption parametr, který má Scrollable.

Print Metoda používá jednu z dvou základní implementace pro tisk.Implementace je dáno PrintOption parametru.Pokud je tento parametr nastaven na CompatibleModeClientAreaOnly nebo CompatibleModeFullWindow, implementace, která je zpětně kompatibilní s Visual Basic 6.0 PrintForm metoda se používá.Pokud je tento parametr nastaven na ClientAreaOnly, FullWindow nebo Scrollable, se používá jinou implementaci, která nevyžaduje formulář mít fokus.

[!POZNÁMKA]

Na některé operační systémy, textové nebo grafické nakreslené s Graphics metody nemusí zobrazit správně.Kromě toho, pokud je nastavena PrintOption parametr, který má ClientAreaOnly, FullWindow nebo Scrollable, bude pravděpodobně nutné volat Refresh formuláře bezprostředně po zavolání metody Print.Je-li tato metoda není volána, artefakty se může zobrazit ve formuláři.

Příklady

Následující příklad vytiskne aktuální formulář do výchozí tiskárny systém, tisk pouze oblasti klienta v aktuálně zobrazenou velikosti a použití metody nekompatibilní tisku.V tomto příkladu vyžaduje, abyste měli PrintForm součást s názvem PrintForm1 ve formuláři.

PrintForm1.PrintAction = Printing.PrintAction.PrintToPrinter
PrintForm1.Print(Me, ClientAreaOnly)
Me.Refresh

Zabezpečení rozhraní .NET Framework

Plná důvěra přímému volajícímu. Částečně zabezpečený kód nemůže tento člen použít. Další informace naleznete v tématu Používání knihoven z částečně důvěryhodného kódu.