Sección de ejemplos vb.net

45 - PrintForm Component

Volver - Anterior - Siguiente



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

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 :

 

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 :

 

Eventos del PrintForm

Contiene tres eventos principales :

 

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