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

Artykuł
05/17/2015

Wysyła obraz formularza systemu Windows do obiektu docelowego określonego przez PrintAction właściwości, określania formularza 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: Form

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

Uwagi

Print Metoda Wyświetla wszystkie obiekty widoczne na formularzu.Dotyczy to również dowolny tekst lub grafiki z Graphics metody.

Jeśli formularz określony w printForm parametru nie ma fokus, a PrintOption parametr jest ustawiona jako CompatibleModeClientAreaOnly lub CompatibleModeFullWindow, zostanie zgłoszony wyjątek.Jeśli PrintOption ma ustawioną wartość ClientAreaOnly, FullWindow, lub Scrollable, można określić dowolnego formularza w aplikacji, nawet jeśli nie ma fokus.

[!UWAGA]

Gdy PrintOption parametr jest ustawiona jako CompatibleModeClientAreaOnly lub CompatibleModeFullWindow, formularz określony przez Form właściwość musi mieć fokus.Jeśli nie zostanie ono, wyjątek.Aby tego uniknąć, należy wywołać Focus formularz przed wywołaniem metody Print.

Domyślnie są drukowane tylko obszar klienta w postaci.Jeśli chcesz dołączyć pasek tytułu, paski przewijania i obramowania drukowanego obrazu, ustaw PrintOption parametr metody CompatibleModeFullWindow lub FullWindow.

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

Jeśli chcesz wydrukować formularz przy rozmiarze zaprojektowane, ustaw PrintOption parametr Scrollable.

Print Metoda korzysta z jedną z dwóch podstawowej implementacji potrzeby drukowania.Implementacja jest określana przez PrintOption parametru.Jeśli ten parametr ma wartość CompatibleModeClientAreaOnly lub CompatibleModeFullWindow, implementacja, który jest zgodny z Visual Basic 6.0 PrintForm używana jest metoda.Jeśli ten parametr ma wartość ClientAreaOnly, FullWindow lub Scrollable, jest używany przez inną implementację, który nie wymaga formularza, aby używać fokusu.

[!UWAGA]

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

Przykłady

Poniższy przykład Wyświetla bieżącego formularza, aby drukarka domyślna systemu, drukowanie tylko obszar klienta w aktualnie wyświetlonej rozmiarze i za pomocą metody niezgodnymi drukowania.W tym przykładzie wymaga PrintForm składnika o nazwie PrintForm1 na 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 Używanie bibliotek pochodzących z częściowo zaufanego kodu.