Metoda PrintForm.Print — (Form, PrintForm.PrintOption)

Artykuł
10/27/2012

Wysyła obraz formularza systemu Windows do miejsca docelowego określonego przez PrintAction właściwość, określający formularz i opcje drukowania

Przestrzeń nazw: Microsoft.VisualBasic.PowerPacks.Printing
Zestaw: Microsoft.VisualBasic.PowerPacks.Vs (w Microsoft.VisualBasic.PowerPacks.Vs.dll)

Składnia

'Deklaracja
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: System.Windows.Forms.Form

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

Uwagi

Print Metoda drukuje wszystkie obiekty widoczne na formularzu.Obejmuje to dowolny tekst lub grafikę z Graphics metody.

Jeśli formularz określony w printForm parametr nie ma fokusu oraz PrintOption parametr jest ustawiony do albo CompatibleModeClientAreaOnly lub CompatibleModeFullWindow, jest wyjątek.Jeśli PrintOption jest ustawiona na ClientAreaOnly, FullWindow, lub Scrollable, mogą być określone dowolnej formie w aplikacji, nawet jeśli nie ma fokusa.

[!UWAGA]

Gdy PrintOption parametr jest ustawiony do albo CompatibleModeClientAreaOnly lub CompatibleModeFullWindow, formularz określony przez Form właściwość musi mieć fokus.Jeśli nie, tworzony jest wyjątek.Aby tego uniknąć, należy wywołać Focus metodę formularza przed wywołaniem Print.

Domyślnie tylko obszaru klienckiego formularz jest drukowany.Jeśli chcesz dołączyć pasek tytułu, paski przewijania i obramowania obrazu drukowanego PrintOption albo parametr CompatibleModeFullWindow lub FullWindow.

Domyślnie tylko widoczne części obszaru klienta lub formularz jest drukowany.Jeśli użytkownik ma rozmiar formularza w czasie wykonywania, zostanie on wydrukowany jako widoczne na ekranie.Jeśli jednak część formularza został przeniesiony poza krawędź ekranu, formularz nadal będzie drukowany tak, jakby była całkowicie widoczna.

Jeśli chcesz wydrukować formularz na jego rozmiar zaprojektowane, PrintOption parametr Scrollable.

Print Metoda używa jednego z dwóch podstawowych implementacje do drukowania.Wprowadzenia w życie jest określone przez PrintOption parametru.Kiedy ten parametr ma wartość CompatibleModeClientAreaOnly lub CompatibleModeFullWindow, implementacja, zgodny wstecz z programu Visual Basic 6.0 PrintForm używana jest metoda.Kiedy ten parametr ma wartość ClientAreaOnly, FullWindow lub Scrollable, jest używane różne implementacje, która nie wymaga od formularza ma fokus.

[!UWAGA]

W niektórych systemach operacyjnych, tekstu lub grafiki z Graphics metody mogą być wyświetlane niepoprawnie.Ponadto, jeśli ustawiono PrintOption parametr ClientAreaOnly, FullWindow lub Scrollable, trzeba wywoływać Refresh formularza natychmiast po wywołaniu metody Print.Jeśli ta metoda nie zostanie wywołana, artefakty mogą być wyświetlane w formularzu.

Przykłady

Poniższy przykład drukuje bieżący formularz do drukarki domyślnej systemu drukowania tylko obszaru klienckiego w aktualnie wyświetlanej rozmiarze i przy użyciu metody niezgodny drukowania.W tym przykładzie wymaga, która ma PrintForm składnik o nazwie PrintForm1 w formularzu.

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

Zabezpieczenia programu .NET Framework

Pełne zaufanie do bezpośredniego wywołującego. Tego elementu członkowskiego nie można używać w kodzie częściowo zaufanym. Aby uzyskać więcej informacji, zobacz Przy użyciu bibliotek z częściowo zaufanego kodu..