PrintForm.Print (Método) (Form, PrintForm.PrintOption)

Artículo
05/17/2015

Envía una imagen de Windows Forms al destino especificado por la propiedad PrintAction, especificando las opciones de formato e impresión.

Espacio de nombres: Microsoft.VisualBasic.PowerPacks.Printing
Ensamblado: Microsoft.VisualBasic.PowerPacks.Vs (en Microsoft.VisualBasic.PowerPacks.Vs.dll)

Sintaxis

'Declaración
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
)

Parámetros

form
Tipo: Form

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

Comentarios

El Print método imprime todos los objetos visibles en un formulario. Esto incluye cualquier texto o gráficos que se dibujan con Graphics métodos.

Si el formulario especificado en el printForm parámetro no tiene el foco y el PrintOption parámetro está establecido en CompatibleModeClientAreaOnly o CompatibleModeFullWindow, se produce una excepción. Si PrintOption está establecido en ClientAreaOnly, FullWindow, o Scrollable, puede especificar cualquier formulario de su aplicación, incluso si no tiene el foco.

Nota

Cuando el PrintOption parámetro está establecido en CompatibleModeClientAreaOnly o CompatibleModeFullWindow, la forma especificada por el Form propiedad debe tener el foco.Si no es así, se produce una excepción.Para evitarlo, llame a la Focus método del formulario antes de llamar a Print.

De forma predeterminada, se imprime el área de cliente del formulario. Si desea incluir la barra de título, las barras de desplazamiento y borde en la imagen impresa, establezca el PrintOption parámetro como CompatibleModeFullWindow o FullWindow.

De forma predeterminada, se imprime sólo la parte visible del área cliente del formulario. Si un usuario se cambia el tamaño del formulario en tiempo de ejecución, se imprimirá como están visibles en pantalla. Si, sin embargo, parte del formulario se ha movido fuera del borde de la pantalla, el formulario se imprimirán como si fueran completamente visible.

Si desea imprimir el formulario con su tamaño diseñado, establezca el PrintOption parámetro Scrollable.

El Print método usa una de las dos implementaciones subyacentes para la impresión. La implementación está determinada por la PrintOption parámetro. Cuando este parámetro se establece en CompatibleModeClientAreaOnly o CompatibleModeFullWindow, una implementación que es compatible con Visual Basic 6.0 PrintForm se utiliza el método. Cuando este parámetro se establece en ClientAreaOnly, FullWindow o Scrollable, se utiliza una implementación diferente que no requiere que el formulario que tiene el foco.

Nota

En algunos sistemas operativos, texto o gráficos dibujados con Graphics métodos no se muestren correctamente.Además, si establece la PrintOption parámetro ClientAreaOnly, FullWindow o Scrollable, puede que tenga que llamar a la Refresh método del formulario inmediatamente después de llamar a Print.Si no llama a este método, los artefactos aparezcan en el formulario.

Ejemplos

En el ejemplo siguiente se imprime el formulario actual a la impresora predeterminada del sistema, imprimir el área de cliente en su tamaño actual y utilizando el método no compatibles de impresión. Este ejemplo requiere que haya un PrintForm componente denominado PrintForm1 en un formulario.

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

Seguridad de .NET Framework

Plena confianza para el llamador inmediato. Un código de confianza parcial no puede utilizar este miembro. Para obtener más información, vea Utilizar bibliotecas de código que no es de plena confianza.