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

Envía una imagen de un formulario Windows Forms al destino especificado por la propiedad de PrintAction , especificando el formulario e imprimir opciones

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

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

Comentarios

El método de Print imprime todos los objetos visibles en un formulario.Esto incluye cualquier texto o gráfico dibujado con los métodos de Graphics .

Si el formato especificado en el parámetro de printForm no tiene el foco, y el parámetro de PrintOption se establece en CompatibleModeClientAreaOnly o a CompatibleModeFullWindow, se inicia una excepción.Si PrintOption se establece en ClientAreaOnly, a FullWindow, o a Scrollable, cualquier formulario de la aplicación puede especificar, incluso si no tiene el foco.

[!NOTA]

Cuando el parámetro de PrintOption se establece en CompatibleModeClientAreaOnly o a CompatibleModeFullWindow, el formulario especificado por la propiedad de Form debe tener el foco.Si no, se inicia una excepción.Para evitarlo, llame al método de Focus de formulario antes de llamar a Print.

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

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

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

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

[!NOTA]

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

Ejemplos

El ejemplo siguiente imprime el formulario actual en la impresora predeterminada del sistema, imprimir sólo el área cliente en su tamaño mostrado actualmente y utilizando el método incompatible de impresión.Este ejemplo requiere tener un componente de PrintForm 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.