Metodo PrintForm.Print (Form, PrintForm.PrintOption)

Articolo
05/16/2015

Invia un'immagine di un Windows Form alla destinazione specificata dalla proprietà PrintAction, specificando il form e le opzioni di stampa

Spazio dei nomi: Microsoft.VisualBasic.PowerPacks.Printing
Assembly: Microsoft.VisualBasic.PowerPacks.Vs (in Microsoft.VisualBasic.PowerPacks.Vs.dll)

Sintassi

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

Parametri

form
Tipo: Form

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

Note

Il Print consente di stampare tutti gli oggetti visibili in un form. Questo include qualsiasi testo o grafica creati con Graphics metodi.

Se il modulo specificato nel printForm parametro non è attivo e PrintOption parametro è impostato su CompatibleModeClientAreaOnly o CompatibleModeFullWindow, viene generata un'eccezione. Se PrintOption è impostato su ClientAreaOnly, FullWindow, o Scrollable, possibile specificare qualsiasi form dell'applicazione, anche se non è attivo.

Nota

Quando il PrintOption parametro è impostato su CompatibleModeClientAreaOnly o CompatibleModeFullWindow, la maschera specificata tramite il Form deve essere attiva la proprietà.Se non lo è, viene generata un'eccezione.Per evitare questo problema, chiamare il Focus metodo del form prima di chiamare Print.

Per impostazione predefinita, viene stampato solo l'area client del form. Se si desidera includere la barra del titolo, le barre di scorrimento e bordo nell'immagine stampata, impostare il PrintOption parametro al metodo CompatibleModeFullWindow o FullWindow.

Per impostazione predefinita, viene stampata solo la parte visibile dell'area client o del modulo. Se un utente ha ridimensionato il form in fase di esecuzione, questo verrà stampato come attualmente visibile sullo schermo. Se, tuttavia, parte del modulo è stato spostato oltre il bordo dello schermo, come se fosse completamente visibile ancora verrà stampato il form.

Se si desidera stampare il form nella dimensione progettata, impostare il PrintOption parametro Scrollable.

Il Print metodo utilizza una delle due implementazioni sottostanti per la stampa. L'implementazione è determinata dal PrintOption parametro. Quando questo parametro è impostato su CompatibleModeClientAreaOnly o CompatibleModeFullWindow, un'implementazione compatibile con Visual Basic 6.0 PrintForm viene utilizzato il metodo. Quando questo parametro è impostato su ClientAreaOnly, FullWindow o Scrollable, viene utilizzata un'implementazione diversa che non richiede il form lo stato attivo.

Nota

In alcuni sistemi operativi, testo o grafica creati con Graphics metodi non vengano visualizzati correttamente.Inoltre, se si imposta la PrintOption parametro ClientAreaOnly, FullWindow o Scrollable, potrebbe essere necessario chiamare il Refresh metodo del form immediatamente dopo la chiamata Print.Se non si chiama questo metodo, gli elementi vengano visualizzati nel form.

Esempi

Nell'esempio seguente viene stampato il form corrente per la stampante predefinita di sistema, stampa solo l'area client nelle dimensioni attualmente visualizzata e utilizzando il metodo non compatibile di stampa. Si suppone di disporre di un PrintForm componente denominato PrintForm1 in un form.

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

Sicurezza di .NET Framework

Attendibilità totale per il chiamante immediato. Impossibile utilizzare questo membro in codice parzialmente attendibile. Per altre informazioni, vedere Utilizzo di librerie da codice parzialmente attendibile.