Sección de ejemplos vb.net

45 - PrintForm Component

Traducción del archivo de ayuda del componente PrintForm de Visual basic.NET

Introducción :

El componente PrintForm para Visual Basic 2005 , permite imprimir una imagen de un formulario de Windows en tiempo de ejecución. Su comportamiento sustituye al método PrintForm en versiones anteriores de Visual Basic

Descripción del PrintForm Component

Una tarea común en los trabajos con Windows Forms es poder imprimir una imagen de los formularios para crear informes impresos. Aunque se puede utilizar un componente PrintDocument para realizar esto , se requiere escribir mas cantidad de código.

Con este componente se puede

enviar una imagen de un windows form a una impresora
generar una ventana de vista previa de impresión para luego imprimir dicha imagen
imprimir directamente en un archivo

El PrintForm se puede agregar a la pestaña de Impresión del cuadro de herramientas de visual basic como un control, o también se puede utilizar el componente creandolo mediante código

Cuando se imprime un formulario, por defecto se imprimen toda el área cliente ( sin los bordes y la barra de título), incluyendo todos los controles que contenga y cualquier texto o gráficos dibujados mediante los métodos gráficos

Por defecto, la barra de título del formulario , las barras de desplazamiento, y los bordes no se imprimen. Por ejemplo, si el usuario cambia el tamaño de la ventana en tiempo de ejecución, solo se imprimirá lo que se encuentre actualmente visible.

El PrintForm por defecto , utiliza la impresora predeterminada del sistema, y en el momento de imprimir, se inicializa un cuadro de diálogo que permite al usuario cancelar el trabajo.

Propiedades , métodos y eventos

Método Print

El método principal del componente PrintForm es el método Print

Con este método se puede imprimir una imagen del formulario, desplegar la ventana de vista previa de impresión, o crear la imagen en un archivo.

Este método se puede llamar y ejecutar sin parámetros, o también se puede indicar las siguientes opciones

PrintForm.Print(printForm As Form, printFormOption As PrintOption)

El primer parámetro es el formulario, el segundo son opciones que indican si lo que se va a imprimir es solo el área visible, todo el contenido del formulario, incluyendo la barra de título y los bordes , o incluyendo el área que no se visualiza

Propiedad PrintAction

Esta propiedad determina si la salida es enviada directamente a la impresora, si se debe mostrar la imagen en una ventana de vista previa, o guardar la imagen como un archivo PostScript encapsulado.

Los valores que admite la propiedad PrintAction son tres opciones :

Printing.PrintAction.PrintToPreview : Ventana de vista previa
Printing.PrintAction.PrintToFile : Imprimir a un archivo
Printing.PrintAction.PrintToPrinter : Imprimir

Propiedad PrinterSettings :

La propiedad PrinterSettings permite el acceso a un objeto que contiene propiedades y métodos para poder establecer y consultar la configuración de la impresora, por ejemplo :

PrinterName : Obtiene y establece la impresora que se va a a utilizar
Copies: el número de copias a imprimir
Duplex: Para imprimir a doble cara
FromPage y ToPage : Página inicial y final que se van a imprimir
IsDefaultPrinter : Propiedad para saber si una impresora es la predeterminada del sistema
MaximumCopies y MaximumPage : máximo número de copias y páginas a imprimir
PaperSizes : Una Colección para obtener los tamaños de hoja admitidos por la impresora
PrintFileName : Propiedad con la ruta del archivo, cuando se imprime hacia un fichero PostScript
SupportsColor : Propiedad de solo lectura para obtener los colores soportados por la impresora
Otros ...

Eventos del PrintForm

Contiene tres eventos principales :

BeginPrint . evento que ocurre cuando se llama al método Print , antes de imprimir la primera página del documento
EndPrint . Ocurre al finalizar la impresión de la última página del documento
QueryPageSettings : Ocurre inmediatamente antes de imprimir cada página

Agregar el componenete a la barra de herramientas

1. Crear un nuevo proyecto de tipo Windows Application

2. Seleccionar desde el cuadro de herramientas, la pestaña impresión :

3 - Clic derecho sobre la pestaña, y seleccionar Elegir elementos :

4. En la solapa "Componentes de .NET FrameWork", buscar el PrintForm y seleccionar Aceptar para añadirlo al ToolBox

El componente se visualizará en el cuadro de herramientas para poder agregarlo a un formulario

Opcionalmente se puede agregar desde el menú "Herramientas" > " Elegir elementos del cuadro de herramientas "

Imprimir un formulario con el PrintForm

Imprimir un formulario en la impesora por defecto :

1. Arrastrar el componente PrintForm al formulario que se va a imprimir

2. Seleccionar el control, y desde la ventana de propiedades , elegir PrintAction y establecerle el valor PrintToPrinter

3. Para imprimir por ejemplo desde el evento clic de un botón, colocar el siguiente código :

PrintForm1.Print()

Visualizar el formulario en una ventana de vista previa

1. Agregar un componente PrintForm y desde la ventana de propiedades indicar en la opción PrintAction , el valor PrintToPreview.

2. Para imprimir ejecutar el método Print

Imprimir hacia un archivo

1. Cambiar la propiedad PrintAction por el valor PrintToFile

2. En la propiedad PrintFileName, indicar la ruta completa del archivo eps

        With PrintForm1
            .PrintAction = Printing.PrintAction.PrintToFile
            .PrintFileName = Ruta
            .Print()
        End With

Imprimir el área cliente ( solo el área visible )

    Private Sub Button1_Click( _
        ByVal sender As System.Object, _
        ByVal e As System.EventArgs) Handles Button1.Click

        With PrintForm1
            .PrintAction = Printing.PrintAction.PrintToPrinter

            .Print(Me, PowerPacks.Printing.PrintForm.PrintOption.ClientAreaOnly)
        End With

    End Sub

Imprimir un formulario Scrollable

Por defecto, el printForm sólo imprime la parte visible del formulario

Si un usuario ha cambiado de tamaño el formulario en tiempo de ejecución, el resultado puede no ser el esperado.

El procedimiento siguiente muestra cómo imprimir el área cliente del form desplegable incluso si se ha cambiado de tamaño en tiempo de ejecución

    Private Sub Button1_Click( _
        ByVal sender As System.Object, _
        ByVal e As System.EventArgs) Handles Button1.Click

        With PrintForm1
            .PrintAction = Printing.PrintAction.PrintToPrinter

            .Print(Me, PowerPacks.Printing.PrintForm.PrintOption.Scrollable)
        End With

    End Sub

Nota: Esta opción, no quiere decir que imprimirá todo el contenido del formulario si hay controles que sobrepasen el área de la pantalla, por ejemplo una grilla con muchos registros , en ese caso la imagen se recorta.

Descargar

PrintForm

Para ver mas información en inglés leer el archivo PrintFormHelp.htm que se instala en la carpeta : Microsoft Visual Basic 2005 Power Packs\Printing\PrintForm Component 1.0\Documentation

Buscar en Recursos vb