Sie sind auf Seite 1von 60

Crystal Reports para Visual Basic 79

C A P T U L O

El control ActiveX de Crystal

El motor de informes de Crystal


Adems de actuar como una aplicacin de generacin de informes independiente y eficaz, Crystal Reports proporciona un mdulo de generacin de informes que puede vincular y al que puede tener acceso desde aplicaciones de Visual Basic. Como programador que utiliza Visual Basic 5.0, puede agregar capacidades sofisticadas para generar e imprimir informes a las aplicaciones sin la costosa tarea de escribir su propio cdigo. El motor de informes de Crystal es una biblioteca de vnculos dinmicos (DLL) que permite que las aplicaciones tengan acceso a las mismas caractersticas de impresin de informes que estn disponibles en Crystal Reports. Como usuario con licencia de Crystal Reports, recibe derechos para entregar gratuitamente la DLL del motor de informes (CRPE.DLL) con cualquier aplicacin que cree. Desde una aplicacin, tiene acceso al motor de informes mediante el control de Crystal ActiveX. Cuando se compilan, las aplicaciones enlazan con el motor de informes para agregar funcionalidad de generacin de informes a la aplicacin. Los informes pueden ser simples, produciendo un nico informe que se enva a una impresora o a una ventana de impresin sin opciones disponibles para el usuario, o puede ser complejo, permitiendo que el usuario cambie aspectos tales como la seleccin de registros, ordenacin, agrupacin y decisin de dnde debe enviarse el informe resultante.

Crystal Reports para Visual Basic 79

Filename: 86502569.doc Project: Traditional User's Guide Template Template: Author: Kirsten Sutton Last Saved By: Marisa Olivares Revision #: 115 Page: 79 of 60 Printed: 12/27/96 12:20 A12/P12

Captulo 6 El control ActiveX de Crystal

Antes de usar el control ActiveX


Antes de agregar el control ActiveX a una aplicacin, debe familiarizarse con algunas caractersticas clave del motor de informes. Revise los siguientes puntos y asegrese de entenderlos todos antes de tratar de usar el control ActiveX. El motor de informes genera informes existentes. No puede crear archivos de informe mediante la funcionalidad del motor de informes. Los informes deben crearse mediante la aplicacin Crystal Reports. Asegrese de comprender el proceso de creacin de informes antes de tratar de generar informes con el motor de informes. El motor de informes proporciona un cmodo complemento, por medio del control ActiveX, del proyecto de la aplicacin de Visual Basic existente. Con unas pocas lneas de cdigo se produce una eficaz herramienta de diseo y distribucin de informes que de otra forma podra necesitar miles de lneas de cdigo y varias semanas de produccin. El motor de informes no requiere el uso de una interfaz de usuario fija; est diseado para funcionar con su proyecto de desarrollo existente y le permite definir la interfaz de usuario con la que sus clientes y usuarios estn familiarizados y esperen de su producto.

Uso del motor de informes de Crystal


Cualquier proyecto de Visual Basic que incorpore el motor de informes Crystal requiere tres pasos: Crear los informes a los que tendrn acceso sus usuarios. Disear la interfaz de usuario en Visual Basic que controlar el motor de informes. Agregar el control ActiveX Crystal a su aplicacin.

Creacin de informes
La creacin de informes para incluirlos en aplicaciones es idntica a la creacin de informes para su propio uso; no existen restricciones. Mediante los procedimientos perfilados en el manual y la Ayuda de Crystal Reports, cree tantos tipos de informes como quiera poner a disposicin de los usuarios. Puede crear informes tan simples o tan sofisticados como dicten sus necesidades.

Diseo de la interfaz de usuario


La interfaz que desarrolle para permitir que los usuarios impriman informes slo esta limitado por sus necesidades y por su imaginacin. Funcionar siempre y cuando

Crystal Reports para Visual Basic

Filename: 86502569.doc Project: Traditional User's Guide Template Template: Author: Kirsten Sutton Last Saved By: Marisa Olivares Revision #: 115 Page: 80 of 60 Printed: 12/27/96 12:20 A12/P12

Captulo 6 El control ActiveX de Crystal

pueda usar el control ActiveX Crystal. El tipo de interfaz de usuario que seleccione no es importante para Crystal Reports.

Crystal Reports para Visual Basic 81

Filename: 86502569.doc Project: Traditional User's Guide Template Template: Author: Kirsten Sutton Last Saved By: Marisa Olivares Revision #: 115 Page: 81 of 60 Printed: 12/27/96 12:20 A12/P12

Captulo 6 El control ActiveX de Crystal

Los mtodos comunes de uso del motor de informes incluye un nico comando de men que produce un informe, un cuadro de dilogo que permite varias opciones para imprimir informes o una aplicacin cliente completamente independiente a la que llama su aplicacin. Todas las tcnicas son aceptables y cada una tiene sus ventajas. La forma en que disee la interfaz de usuario puede depender de lo siguiente: el propsito de la aplicacin, los tipos de informes que usar la aplicacin, las opciones de impresin que quiera ofrecer con los informes, y si la aplicacin ofrecer un nico informe o una eleccin entre varios informes. Considere detenidamente la aplicacin y las necesidades de los informes, y disee la interfaz de usuario que utilizar el motor de informes ms eficientemente.

El control ActiveX
ActiveX es una nueva tecnologa de Microsoft Corporation diseada para traer aplicaciones ms eficaces a equipos personales y redes locales. ActiveX va ms all de las aplicaciones que producen documentos estticos para un entorno de Windows que proporciona controles activos, documentos y aplicaciones de cliente que pueden operar e interaccionar no solo entre s, sino con redes intranet y con Internet. Los controles ActiveX proporcionan capacidades complementarias que le permiten agregar componentes de aplicacin, e incluso aplicaciones completas, a sus propios proyectos de desarrollo sin escribir ms que unas pocas lneas de cdigo. Crystal Reports es compatible con el concepto ActiveX mediante el control Crystal ActiveX. Use el control ActiveX para tener acceso al motor de informes Crystal y agregar fcilmente todo el poder de procesamiento de informes de Crystal Reports a sus propias aplicaciones de Visual Basic. Consulte la documentacin de Visual Basic para obtener informacin completa acerca del uso de controles ActiveX con Visual Basic. El resto de este captulo describe informacin especfica del control ActiveX Crystal.

Agregar el control ActiveX a un proyecto


El control ActiveX Crystal se instala en el directorio \WINDOWS\SYSTEM al instalar Visual Basic 5.0. El control ActiveX se agrega a un proyecto de Visual Basic mediante el comando Componentes del men Proyecto de Visual Basic. 1 Abra Visual Basic. 2 Abra el proyecto al que desee agregar el control ActiveX. 3 Elija el comando Componentes del men Proyecto. Aparecer el cuadro de dilogo Componentes.

Crystal Reports para Visual Basic

Filename: 86502569.doc Project: Traditional User's Guide Template Template: Author: Kirsten Sutton Last Saved By: Marisa Olivares Revision #: 115 Page: 82 of 60 Printed: 12/27/96 12:20 A12/P12

Captulo 6 El control ActiveX de Crystal

4 Si el control Crystal Report aparece en la lista Controles, haga clic en la casilla de verificacin que hay junto a l, haga clic en Aceptar y vaya al paso 8. 5 Si el control Crystal Report no aparece en la lista Controles, haga clic en Examinar y aparecer el cuadro de dilogo Agregar control ActiveX. Nota Crystal Report Control es el nombre del control ActiveX Crystal cuando se agrega a un proyecto de desarrollo. El trmino control ActiveX hace referencia a un tipo de control, mientras que Crystal Report Control es el nombre del control ActiveX Crystal proporcionado por Crystal Reports. En esta documentacin, los trminos control ActiveX Crystal y Crystal Report Control se usan indistintamente para hacer referencia al control ActiveX incluido con Crystal Reports para Visual Basic. 6 Use los controles del cuadro de dilogo Agregar control ActiveX para encontrar y seleccionar el archivo CRYSTL16.OCX (16 bits) o CRYSTL32.OCX (32 bits). Este archivo se instala en el directorio \WINDOWS\SYSTEM de manera predeterminada. Una vez encontrado y seleccionado el archivo, haga clic en Abrir. 7 Crystal Report Control aparecer en el cuadro de lista Controles. Haga clic en la casilla de verificacin que hay junto al nombre del control y haga clic en Aceptar. 8 Visual Basic agrega el control ActiveX Crystal al cuadro de herramientas. 9 Cuando quiera agregar el control ActiveX a un formulario, haga doble clic en la herramienta y el programa lo instalar en el formulario activo.

Uso del control ActiveX


Una vez que tenga un objeto control ActiveX Crystal en el formulario, se crea la conexin entre la aplicacin y Crystal Reports estableciendo las propiedades del objeto en tiempo de diseo o cambindolas en tiempo de ejecucin. Las propiedades de ActiveX le permiten especificar: el nombre del informe que desea imprimir como respuesta al evento de una aplicacin, el destino de un informe (ventana Vista previa, archivo de disco, impresora o correo electrnico), el nmero de copias que desea imprimir (si el informe va a la impresora), informacin del archivo de impresin (si el informe va a un archivo de disco), informacin de tamao y posicin de la ventana (si el informe va a una ventana Vista previa),

Crystal Reports para Visual Basic 83

Filename: 86502569.doc Project: Traditional User's Guide Template Template: Author: Kirsten Sutton Last Saved By: Marisa Olivares Revision #: 115 Page: 83 of 60 Printed: 12/27/96 12:20 A12/P12

Captulo 6 El control ActiveX de Crystal

informacin de frmula de seleccin (si quiere limitar los registros del informe), informacin de orden, y otras propiedades relacionadas. Las propiedades del control ActiveX Crystal pueden cambiarse en tiempo de diseo o en tiempo de ejecucin. Sin embargo, tenga en cuenta que algunas propiedades slo estn disponibles en tiempo de ejecucin. Estas propiedades no aparecen en tiempo de diseo.

Cambio de propiedades en tiempo de diseo


10 Haga clic en el control ActiveX que aparece en el formulario para seleccionarlo. 11 Haga clic con el botn secundario del mouse (ratn) y elija el comando Propiedades de Crystal del men contextual que aparece. Aparecer el cuadro de dilogo Pginas de propiedades. 12 Use las fichas y los controles de este cuadro de dilogo para cambiar las propiedades del control ActiveX en tiempo de diseo. Nota Las propiedades del control ActiveX tambin aparecen en el cuadro Propiedades de Visual Basic en tiempo de diseo.

Cambio de propiedades en tiempo de ejecucin


La mayora de las propiedades del control ActiveX pueden establecerse en tiempo de ejecucin agregando entradas simples al cdigo del procedimiento. Las propiedades establecidas en tiempo de ejecucin sustituyen a los valores establecidos en tiempo de diseo. Use la propiedad Action o el mtodo PrintReport para procesar realmente el informe en tiempo de ejecucin. La propiedad Action y el mtodo PrintReport slo pueden usarse en tiempo de ejecucin y son los nicos medios por los que el control ActiveX puede generar el informe realmente. Para obtener ms informacin acerca de cmo establecer el valor de determinadas propiedades en tiempo de ejecucin, consulte la descripcin de cada propiedad o en la Ayuda en pantalla de Crystal Reports. Cada descripcin incluye cdigo de ejemplo para establecer la propiedad en la aplicacin de Visual Basic.

Crystal Reports para Visual Basic

Filename: 86502569.doc Project: Traditional User's Guide Template Template: Author: Kirsten Sutton Last Saved By: Marisa Olivares Revision #: 115 Page: 84 of 60 Printed: 12/27/96 12:20 A12/P12

Captulo 6 El control ActiveX de Crystal

ndice de propiedades ActiveX


A continuacin se enumeran las propiedades ActiveX, adems de una breve descripcin.
Action BoundReportFooter Es la propiedad que desencadena la impresin del informe. Propiedad True o False que especifica si el pie de pgina va a aparecer o no en el informe enlazado predeterminado. Propiedad de cadena que permite al usuario asignar un ttulo al informe. Inicia una sesin en un servidor SQL. Especifica el nmero de copias que se van a imprimir si imprime en una impresora. Especifica la ubicacin de los archivos o tablas de base de datos usados en el informe. Especifica en qu control de datos busca los datos el control ActiveX Crystal Reports. Especifica el destino en el que se imprimir el informe (Ventana, Impresora o Archivo). Especifica el nmero de copias de cada registro de la seccin Detalles que imprimir el programa. Si los datos se guardan con el informe especificado, establecer esta propiedad a 1 (True) descarta los datos. Especifica la lista "CC" a la que desea enviar el mensaje de correo electrnico. Especifica la cadena del mensaje de correo electrnico. Especifica la lnea de asunto del mensaje de correo electrnico. Especifica la lista "A" a la que desea enviar el mensaje de correo electrnico. Especifica una nueva cadena para una frmula existente. Obtiene y establece los datos usados para un grfico especificado.

BoundReportHeading Connect CopiesToPrinter DataFiles DataSource Destination DetailCopies

DiscardSavedData

EMailCCList EMailMessage EMailSubject EMailToList Formulas GraphData

Crystal Reports para Visual Basic 85

Filename: 86502569.doc Project: Traditional User's Guide Template Template: Author: Kirsten Sutton Last Saved By: Marisa Olivares Revision #: 115 Page: 85 of 60 Printed: 12/27/96 12:20 A12/P12

Captulo 6 El control ActiveX de Crystal

GraphOptions GraphText GraphType

Obtiene y establece una serie de opciones para el grfico especificado. Obtiene y establece los diversos componentes de texto para el grfico especificado. Obtiene y establece el tipo de grfico usado en la seccin seleccionada del informe especificado. Especifica qu tipo de cambio en el Campo de condicin de grupo desencadenar la creacin de un grupo. Especifica los grupos que se van a usar cuando imprima el informe. Especifica el o los campos de grupo que se usarn para ordenar el los datos al imprimir informe. Devuelve el cdigo de error para el ltimo error de ejecucin. Devuelve la cadena de error para el ltimo error de tiempo de ejecucin. Consulte la documentacin de Visual Basic. Obtiene y establece el margen inferior para el informe especificado. Obtiene y establece el margen izquierdo para el informe especificado. Obtiene y establece el margen derecho para el informe especificado. Obtiene y establece el margen superior para el informe especificado. Consulte la documentacin de Visual Basic. Introduce la contrasea necesaria para usar las tablas de la base de datos en un archivo restringido .mdb de Access. Obtiene y establece el componente da de la fecha de impresin (si es diferente de la fecha real en que se imprime el informe). Si especifica ms de una copia para imprimir (mediante la propiedad PrinterCopies), PrinterCollation especifica si las copias se intercalarn o no. Obtiene y establece el nmero de copias del informe para imprimir.

GroupCondition

GroupSelectionFormula GroupSortFields

LastErrorNumber LastErrorString Left MarginBottom MarginLeft MarginRight MarginTop Name Password

PrintDay

PrinterCollation

PrinterCopies

Crystal Reports para Visual Basic

Filename: 86502569.doc Project: Traditional User's Guide Template Template: Author: Kirsten Sutton Last Saved By: Marisa Olivares Revision #: 115 Page: 86 of 60 Printed: 12/27/96 12:20 A12/P12

Captulo 6 El control ActiveX de Crystal

PrinterDriver PrinterName PrinterPort PrinterStartPage PrinterStopPage PrintFileCharSepQuote

Obtiene y establece el nombre del controlador de impresora que imprimir el informe. Obtiene y establece el nombre de la impresora que imprimir el informe. Obtiene y establece el nombre del puerto de impresora que imprimir el informe. Obtiene y establece la primera pgina que se va a imprimir. Obtiene y establece la ltima pgina que se va a imprimir. Obtiene y establece el carcter separador para encerrar datos de campos alfanumricos cuando se imprime a un archivo con el formato Separado por caracteres. Obtiene y establece el o los caracteres que dese usar para separar los campos cuando se imprime a un archivo con el formato Valor separador por caracteres. Especifica el nombre del archivo en el que se imprimir el informe. Especifica el tipo del archivo en el que se imprimir el informe. Cuando se imprime en un archivo, indica si el programa debe guardar o no las fechas en el mismo formato de fecha (MDA, DMA, etc.) que el utilizado en el informe o bien optimizar las fechas para el formato de archivo seleccionado. Cuando se imprime en un archivo, indica si el programa debe imprimir o no nmeros en el mismo formato (decimales, negativos, etc.) que se ha usado en el informe o bien optimizar los nmeros para el formato de archivo seleccionado. Obtiene y establece el componente mes de la fecha de impresin (si es diferente de la fecha real de impresin del informe). Obtiene y establece el componente ao de la fecha de impresin (si es diferente de la fecha real de impresin del informe). Determina el nmero de registros impresos realmente.

PrintFileCharSepSeparator

PrintFileName PrintFileType PrintFileUseRptDateFmt

PrintFileUseRptNumberFmt

PrintMonth

PrintYear

RecordsPrinted

Crystal Reports para Visual Basic 87

Filename: 86502569.doc Project: Traditional User's Guide Template Template: Author: Kirsten Sutton Last Saved By: Marisa Olivares Revision #: 115 Page: 87 of 60 Printed: 12/27/96 12:20 A12/P12

Captulo 6 El control ActiveX de Crystal

RecordsRead RecordsSelected ReportDisplayPage

Determina el nmero de registros ledos realmente. Determina el nmero de registros seleccionados. Indica qu pgina de un informe de varias pginas se est mostrando actualmente en la ventana Vista previa. Especifica el informe que se va a imprimir. Determina la ltima pgina impresa del informe especificado. Especifica el origen del informe como un archivo de informe, un control de datos, o un control de datos de cuadrcula. Determina la primera pgina impresa en el informe especificado. Especifica la fuente para una seccin. Especifica el formato para una seccin. Especifica el alto de lnea para una seccin. Establece el alto de seccin mnimo para la seccin de informe especificada. Especifica los registros que se van a usar al imprimir el informe. Establece el controlador de sesin para un usuario una vez que las propiedades UserName y Password hayan abierto un archivo .mdb de Access para usarlo en el informe. Especifica el o los campos que se usarn para ordenar los datos cuando se imprima el informe. Obtiene y establece la cadena de consulta SQL usada por el informe especificado. Determina el estado de impresin del informe especificado. Obtiene y establece los parmetros de procedimiento almacenados cuando se usa un informe basado en procedimientos almacenados SQL. Consulte la documentacin de Visual Basic. Introduce el nombre asignado a un usuario para conectarse a un archivo .mdb de Access protegido, para obtener los archivos de datos requeridos por el informe.

ReportFileName ReportLatestPage ReportSource

ReportStartPage SectionFont SectionFormat SectionLineHeight SectionMinHeight SelectionFormula SessionHandle

SortFields

SQLQuery Status StoredProcParam

Top UserName

Crystal Reports para Visual Basic

Filename: 86502569.doc Project: Traditional User's Guide Template Template: Author: Kirsten Sutton Last Saved By: Marisa Olivares Revision #: 115 Page: 88 of 60 Printed: 12/27/96 12:20 A12/P12

Captulo 6 El control ActiveX de Crystal

WindowBorderStyle WindowControlBox

Especifica el tipo de borde para la ventana de impresin. Especifica si la ventana de impresin tendr o no un cuadro de control (men de sistema) en la esquina superior izquierda cuando el informe se dirija a una ventana. Especifica si aparecern o no controles de impresin en la ventana Vista previa cuando la impresin se dirija a una ventana. Establece el alto de la ventana de impresin cuando sta se dirija a una ventana. Establece la distancia, en pxeles, desde el borde izquierdo de la ventana primaria a la ventana de impresin. Si la ventana de impresin es de nivel superior, la distancia se mide desde el borde izquierdo de la pantalla. Especifica si la ventana de impresin tendr o no un botn de maximizar cuando el informe se imprima en una ventana. Especifica si la ventana de impresin tendr o no un botn de minimizar cuando el informe se imprima en una ventana. Especifica el controlador de la ventana primaria si la ventana de impresin va a ser secundaria de otra ventana. Establece el estado de la ventana Vista previa (normal, minimizada o maximizada) cuando el informe se dirija a una ventana Vista previa. Especifica el ttulo que desea que aparezca en la barra de ttulo de la ventana de impresin cuando el informe se dirija a una ventana. Establece la distancia, en pxeles, desde el borde superior de la ventana primaria a la ventana de impresin. Si la ventana de impresin es de nivel superior, la distancia se mide desde el borde superior de la pantalla. Especifica el ancho de la ventana de impresin en pxeles.

WindowControls

WindowHeight WindowLeft

WindowMaxButton

WindowMinButton

WindowParentHandle

WindowState

WindowTitle

WindowTop

WindowWidth

Crystal Reports para Visual Basic 89

Filename: 86502569.doc Project: Traditional User's Guide Template Template: Author: Kirsten Sutton Last Saved By: Marisa Olivares Revision #: 115 Page: 89 of 60 Printed: 12/27/96 12:20 A12/P12

Captulo 6 El control ActiveX de Crystal

ndice de mtodos ActiveX


PrintReport Desencadena la impresin del informe.

Propiedades del control ActiveX Crystal


Action
Descripcin Action es la propiedad que desencadena la impresin del informe. Uso en tiempo de ejecucin [formulario.]CrystalReport.Action = 1 Por ejemplo:
CrystalReport1.Action = 1

imprime el informe especificado. Comentarios Establezca la propiedad Action a 1 en el cdigo del procedimiento (CrystalReport1.Action = 1) para imprimir el informe como respuesta a un evento del usuario. Disponibilidad Slo de escritura en tiempo de ejecucin

BoundReportFooter
Descripcin Propiedad True o False que especifica si el pie de pgina va a aparecer o no en el informe enlazado predeterminado. Uso en tiempo de ejecucin [formulario.]CrystalReport1.BoundReportFooter = True Por ejemplo:
CrystalReport1.BoundReportFooter = True

Disponibilidad Tiempo de diseo; tiempo de ejecucin

BoundReportHeading
Descripcin Propiedad de cadena que permite al usuario asignar el ttulo del informe. Uso en tiempo de ejecucin [formulario.]CrystalReport1.BoundReportHeading = "ttulo de informe"

Crystal Reports para Visual Basic

Filename: 86502569.doc Project: Traditional User's Guide Template Template: Author: Kirsten Sutton Last Saved By: Marisa Olivares Revision #: 115 Page: 90 of 60 Printed: 12/27/96 12:20 A12/P12

Captulo 6 El control ActiveX de Crystal

Por ejemplo:
CrystalReport1.BoundReportHeading = "Ventas por regin"

imprime el ttulo indicado para el informe especificado. Disponibilidad Tiempo de diseo; tiempo de ejecucin

Connect
Descripcin Inicia una sesin en un servidor SQL. Uso en tiempo de ejecucin [formulario.]CrytalReport.Connect[= Name;UserID;Password;DatabaseQualifier$] Por ejemplo:
CrystalReport1.Connect = "DSN = Contabilidad;UID = 734;PWD = grande;DSQ = Administracin"

conecta con la base de datos "Administracin" del servidor "Contabilidad" usando el Id. de usuario 734 y la contrasea "grande". Comentarios Escriba los parmetros necesarios para iniciar una sesin en el servidor SQL que necesita activar para el informe. Los parmetros deben aparecer con el siguiente formato:
DSN = nombre;UID = Idusuario;PWD = contrasea;DSQ = datos calificador base de

nombre es el nombre del servidor. Id. usuario es el nombre que se le ha asignado para iniciar una sesin en el servidor SQL. contrasea es la contrasea que se le ha asignado para iniciar una sesin en el servidor SQL. calificador de base de datos es el nombre de la base de datos si el servidor utiliza el concepto de base de datos. Nota Antes de poder utilizar esta propiedad debe instalar el controlador ODBC para la base de datos SQL que piense utilizar e indicar la ubicacin Database/BIN en la ruta de acceso. Nota Este parmetro slo se requiere cuando sea aplicable al controlador ODBC que est usando. Disponibilidad Tiempo de diseo; tiempo de ejecucin

Crystal Reports para Visual Basic 91

Filename: 86502569.doc Project: Traditional User's Guide Template Template: Author: Kirsten Sutton Last Saved By: Marisa Olivares Revision #: 115 Page: 91 of 60 Printed: 12/27/96 12:20 A12/P12

Captulo 6 El control ActiveX de Crystal

CopiesToPrinter
Descripcin Especifica el nmero de copias que se van a imprimir si imprime en una impresora (si el valor que asigna a la propiedad Destination es 1 - Printer). Uso en tiempo de ejecucin [formulario.]CrystalReport.CopiesToPrinter[= NumCopias%] Por ejemplo:
CrytalReport1.CopiesToPrinter = 3

imprime tres copias del informe especificado. Comentarios El nmero especificado no debe ser cero ni negativo. Disponibilidad Tiempo de diseo; tiempo de ejecucin

DataFiles
Descripcin Especifica la ubicacin de los archivos o tablas de base de datos usados en el informe. Uso en tiempo de ejecucin [formulario.]CrystalReport.DataFiles(ndiceMatriz)[= Ubicacin$] Escriba el nombre y la ruta de acceso a cada archivo o tabla de base de datos del informe para el que quiera cambiar la ubicacin. Use una lnea de cdigo distinta por cada archivo para el que desee cambiar la ubicacin. El orden de los archivos la matriz debe reflejar el orden de los archivos del informe. (Puede usar el comando Establecer ubicacin del men Base de datos para determinar el orden de los archivos en el informe.) El primer archivo del informe es el ndice de matriz (0), el segundo archivo es (1), etc. Por ejemplo, para cambiar la ubicacin del primer y tercer archivos de un informe (primero.dbf y tercero.dbf) al directorio c:\nuevo, use la siguiente sintaxis:
CrystalReport1.DataFiles(0) = "c:\nuevo\primero.dbf" CrystalReport1.DataFiles(2) = "c:\nuevo\tercero.dbf"

Crystal Reports para Visual Basic

Filename: 86502569.doc Project: Traditional User's Guide Template Template: Author: Kirsten Sutton Last Saved By: Marisa Olivares Revision #: 115 Page: 92 of 60 Printed: 12/27/96 12:20 A12/P12

Captulo 6 El control ActiveX de Crystal

Comentarios DataFiles es una propiedad de matriz que slo est disponible en tiempo de ejecucin. Use esta propiedad si desea ejecutar el informe con archivos de diferentes ubicaciones de las especificadas en el informe. Si utiliza esta propiedad, no tiene que cambiar las ubicaciones de todos los archivos del informe. Simplemente asegrese de que el ndice de la matriz para cada archivo que cambie coincida con la posicin de dicho archivo en el informe. Esta propiedad se borra una vez impresa la tarea. Si imprime por segunda vez, el programa vuelve a las ubicaciones que se especificaron inicialmente en el informe. Disponibilidad Tiempo de ejecucin

DataSource
Descripcin Especifica en qu control de datos el buscar los datos el control ActiveX Crystal. Disponibilidad Solo en tiempo de diseo

Destination
Descripcin Especifica el destino en el que se imprimir el informe (Ventana, Impresora o Archivo). Uso en tiempo de ejecucin [formulario.]CrystalReport.Destination[= Destino%] Por ejemplo:
CrystalReport1.Destination = 0

enva el informe especificado a una ventana de impresin. Comentarios Seleccione uno de los siguientes destinos de impresin:
0 1 0 =Window (enva el informe a una ventana de impresin) 1 =Printer (enva el informe a una impresora) crptToWindow crptToPrinter

Crystal Reports para Visual Basic 93

Filename: 86502569.doc Project: Traditional User's Guide Template Template: Author: Kirsten Sutton Last Saved By: Marisa Olivares Revision #: 115 Page: 93 of 60 Printed: 12/27/96 12:20 A12/P12

Captulo 6 El control ActiveX de Crystal

2 =File (imprime el informe a un archivo de disco para su impresin posterior o para importarlo en otras aplicaciones. Si selecciona esta propiedad, tambin tendr que establecer las propiedades PrintFileName y PrintFileType). 3 =MAPI (enva el informe a otra persona de la red local por correo electrnico va MAPI (Microsoft Mail). El informe se anexa a la carta de correo electrnico en el formato especificado por la propiedad PrintFileType).

crptToFile

crptMapi

Disponibilidad Tiempo de diseo; tiempo de ejecucin

DetailCopies
Descripcin Especifica el nmero de copias de cada registro de la seccin Detalles que imprimir el programa. Uso en tiempo de ejecucin [formulario.]CrystalReport.DetailCopies[= NmCopias%] Por ejemplo:
CrystalReport1.DetailCopies = 3

Especifica que se impriman tres (3) copias de cada registro en la seccin Detalles. Comentarios Si DetailCopies se establece a un valor menor o igual a cero, el valor se paso por alto y se imprime una copia de la seccin Detalles del informe. Disponibilidad Lectura y escritura (tiempo de diseo y de ejecucin)

DiscardSavedData
Descripcin Si los datos se guardan con el informe especificado, establecer esta propiedad a 1 (True) descarta los datos. Uso en tiempo de ejecucin [formulario.]CrystalReport.DiscardSavedData[= TrueFalse%] Por ejemplo:
CrystalReport1.DiscardSavedData = 1

Descarta los datos guardados con el informe especificado.

Crystal Reports para Visual Basic

Filename: 86502569.doc Project: Traditional User's Guide Template Template: Author: Kirsten Sutton Last Saved By: Marisa Olivares Revision #: 115 Page: 94 of 60 Printed: 12/27/96 12:20 A12/P12

Captulo 6 El control ActiveX de Crystal

Comentarios Para TrueFalse% use uno de los siguientes valores: False = 0, True = 1. Disponibilidad Lectura y escritura (tiempo de diseo y de ejecucin)

EMailCCList
Descripcin Especifica la lista "CC" a la que desea enviar el mensaje de correo electrnico. Uso en tiempo de ejecucin [formulario.]CrystalReport.EMailCCList [= ListaCC$] Por ejemplo:
CrystalReport1.EMailCCList = "Juana Bravo;Jess Daz "

Enva una Copia del mensaje de correo electrnico a Juana Bravo y a Jess Daz Comentarios Aplicable a MAPI. Los nombres mltiples deben separarse por signos de punto y coma. Disponibilidad Lectura y escritura (tiempo de diseo y de ejecucin)

EMailMessage
Descripcin Especifica la cadena que desea que aparezca como el cuerpo del mensaje de correo electrnico. Uso en tiempo de ejecucin [formulario.]CrystalReport.EMailMessage[=Mensaje$] Por ejemplo:
CrystalReport1.EMailMessage = "La reunin es a las 4:00"

Establece "La reunin es a las 4:00" como cuerpo del mensaje de correo electrnico. Comentarios Aplicable a MAPI. Disponibilidad Lectura y escritura (tiempo de diseo y de ejecucin)

EMailSubject
Descripcin Especifica la lnea de asunto del mensaje de correo electrnico. Uso en tiempo de ejecucin [formulario.]CrystalReport.EMailSubject[= Asunto$]
Crystal Reports para Visual Basic 95

Filename: 86502569.doc Project: Traditional User's Guide Template Template: Author: Kirsten Sutton Last Saved By: Marisa Olivares Revision #: 115 Page: 95 of 60 Printed: 12/27/96 12:20 A12/P12

Captulo 6 El control ActiveX de Crystal

Por ejemplo:
CrystalReport1.EMailSubject = "Reunin del personal "

Establece "Reunin del personal " como la lnea de asunto de un mensaje de correo electrnico. Comentarios Aplicable a MAPI. Disponibilidad Lectura y escritura (tiempo de diseo y de ejecucin)

EMailToList
Descripcin Especifica la lista "A" a la que desee enviar el mensaje de correo electrnico. Uso en tiempo de ejecucin [formulario.]CrystalReport.EMailToList [=ListaA$] Por ejemplo:
CrystalReport1.EMailToList = "Jess Daz "

Establece "Jess Daz " como nico nombre de la lista "A". Comentarios Aplicable a MAPI. Varios nombres deben separarse por signos de punto y coma. Disponibilidad Lectura y escritura (tiempo de diseo y de ejecucin)

Formulas
Descripcin Especifica una nueva cadena para una frmula existente. Uso en tiempo de ejecucin [formulario.]CrystalReport.Formulas(ndiceMatriz)[= "NombreFrmula= TextoFrmula"] Escriba el nombre de la frmula y la cadena que quiera que sustituya a la existente para cada frmula del informe que desee cambiar. Por ejemplo, para cambiar una frmula @COMISIN a {archivo.VENTAS}*.1, y una segunda frmula @TOTAL a {archivo.VENTAS} + {archivo.COMISIN}, escriba lo siguiente:
CrystalReport1.Formulas(0) = "COMISIN= {archivo.VENTAS} * .1" CrystalReport1.Formulas(1) = "TOTAL= {archivo.VENTAS} + {archivo.COMISIN}"

Crystal Reports para Visual Basic

Filename: 86502569.doc Project: Traditional User's Guide Template Template: Author: Kirsten Sutton Last Saved By: Marisa Olivares Revision #: 115 Page: 96 of 60 Printed: 12/27/96 12:20 A12/P12

Captulo 6 El control ActiveX de Crystal

Comentarios Formulas es una propiedad de matriz que slo est disponible en tiempo de ejecucin. Use una lnea de cdigo distinta para cada frmula que desee cambiar. Cambie slo aquellas frmulas que quiera cambiar. La primera frmula que cambie debe asignarse al ndice (0) de la matriz, la segunda debe asignarse al ndice (1), etc. La nueva cadena de frmula debe cumplir los requisitos sintcticos de Crystal Reports. Esta propiedad se borra una vez impresa la tarea. Si imprime por segunda vez, el programa vuelve a las frmulas segn se especificaron originalmente en el informe. Nota Los espacios en blanco son significativos en los nombres de frmulas. Por esta razn, el signo igual debe seguir al nombre de la frmula sin espacio entre ellos. Nota El signo @ no se usa cuando se designa un nombre de frmula en esta propiedad. Nota Esta propiedad no puede utilizarse para crear nuevas frmulas. Slo pueden cambiarse frmulas existentes. Disponibilidad Tiempo de ejecucin (lectura y escritura)

GraphData
Descripcin Obtiene y establece los datos usados un grfico especificado. Uso en tiempo de ejecucin [formulario.]CrystalReport.GraphData(ndiceMatriz%)[= CdigoSeccin; NmeroGrfico; fila; columna; campo; direccin$] Por ejemplo:
CrystalReport1.GraphData(0)= "DETAIL; 1; GROUP1; GROUP2; 0;COLANDROW"

El valor de Group 1 se usa para las lneas del grfico, el valor de Group 2 se usa para las columnas, el primer campo de resumen agregado al informe se usa para establecer el valor de la elevacin del grfico, y los valores de columnas y filas se usan para crear el grfico.

Crystal Reports para Visual Basic 97

Filename: 86502569.doc Project: Traditional User's Guide Template Template: Author: Kirsten Sutton Last Saved By: Marisa Olivares Revision #: 115 Page: 97 of 60 Printed: 12/27/96 12:20 A12/P12

Captulo 6 El control ActiveX de Crystal

Comentarios Con GraphData puede especificar cambios a uno o ms grficos en tiempo de ejecucin. Dichos cambios tienen lugar de forma secuencial cuando se realice la llamada "Action=1". El valor de ndice de la matriz para GraphData especifica simplemente el nmero de orden para los cambios. As:
CrystalReport1.GraphData(0) = "DETAIL; 3; Group1; Group2;666; COLANDROW"

cuando se hagan cambios a un nico grfico, pero


CrystalReport1.GraphData(0) = "HEADER; 3; Group1; Group2;666; COLANDROW" CrystalReport1.GraphData(1) = "DETAIL; 3; Group1; Group2;666; COLANDROW"

cuando se realicen cambios a ms de un grfico. Use la siguiente tabla como gua para proporcionar los valores requeridos por esta propiedad:
PARAMETRO sectionCode DESCRIPCION Especifica la seccin en que desea modificar un grfico. El nmero del grfico dentro de la seccin que desea modificar. El nmero de grupo del informe usado para crear filas en el grfico. El nmero de grupo del informe usado para crear columnas del grfico. El campo de resumen que contiene los valores mximos de cada cima del grfico. Si los valores de las filas, las columnas o ambos se usan para crear el grfico. VALOR ESPERADO Consulte la tabla de cdigos de seccin. Los grficos de una seccin se numeran desde cero, de izquierda a derecha y de arriba abajo. GROUP1, GROUP2, GROUP3, . . ., GROUP9 GROUP1, GROUP2, GROUP3, . . ., GROUP9 El primer campo de resumen agregado a un informe se numera como 0, el segundo como 1, etc. ROWS, COLS, ROWANDCOL, o COLANDROW

GraphNum

Row

col

field

direction

Disponibilidad Lectura y escritura|tiempo de ejecucin

Crystal Reports para Visual Basic

Filename: 86502569.doc Project: Traditional User's Guide Template Template: Author: Kirsten Sutton Last Saved By: Marisa Olivares Revision #: 115 Page: 98 of 60 Printed: 12/27/96 12:20 A12/P12

Captulo 6 El control ActiveX de Crystal

GraphOptions
Descripcin Obtiene y establece una serie de opciones para el grfico especificado. Uso en tiempo de ejecucin [formulario.]CrystalReport.GraphOptions(ndiceMatriz%)[= CdigoSeccin; NmeroGrfico; fuente; DireccinBarras;etiquetas;cuadrcula;leyenda;mx;mn$] Por ejemplo:
CrystalReport1.GraphOptions(0) ="FOOTER;0;Arial;H;T;F;X;max;min"

Establece la fuente como Arial, establece barras horizontales, muestra un valor de datos en cada cima (etiquetas = T) y quita las lneas de cuadrcula del primer grfico de la seccin Pie de pgina. Comentarios Con GraphOptions puede especificar cambios a uno o ms grficos en tiempo de ejecucin. Dichos cambios se llevan a cabo de forma secuencial cuando se realiza la llamada "Action=1". El valor de ndice de la matriz para GraphOptions especifica simplemente el nmero de orden para el cambio. As:
CrystalReport1.GraphOptions(0) = "DETAIL; 1; Arial; H; T; F; legend; max; min"

cuando slo se cambia un grfico, pero


CrystalReport1.GraphOptions(0) = " 1; title string; subtitle string; footnote string; series string; group string; x string;y string; z string" CrystalReport1.GraphOptions(1) = " 1; title string; subtitle string; footnote string; series string; group string; x string;y string; z string"

cuando se cambia ms de un grfico. Use el siguiente diagrama como gua para introducir los valores de propiedad requeridos:
PARMETRO sectionCode DESCRIPCIN Especifica la seccin en la que desea modificar un grfico. Especifica qu grfico de la seccin desea modificar. Especifica la fuente para todo el grfico. En un grfico de barras, especifica la direccin en la que desea que aparezcan las barras. VALORES ESPERADOS Consulte la tabla de cdigos de seccin. Los grficos de una seccin se numeran, comenzando por cero, de izquierda a derecha y de arriba abajo. Nombre real de fuente; por ejemplo, Arial H = horizontal, V = vertical, X = como est

GraphNum

FontFace barDirection

Crystal Reports para Visual Basic 99

Filename: 86502569.doc Project: Traditional User's Guide Template Template: Author: Kirsten Sutton Last Saved By: Marisa Olivares Revision #: 115 Page: 99 of 60 Printed: 12/27/96 12:20 A12/P12

Captulo 6 El control ActiveX de Crystal

PARMETRO labelRisers

DESCRIPCIN Especifica si quiere que se muestren los valores de datos de cada cima. Especifica si quiere que se muestren las lneas de la cuadrcula. Especifica si quiere que se muestre una leyenda. Especifica el valor mximo que desea incluir en un grfico. Especifica el valor mnimo que desea incluir en un grfico.

VALORES ESPERADOS T= verdadero, F = Falso, X = como est T= verdadero, F = Falso, X = como est T= verdadero, F = Falso, X = como est Indique un nmero.

gridLines

legend max

Min

Indique un nmero.

Disponibilidad Lectura y escritura|tiempo de ejecucin

GraphText
Descripcin Obtiene y establece los diversos componentes de texto para el grfico especificado. Uso en tiempo de ejecucin [form.]CrystalReport.GraphText(ArrayIndex%)[= sectionCode; graphNum;title; subTitle; footnote; series; group; x; y; z$] Por ejemplo:
CrystalReport1.GraphText(0) = "HEADER; 0;;;;;;new x label;new y label; new z label"

Restablece las etiquetas x, y, y z para el primer grfico de la seccin Encabezado de pgina. Comentarios Seleccione el cdigo de seccin de la tabla de cdigo de secciones. Con GraphText puede especificar cambios a uno o ms grficos en tiempo de ejecucin. Dichos cambios tienen lugar de forma secuencial cuando se realiza la llamada "Action=1". El valor de ndice de la matriz de GraphText simplemente especifica el nmero de orden para los cambios. As:
CrystalReport1.GraphText(0) = "DETAIL; 1; title string;subtitle string; footnote string; series string; group string; x string;y string; z string"

Crystal Reports para Visual Basic

Filename: 86502569.doc Project: Traditional User's Guide Template Template: Author: Kirsten Sutton Last Saved By: Marisa Olivares Revision #: 115 Page: 100 of 60 Printed: 12/27/96 12:20 A12/P12

Captulo 6 El control ActiveX de Crystal

cuando se efectan cambios a un nico grfico, pero


CrystalReport1.GraphText(0) = " 1; title string; subtitle string; footnote string; series string; group string; x string;y string; z string" CrystalReport1.GraphText(1) = " 1; title string; subtitle string; footnote string; series string; group string; x string;y string; z string"

cuando se realizan cambios a ms de un grfico. "title", "subTitle", "footnote", "series", "group", "x","y", y "z" son las cadenas que dese etiquetar para las partes adecuadas del grfico. Disponibilidad Lectura y escritura|tiempo de ejecucin

GraphType
Descripcin Obtiene y establece el tipo de grfico usado en la seccin seleccionada del informe especificado. Uso en tiempo de ejecucin [form.]CrystalReport.GraphType(ArrayIndex%)[= sectionCode;graphNum;graphType$] Por ejemplo:
CrystalReport1.GraphType(0)= "GH1; 0; PIE"

Especifica un grfico circular como el primer grfico (graphNum =0) de la seccin Encabezado de grupo 1 Comentarios Con GraphType puede especificar cambios a uno o ms grficos en tiempo de ejecucin. Dichos cambios tienen lugar secuencialmente cuando se realiza la llamada "Action=1". El valor de ndice de la matriz de GraphType especifica el orden para los cambios. As:
CrystalReport1.GraphType(0) = "DETAIL; 0; PIE"

cuando se realizan cambios a un nico grfico, pero


CrystalReport1.GraphType(0) = "HEADER; 0; PIE" CrystalReport1.GraphType(1) = "DETAIL; 0; PIE"

cuando se realizan cambios a ms de un grfico. Seleccione el cdigo de seccin en la tabla de cdigos de secciones. Los nmeros de grficos comienzan por 0; el primer grfico de una seccin es el nmero 0, el segundo es 1, etc.

Crystal Reports para Visual Basic 101

Filename: 86502569.doc Project: Traditional User's Guide Template Template: Author: Kirsten Sutton Last Saved By: Marisa Olivares Revision #: 115 Page: 101 of 60 Printed: 12/27/96 12:20 A12/P12

Captulo 6 El control ActiveX de Crystal

Cuando hay varios grficos en una seccin se numeran de izquierda a derecha y de arriba abajo. Seleccione de los siguientes tipos de grficos para el valor graphType de esta propiedad:
PARA ESTE TIPO DE GRFICO Lado a lado Columna 3-D Apiladas Apiladas 3-D Porcentaje Porcentaje 3-D Lnea rea Barras 3-D Circular Mltiple Proporcionado USE ESTE CDIGO PARA GRAPHTYPE SIDEBYSIDE 3DSIDE STACKEDBAR 3DSTACKED PERCENTBAR 3DPERCENT LINE AREA 3DBARS PIE MULTIPLEPIE WEIGHTEDPIE

Disponibilidad Lectura y escritura|tiempo de ejecucin

GroupCondition
Descripcin Especifica qu tipo de cambio en el campo de condicin de grupo desencadenar la creacin de un grupo. Uso en tiempo de ejecucin [form.]CrystalReport.GroupCondition(SequentialIndex%)[= group; field; condition; sortDirection$] Por ejemplo:
CrystalReport1.GroupCondition(0)="GROUP1;{header.ordernum};ANYCHANGE;A"

Especifica que cualquier cambio en el campo ordernum de Group1 producir una nueva agrupacin.

Crystal Reports para Visual Basic

Filename: 86502569.doc Project: Traditional User's Guide Template Template: Author: Kirsten Sutton Last Saved By: Marisa Olivares Revision #: 115 Page: 102 of 60 Printed: 12/27/96 12:20 A12/P12

Captulo 6 El control ActiveX de Crystal

Comentarios Consulte las siguientes tablas para valores de parmetros de esta propiedad:
PARMETRO group DESCRIPCIN El grupo en que el que desea establecer la condicin de grupo. El nombre del campo que producir una agrupacin siempre que cambie su valor. Indique la condicin que producir la agrupacin. La direccin en que se ordenarn los grupos. VALORES ESPERADOS El grupo ms externo del informe es GROUP1, el siguiente grupo es GROUP2, etc. Indique el nombre en el siguiente formato: {tabla.campo}

field

condition SortDirection

Consulte las siguientes tablas. A = Ascendente, D = Descendente

Condiciones de campo de fecha


CONDICIN Diario Semanal Quincenal Semi-mensual Mensual Trimestral Semi-anual Anual CDIGO DE CONDICIN DAILY WEEKLY BIWEEKLY SEMIMONTHLY MONTHLY QUARTERLY SEMIANNUALLY ANNUALLY

Condiciones de campo booleano


CONDICIN A s A No Cada Yes Cada No Prximo Yes Prximo No CDIGO DE CONDICIN TOYES TONO EVERYYES EVERYNO NEXTISYES NEXTISNO

Condicin para los dems tipos de datos


CONDICIN Cualquier cambio CDIGO DE CONDICIN ANYCHANGE

Disponibilidad Lectura y escritura|tiempo de ejecucin solamente

Crystal Reports para Visual Basic 103

Filename: 86502569.doc Project: Traditional User's Guide Template Template: Author: Kirsten Sutton Last Saved By: Marisa Olivares Revision #: 115 Page: 103 of 60 Printed: 12/27/96 12:20 A12/P12

Captulo 6 El control ActiveX de Crystal

GroupSelectionFormula
Descripcin Especifica los grupos que se van a utilizar cuando se imprima el informe. Uso en tiempo de ejecucin [form.]CrystalReport.GroupSelectionFormula[= "GroupSelectionFormula"] Escriba la frmula de seleccin de grupo como si le introdujera en el Editor de frmulas. Por ejemplo, para limitar el informe a aquellos grupos que tengan un subtotal en el campo header.AMOUNT menor que $10.000 (con subtotales producidos por cambios en el campo header.CUSTNUMB), debe introducir lo siguiente como frmula de seleccin de grupo:
CrystalReport1.GroupSelectionFormula = Sum ( {header.AMOUNT}, {header.CustNumb}) < 10000

Comentarios Si la frmula de seleccin de grupo incluye comillas internas, cambie todas las dobles comillas internas a comillas simples y encierre la frmula de seleccin de grupo entre dobles comillas. Nota Si ha creado una frmula de seleccin de grupo en tiempo de diseo, cualquier frmula de seleccin de grupo que indique aqu se agregar a dicha frmula de seleccin de grupo, conectada por "and". As, los registros se seleccionarn segn una combinacin de las dos frmulas. Disponibilidad Tiempo de diseo; tiempo de ejecucin

GroupSortFields
Descripcin Especifica el o los campos de grupo que se usarn para ordenar los datos cuando se imprima el informe. Uso en tiempo de ejecucin [form.]CrystalReport.GroupSortFields(ArrayIndex)[= "{+|-}GroupField"] Escriba el o los campos de grupo por los que desee ordenar el informe. Por ejemplo, suponga que ha separado los datos en grupos de estado y Crystal Reports ha contado el nmero de clientes de cada grupo. Para imprimir el grupo con el mayor contador primero y despus con el siguiente contador, etc. (orden descendente), especifique una cadena de caracteres similar a la siguiente:
CrystalReport1.GroupSortFields(0) = "-Count({customer.CUSTOMER}, {customer.STATE})"

Crystal Reports para Visual Basic

Filename: 86502569.doc Project: Traditional User's Guide Template Template: Author: Kirsten Sutton Last Saved By: Marisa Olivares Revision #: 115 Page: 104 of 60 Printed: 12/27/96 12:20 A12/P12

Captulo 6 El control ActiveX de Crystal

Comentarios GroupSortFields es una propiedad de matriz slo disponible en tiempo de ejecucin. Use una lnea de cdigo distinta para especificar cada campo de orden de grupo. Introduzca los campos de ordenacin en el orden en que desee ordenarlos en el informe. Por ejemplo, si primero quiere ordenar el informe segn el campo de ordenacin de grupo A y despus segn el campo B, especifique el campo de ordenacin A en la primera lnea de cdigo y el campo B en la segunda lnea de cdigo. Al primer campo de ordenacin de grupo que especifique debe asignarse el ndice de matriz 0, al segundo campo de ordenacin de grupo debe asignarse el ndice de matriz 1, etc. Los valores de ndice asignados deben ser continuos; no se admiten saltos (0,1,2 = correcto, 0,1,3 = incorrecto) Los valores de ndices de matriz deben ser subndices en el cdigo inmediatamente despus del nombre de la propiedad; por ejemplo, CrystalReport1.GroupSortFields(0) =. Si ha especificado campos de ordenacin para el informe en tiempo de diseo, los campos de ordenacin introducidos aqu sustituirn a los campos de ordenacin del informe. Si no usa esta propiedad, el programa usar las instrucciones de ordenacin que se especificaron en el informe. Si desea borrar los campos de ordenacin de grupo del informe, use una cadena vaca (CrystalReport1.GroupSortFields(0) = "") Esta propiedad se borra cuando se imprime la tarea. Si se imprime una segunda vez, el programa restablece los campos de ordenacin de grupo especificados originalmente en el informe. Nota La entrada del campo de ordenacin de grupo debe ir seguida del signo de direccin (+ o -) sin espacios. Nota Para encontrar la sintaxis correcta para cualquier grupo del informe usando Crystal Reports para Visual Basic: seleccione Insertar|Campo de frmula, escriba cualquier nombre de frmula en el cuadro de dilogo Insertar frmula cuando aparezca, haga clic en el botn de desplazamiento de la lista Campos en el de frmulas Editor cuando aparezca, y haga doble clic en el campo de grupo que desee. Crystal Reports escribe el nombre del campo de grupo en el cuadro Texto de frmula. Use el nombre y la sintaxis de dicho

Crystal Reports para Visual Basic 105

Filename: 86502569.doc Project: Traditional User's Guide Template Template: Author: Kirsten Sutton Last Saved By: Marisa Olivares Revision #: 115 Page: 105 of 60 Printed: 12/27/96 12:20 A12/P12

Captulo 6 El control ActiveX de Crystal

cuadro de texto cuando construya la cadena del campo de ordenacin de grupo.

Crystal Reports para Visual Basic

Filename: 86502569.doc Project: Traditional User's Guide Template Template: Author: Kirsten Sutton Last Saved By: Marisa Olivares Revision #: 115 Page: 106 of 60 Printed: 12/27/96 12:20 A12/P12

Captulo 6 El control ActiveX de Crystal

Disponibilidad Tiempo de ejecucin

LastErrorNumber
Descripcin Devuelve el cdigo de error del ltimo error de ejecucin. Uso en tiempo de ejecucin [form.]CrystalReport.LastErrorNumber Por ejemplo:
' Si ocurre un error, ir a ErrorHandler ErrorHandler:MsgBox CrystalReport1.LastErrorNumber

si se produce un error, este cdigo invoca un cuadro de mensajes que muestra el nmero del error. Comentarios LastErrorNumber es una propiedad slo de tiempo de ejecucin. Nota LastErrorNumber debe aparecer despus de la llamada a Action para mostrar los valores relevantes. Despus de imprimir el informe, puede consultar esta propiedad para obtener un nmero de error (si lo hubiera). Si no hubo ningn error en la impresin, LastErrorNumber = 0. Disponibilidad Tiempo de ejecucin (lectura y escritura)

LastErrorString
Descripcin Devuelve la cadena de error del ltimo error de ejecucin. Uso en tiempo de ejecucin [form.]CrystalReport.LastErrorString Por ejemplo:
'Si ocurre un error, ir a ErrorHandler ErrorHandler:MsgBox CrystalReport1.LastErrorString

si se produce un error, este cdigo invoca un cuadro de mensajes que muestra la cadena del error. Comentarios LastErrorString es una propiedad slo en tiempo de ejecucin. Nota LastErrorString debe aparecer despus de la llamada a Action para que muestre valores relevantes. Tras imprimir el informe, puede consultar esta propiedad para obtener una cadena de error (si la hay). Si no se produjo ningn error en la impresin, LastErrorNumber = 0.

Crystal Reports para Visual Basic 107

Filename: 86502569.doc Project: Traditional User's Guide Template Template: Author: Kirsten Sutton Last Saved By: Marisa Olivares Revision #: 115 Page: 107 of 60 Printed: 12/27/96 12:20 A12/P12

Captulo 6 El control ActiveX de Crystal

Disponibilidad Tiempo de ejecucin (lectura y escritura)

Crystal Reports para Visual Basic

Filename: 86502569.doc Project: Traditional User's Guide Template Template: Author: Kirsten Sutton Last Saved By: Marisa Olivares Revision #: 115 Page: 108 of 60 Printed: 12/27/96 12:20 A12/P12

Captulo 6 El control ActiveX de Crystal

MarginBottom
Descripcin Obtiene y establece el margen inferior para el informe especificado. Uso en tiempo de ejecucin [form.]CrystalReport.MarginBottom[=MarginSetting%] Por ejemplo:
CrystalReport1.MarginBottom = 720

Establece un margen inferior de 1/2 pulgada para el informe (1 pulgada = 1440 twips) Comentarios MarginSetting% es el margen deseado, en twips. Disponibilidad Lectura y escritura (tiempo de diseo y de ejecucin)

MarginLeft
Descripcin Obtiene y establece el margen izquierdo para el informe especificado. Uso en tiempo de ejecucin [form.] CrystalReport.MarginLeft[=MarginSetting%] Por ejemplo:
CrystalReport1.MarginLeft = 1440

Establece un margen izquierdo de 1 pulgada para el informe (1 pulgada = 1440 twips) Comentarios MarginSetting% es el margen deseado, en twips. Disponibilidad Lectura y escritura (tiempo de diseo y de ejecucin)

MarginRight
Descripcin Obtiene y establece el margen derecho para el informe especificado. Uso en tiempo de ejecucin [form.]CrystalReport.MarginRight[=MarginSetting%] Por ejemplo:
CrystalReport1.MarginRight=1440

Establece un margen derecho de 1 pulgada para el informe (1 pulgada = 1440 twips)

Crystal Reports para Visual Basic 109

Filename: 86502569.doc Project: Traditional User's Guide Template Template: Author: Kirsten Sutton Last Saved By: Marisa Olivares Revision #: 115 Page: 109 of 60 Printed: 12/27/96 12:20 A12/P12

Captulo 6 El control ActiveX de Crystal

Comentarios MarginSetting% es el margen deseado, en twips. Disponibilidad Lectura y escritura (tiempo de diseo y de ejecucin)

MarginTop
Descripcin Obtiene y establece el margen superior para el informe especificado. Uso en tiempo de ejecucin [form.]CrystalReport.MarginTop[=MarginSetting%] Por ejemplo:
CrystalReport1.MarginTop = 720

Establece un margen superior de 1/2 pulgada para el informe (1 pulgada = 1440 twips) Comentarios MarginSetting% es el margen deseado, en twips. Disponibilidad Lectura y escritura (tiempo de diseo y de ejecucin)

Password
Descripcin Introduce la contrasea necesaria para usar las tablas de la base de datos en un archivo .mdb restringido de Access. Uso en tiempo de ejecucin [form.]CrystalReport.Password[= Password$] Por ejemplo:
CrystalReport1.Password = "lluvia"

introduce la contrasea "lluvia". Comentarios Escriba la contrasea que ha asignado. Disponibilidad Tiempo de diseo; tiempo de ejecucin

PrintDay
Descripcin Obtiene y establece el componente da de la fecha de impresin (si es distinta de la fecha real en que se imprime el informe). Uso en tiempo de ejecucin [form.]CrystalReport.PrintDay[=Day%]

Crystal Reports para Visual Basic

Filename: 86502569.doc Project: Traditional User's Guide Template Template: Author: Kirsten Sutton Last Saved By: Marisa Olivares Revision #: 115 Page: 110 of 60 Printed: 12/27/96 12:20 A12/P12

Captulo 6 El control ActiveX de Crystal

Por ejemplo:
CrystalReport1.PrintDay = 23

Establece 23 como da de impresin. Comentarios Escriba un valor entre 1 y 31 Las propiedades PrintYear, PrintMonth y PrintDay funcionan juntas. Debe cambiar el valor de las tres para cambiar la fecha de impresin. Si no cambia las tres, se usa la fecha de impresin guardada con el informe. Puede ser la fecha actual si no se guard una fecha especfica con el informe. Disponibilidad Lectura y escritura (tiempo de diseo y de ejecucin)

PrinterCollation
Descripcin Si especifica ms de una copia para imprimir (mediante la propiedad PrinterCopies), PrinterCollation especifica si las copias se intercalarn o no. Uso en tiempo de ejecucin [form.]CrystalReport.PrinterCollation[=CollationCode%] Por ejemplo:
CrystalReport1.PrinterCollation = 1

Intercala las copias del informe especificado. Comentarios Seleccione el valor de CollationCode% de la siguiente tabla:
ESTADO Uncollated Collated Default Collation CDIGO 0 1 2 CONSTANTES crptUncollated crptCollated crptDefault

Disponibilidad Lectura y escritura (tiempo de diseo y de ejecucin)

PrinterCopies
Descripcin Obtiene y establece el nmero de copias del informe a imprimir. Uso en tiempo de ejecucin [form.]CrystalReport.PrinterCopies[=NumCopies%] Por ejemplo:
CrystalReport1.PrinterCopies = 3

Especifica que el programa imprimir tres (3) copias del informe.


Crystal Reports para Visual Basic 111

Filename: 86502569.doc Project: Traditional User's Guide Template Template: Author: Kirsten Sutton Last Saved By: Marisa Olivares Revision #: 115 Page: 111 of 60 Printed: 12/27/96 12:20 A12/P12

Captulo 6 El control ActiveX de Crystal

Comentarios El nmero utilizado para PrinterCopies no debe ser cero ni negativo. Disponibilidad Lectura y escritura (tiempo de diseo y de ejecucin)

PrinterDriver
Descripcin Obtiene y establece el nombre del controlador de impresora que imprimir el informe. Uso en tiempo de ejecucin [form.]CrystalReport.PrinterDriver[= DriverName$] Por ejemplo:
CrystalReport1.PrinterDriver = "Epson24.drv"

Establece que el controlador de impresora sea el Epson 24. Comentarios Las propiedades PrinterDriver, PrinterName y PrinterPort funcionan conjuntamente para definir la impresora a la que se enviar el informe. Las tres propiedades deben establecerse para definir una nueva impresora. Si no se establecen las tres propiedades, se usar la impresora definida en el informe. Puede ser la impresora predeterminada del usuario si no se especific ninguna en el informe. Disponibilidad Lectura y escritura (tiempo de diseo y de ejecucin)

PrinterName
Descripcin Obtiene y establece el nombre de la impresora que imprimir el informe. Uso en tiempo de ejecucin [form.]CrystalReport.PrinterName[= PrinterName$] Por ejemplo:
CrystalReport1.PrinterName= "Epson LQ-850"

Especifica la impresora Epson LQ-850 Comentarios Las propiedades PrinterDriver, PrinterName y PrinterPort funcionan conjuntamente para definir la impresora a la que se enviar el informe. Las tres propiedades deben establecerse para definir una nueva impresora. Si no se establecen las tres propiedades, se usar la impresora definida en el informe. Puede ser la impresora predeterminada del usuario si no se especific ninguna en el informe.

Crystal Reports para Visual Basic

Filename: 86502569.doc Project: Traditional User's Guide Template Template: Author: Kirsten Sutton Last Saved By: Marisa Olivares Revision #: 115 Page: 112 of 60 Printed: 12/27/96 12:20 A12/P12

Captulo 6 El control ActiveX de Crystal

Disponibilidad Lectura y escritura (tiempo de diseo y de ejecucin)

PrinterPort
Descripcin Obtiene y establece el nombre del puerto para la impresora especificada. Uso en tiempo de ejecucin [form.]CrystalReport.PrinterPort[= PortName$] Por ejemplo:
CrystalReport1.PrinterPort= "LPT1"

Establece el puerto de la impresora como LPT1 Comentarios Las propiedades PrinterDriver, PrinterName y PrinterPort funcionan conjuntamente para definir la impresora a la que se enviar el informe. Las tres propiedades deben establecerse para definir una nueva impresora. Si no se establecen las tres propiedades, se usar la impresora definida en el informe. Puede ser la impresora predeterminada del usuario si no se especific ninguna en el informe. Disponibilidad Lectura y escritura (tiempo de diseo y de ejecucin)

PrinterStartPage
Descripcin Obtiene y establece la primera pgina que se va a imprimir. Uso en tiempo de ejecucin [form.]CrystalReport.PrinterStartPage[= StartPage%] Por ejemplo:
CrystalReport1.PrinterStartPage = 7

Especifica que la impresin comenzar con la pgina 7 del informe. Comentarios Si se usa un valor menor o igual que 0 para PrinterStartPage, el valor se pasa por alto y la impresin comienza con la pgina 1. Disponibilidad Lectura y escritura (tiempo de diseo y de ejecucin)

PrinterStopPage
Descripcin Obtiene y establece la ltima pgina que se va a imprimir. Uso en tiempo de ejecucin [form.]CrystalReport.PrinterStopPage[=StopPage%]

Crystal Reports para Visual Basic 113

Filename: 86502569.doc Project: Traditional User's Guide Template Template: Author: Kirsten Sutton Last Saved By: Marisa Olivares Revision #: 115 Page: 113 of 60 Printed: 12/27/96 12:20 A12/P12

Captulo 6 El control ActiveX de Crystal

Por ejemplo:
CrystalReport1.PrinterStopPage = 12

Especifica que la impresin finalice con la pgina 12 del informe. Comentarios Use un valor -1 para PrinterStopPage con el fin de indicar que la impresin contine hasta la ltima pgina. Disponibilidad Lectura y escritura (tiempo de diseo y de ejecucin)

PrintFileCharSepQuote
Descripcin Obtiene y establece el carcter de comillas para encerrar datos de campos alfanumricos cuando se imprime a un archivo con el formato Separado por caracteres. Uso en tiempo de ejecucin [form.]CrystalReport.PrintFileCharSepQuote[=Quote$] Por ejemplo:
CrystalReport1.PrintFileCharSepQuote = " ' "

Usa el carcter de separacin ' para encerrar valores guardados en formato separados por caracteres. Comentarios Aplicable slo cuando PrintFileType es 5 - Valores separados por caracteres. Aplicable slo cuando Destination es 2 - Archivo, 3 - Correo electrnico va MAPI. Si se asigna una cadena a PrintFileCharSepQuote de ms de un carcter, el VBX slo emplea el primer carcter de dicha cadena. Por ejemplo, si asigna "quote" a la propiedad, el VBX slo reconocer "q". Disponibilidad Lectura y escritura (tiempo de diseo y de ejecucin)

PrintFileCharSepSeparator
Descripcin Obtiene y establece el o los caracteres que desea usar para separar los campos cuando se imprime a un archivo con el formato Valor separador por caracteres. Uso en tiempo de ejecucin [form.]CrystalReport.PrintFileCharSepSeparator[=Separator$] Por ejemplo:
CrystalReport1.PrintFileCharSepSeparator= "@"

Especifica que el carcter "@" se usar para separar valores de campos.

Crystal Reports para Visual Basic

Filename: 86502569.doc Project: Traditional User's Guide Template Template: Author: Kirsten Sutton Last Saved By: Marisa Olivares Revision #: 115 Page: 114 of 60 Printed: 12/27/96 12:20 A12/P12

Captulo 6 El control ActiveX de Crystal

Comentarios Aplicable slo cuando PrintFileType es 5 - Valores separados por caracteres. Aplicable slo cuando Destination es 2 - Archivo, 3 - Correo electrnico va MAPI. Disponibilidad Lectura y escritura (tiempo de diseo y de ejecucin)

PrintFileName
Descripcin Especifica el nombre del archivo en el que se imprimir el informe. Uso en tiempo de ejecucin [form.]CrystalReport.PrintFileName[= FileName$] Por ejemplo:
CrystalReport1.PrintFileName ="c:\crw\cust_rpt.txt"

Imprime el informe en un archivo llamado "cust_rpt.txt" del directorio c:\crw. Comentarios Puede hacer doble clic en esta propiedad o en el botn con tres puntos del cuadro de dilogo Configuracin para invocar el cuadro de dilogo Elegir nombre de archivo de impresin. En dicho cuadro de dilogo, seleccione el nombre y la ruta de acceso del archivo en el que desee imprimir el informe. Seleccione un valor para esta propiedad slo si va a imprimir en un archivo (si el valor asignado a la propiedad Destination es 2 - Archivo). Nota Si quiere especificar PrintFileName en tiempo de ejecucin, asegrese que lo encierra entre comillas en el cdigo. Disponibilidad Tiempo de diseo; tiempo de ejecucin

PrintFileType
Descripcin Especifica el tipo del archivo de impresin cuando se imprima un informe a un archivo. Uso en tiempo de ejecucin [form.]CrystalReport.PrintFileType[= FileType%] Por ejemplo:
CrystalReport1.PrintFileType = 1

Imprime el informe en un archivo en formato separado por tabuladores.

Crystal Reports para Visual Basic 115

Filename: 86502569.doc Project: Traditional User's Guide Template Template: Author: Kirsten Sutton Last Saved By: Marisa Olivares Revision #: 115 Page: 115 of 60 Printed: 12/27/96 12:20 A12/P12

Captulo 6 El control ActiveX de Crystal

Comentarios Seleccione uno de los siguientes tipos de archivo de impresin si va a imprimir en un archivo (si el valor asignado a la propiedad Destination es 2 - file).
0 - Record Estilo de registro (columnas de valores). No utiliza comas o separadores. Cada registro tiene un ancho de campo fijo. Valores separador por tabuladores. Presenta los datos en forma tabular. Encierra los datos de campos alfanumricos entre comillas y separa los campos con tabuladores. Estilo texto. Guarda los datos en formato de texto ASCII con todos los valores separados por espacios en blanco. Este estilo es ms similar a la pgina impresa. Guarda los datos en formato DIF (formato de intercambio de datos). Este formato se suele utilizar para la transferencia de datos entre diferentes programas de hoja de clculo. Valores separados por comas. Encierra los datos de campos alfanumricos entre comillas y separa los campos con comas. Guarda los datos en formato de texto ASCII con todos los valores separados por tabuladores. Guarda los datos como valores separados por caracteres en formato de texto ASCII. Todos los valores se separan por un carcter o caracteres especificados por la propiedad PrintFileCharSepSeparator. crptRecord

1 - Tab separated

crptTabSep

2 - Text

crptText

3 - DIF

crptDIF

4 - CSV

crptCSV

5 - Character Separated

crptCharSep

6 - Tab separated Text

crptTabSepText

Crystal Reports para Visual Basic

Filename: 86502569.doc Project: Traditional User's Guide Template Template: Author: Kirsten Sutton Last Saved By: Marisa Olivares Revision #: 115 Page: 116 of 60 Printed: 12/27/96 12:20 A12/P12

Captulo 6 El control ActiveX de Crystal

7 - Crystal Reports RPT

Se usa el formato RPT estndar de Crystal Reports. Ms frecuente para enviar el informe a otro usuario por correo electrnico. Exporta el informe como una hoja de clculo de Microsoft Excel 2.1. Exporta el informe como una hoja de clculo de Microsoft Excel 3.0. Exporta el informe como una hoja de clculo de Microsoft Excel 4.0. Exporta el informe como formato WK1 de hoja de clculo de Lotus 1-2-3. Exporta el informe como formato WK3 de hoja de clculo de Lotus 1-2-3. Exporta el informe como formato WKS de hoja de clculo de Lotus 1-2-3. Guarda los datos en formato de texto enriquecido. Usa el formato de Microsoft Word para Windows para guardar los datos del informe. Exporta el informe como una hoja de clculo de Microsoft Excel 5.0. Exporta el informe en formato HTML. Exporta el informe en formato Internet Explorer. Exporta el informe en formato Netscape.

crptCrystal

8 - Excel 2.1 XLS

crptExcel21

9 - Excel 3.0 XLS

crptExcel30

10 - Excel 4.0 XLS

crptExcel40

11 - Lotus 1-2-3 WK1

crpt123wk1

12 - Lotus 1-2-3 WK3

crpt123wk3

13 - Lotus 1-2-3 WKS

crpt123wks

15 - RTF 17 - Word for Windows

crptRTF crptWinWord

19 - Excel 5.0 XLS

crptExcel50

20 - HTML 3.0 21 - Internet Expl 22 - Netscape

crptHTML30 crptIntExpl crptNetscape

Disponibilidad Tiempo de diseo; tiempo de ejecucin

Crystal Reports para Visual Basic 117

Filename: 86502569.doc Project: Traditional User's Guide Template Template: Author: Kirsten Sutton Last Saved By: Marisa Olivares Revision #: 115 Page: 117 of 60 Printed: 12/27/96 12:20 A12/P12

Captulo 6 El control ActiveX de Crystal

PrintFileUseRptDateFmt
Descripcin Cuando se imprime en un archivo, indica si el programa debe guardar las fechas en el mismo formato de fecha (MDA, DMA, etc.) que el utilizado en el informe o bien optimizar las fechas para el formato de archivo seleccionado. Uso en tiempo de ejecucin [form.]CrystalReport.PrintFileUseRptDateFmt[= TrueFalse%] Por ejemplo:
CrystalReport1.PrintFileUseRptDateFmt = 1

Especifica que el programa debe imprimir las fechas en el mismo formato que el empleado en el informe. Comentarios Aplicable slo cuando PrintFileType es 0 - Registro, 1 - Separado por tabuladores, 3 - Formato de intercambio de datos (DIF), 4 - CSV o 5 Separado por caracteres. Aplicable slo cuando Destination es 2 - Archivo, 3 - Correo electrnico va MAPI. Para TrueFalse%, use uno de los siguientes valores: False = 0, True = 1. Disponibilidad Lectura y escritura (tiempo de diseo y de ejecucin)

PrintFileUseRptNumberFmt
Descripcin Cuando se imprime en un archivo, indica si el programa debe imprimir nmeros en el mismo formato (decimales, negativos, etc.) que se ha usado en el informe o bien optimizar los nmeros para el formato de archivo seleccionado. Uso en tiempo de ejecucin [form.]CrystalReport.PrintFileUseRptNumberFmt[=TrueFalse%] Por ejemplo:
CrystalReport1.PrintFileUseRptNumberFmt = 1

Especifica que el programa debe imprimir los nmeros en el mismo formato que el empleado en el informe.

Crystal Reports para Visual Basic

Filename: 86502569.doc Project: Traditional User's Guide Template Template: Author: Kirsten Sutton Last Saved By: Marisa Olivares Revision #: 115 Page: 118 of 60 Printed: 12/27/96 12:20 A12/P12

Captulo 6 El control ActiveX de Crystal

Comentarios Aplicable slo cuando PrintFileType es 0 - Registro, 1 - Separado por tabuladores, 3 - Formato de intercambio de datos (DIF), 4 - CSV o 5 Separado por caracteres Aplicable slo cuando Destination es 2 - Archivo, 3 - Correo electrnico va MAPI. Para TrueFalse%, use uno de los siguientes valores: False = 0, True = 1. Disponibilidad Lectura y escritura (tiempo de diseo y de ejecucin)

PrintMonth
Descripcin Obtiene y establece el componente mes de la fecha de impresin (si es diferente de la fecha real de impresin del informe). Uso en tiempo de ejecucin [form.]CrystalReport.PrintMonth[= Month%] Por ejemplo:
CrystalReport1.PrintMonth= 7

Establece Julio como el mes de impresin. Comentarios Indique un valor entre 1-12 con Enero = 1, Diciembre = 12. Las propiedades PrintYear, PrintMonth y PrintDay funcionan conjuntamente. Debe cambiar el valor de las tres para cambiar la fecha de impresin. Si no cambia las tres, se usar la fecha de impresin guardada con el informe. Puede ser la fecha actual si no se guard una fecha especfica con el informe. Disponibilidad Lectura y escritura (tiempo de diseo y de ejecucin)

PrintYear
Descripcin Obtiene y establece el componente ao de la fecha de impresin (si es diferente de la fecha real de impresin del informe). Uso en tiempo de ejecucin [form.]CrystalReport.PrintYear[=Year%] Por ejemplo:
CrystalReport1.PrintYear = 1994

Establece el componente ao de la fecha de impresin como 1994.

Crystal Reports para Visual Basic 119

Filename: 86502569.doc Project: Traditional User's Guide Template Template: Author: Kirsten Sutton Last Saved By: Marisa Olivares Revision #: 115 Page: 119 of 60 Printed: 12/27/96 12:20 A12/P12

Captulo 6 El control ActiveX de Crystal

Comentarios Indique el ao de impresin como un nmero de cuatro dgitos. Las propiedades PrintYear, PrintMonth y PrintDay funcionan conjuntamente. Debe cambiar el valor de las tres para cambiar la fecha de impresin. Si no cambia las tres, se usar la fecha de impresin guardada con el informe. Puede ser la fecha actual si no se guard una fecha especfica con el informe. Disponibilidad Lectura y escritura (tiempo de diseo y de ejecucin)

RecordsPrinted
Descripcin Determina el nmero de registros impresos realmente. Uso en tiempo de ejecucin [form.]CrystalReport.RecordsPrinted Por ejemplo:
Printed& = CrystalReport1.RecordsPrinted

Recupera el nmero de registros impresos y lo almacena en la variable Printed. Comentarios Si el informe que se est imprimiendo contiene una o ms frmulas de seleccin de grupos, el valor retornado por RecordsPrinted puede ser mucho menor que el valor retornado por RecordsSelected. De lo contrario, este valor debe ser igual que RecordsSelected. Disponibilidad Slo lectura|tiempo de ejecucin

RecordsRead
Descripcin Determina el nmero de registros procesados realmente. Uso en tiempo de ejecucin [form.]CrystalReport.RecordsRead Por ejemplo:
Read% = CrystalReport1.RecordsRead

Recupera el nmero de registros ledos y lo guarda en la variable Read. Comentarios Si el motor de impresin de Crystal Reports genera una consulta SQL para obtener los datos desde una base de datos SQL cuando se imprime el informe, RecordsRead slo recuperar el nmero de registros recibidos por el motor de impresin desde la consulta. Este valor puede ser mucho menor que el nmero de registros reales de la tabla de la base de datos SQL.

Crystal Reports para Visual Basic

Filename: 86502569.doc Project: Traditional User's Guide Template Template: Author: Kirsten Sutton Last Saved By: Marisa Olivares Revision #: 115 Page: 120 of 60 Printed: 12/27/96 12:20 A12/P12

Captulo 6 El control ActiveX de Crystal

Disponibilidad Slo lectura|tiempo de ejecucin

RecordsSelected
Descripcin Determina el nmero de registros seleccionados para incluirlos en el informe del nmero total de registros ledos. Uso en tiempo de ejecucin [form.]CrystalReport.RecordsSelected Por ejemplo:
Selected& = CrystalReport1.RecordsSelected

Recupera el nmero de registros seleccionados y lo guarda en la variable Selected. Comentarios RecordsSelected retornar un valor entre cero y el valor retornado por RecordsRead. El valor retornado por RecordsSelected depende de las consultas y las frmulas de seleccin definidas en el informe. Disponibilidad Slo lectura|tiempo de ejecucin

ReportDisplayPage
Descripcin Indica qu pgina de un informe de varias pginas se est mostrando actualmente en la ventana Vista previa. Uso en tiempo de ejecucin [form.]CrystalReport.ReportDisplayPage Por ejemplo:
Result% = CrystalReport1.DisplayPage

Recupera el nmero de la pgina mostrada y lo almacena en la variable Result. Disponibilidad Slo lectura|tiempo de ejecucin

ReportFileName
Descripcin Especifica el informe que se va a imprimir. Uso en tiempo de ejecucin [form.]CrystalReport.ReportFileName[= ReportName$] Por ejemplo:
CrystalReport1.ReportFileName = "c:\crw\company.rpt"

Imprime el informe llamado "company.rpt" que est en el directorio c:\crw.

Crystal Reports para Visual Basic 121

Filename: 86502569.doc Project: Traditional User's Guide Template Template: Author: Kirsten Sutton Last Saved By: Marisa Olivares Revision #: 115 Page: 121 of 60 Printed: 12/27/96 12:20 A12/P12

Captulo 6 El control ActiveX de Crystal

Comentarios Puede hacer doble clic en esta propiedad o en el botn con tres puntos del cuadro Configuracin para invocar el cuadro de dilogo Elegir archivo de informe. En dicho cuadro de dilogo, seleccione el nombre y la ruta de acceso del informe que quiera que imprima el programa como respuesta a un evento CRW Custom Control. Nota Si quiere especificar ReportFileName en tiempo de ejecucin, asegrese de encerrarlo entre comillas en el cdigo. Disponibilidad Tiempo de diseo; tiempo de ejecucin

ReportLatestPage
Descripcin Determina la ltima pgina impresa del informe especificado. Uso en tiempo de ejecucin [form.]CrystalReport.ReportLatestPage Por ejemplo:
Latest% = CrystalReport1.ReportLatestPage

Recupera el nmero de la ltima pgina impresa y lo almacena en la variable Latest. Disponibilidad Slo lectura|tiempo de ejecucin

ReportSource
Descripcin Especifica de donde vendr la plantilla del informe. Uso en tiempo de ejecucin [form.]CrystalReport1.ReportSource = [TrueFalse%] Por ejemplo:
CrystalReport1.ReportSource = 1

Disponibilidad Tiempo de diseo; tiempo de ejecucin

ReportStartPage
Descripcin Determina la primera pgina impresa en el informe especificado. Uso en tiempo de ejecucin [form.]CrystalReport.ReportStartPage

Crystal Reports para Visual Basic

Filename: 86502569.doc Project: Traditional User's Guide Template Template: Author: Kirsten Sutton Last Saved By: Marisa Olivares Revision #: 115 Page: 122 of 60 Printed: 12/27/96 12:20 A12/P12

Captulo 6 El control ActiveX de Crystal

Por ejemplo:
StartPage% = CrystalReport1.ReportStartPage

Recupera el nmero de la primera pgina impresa y lo almacena en la variable StartPage. Disponibilidad Slo lectura|tiempo de ejecucin solamente

SectionFont
Descripcin Especifica la fuente para una o ms secciones del informe especificado. Uso en tiempo de ejecucin [form.]CrystalReport.SectionFont(SequentialIndex%)[= sectionCode; fontName; size; italic; bold;underline;strikethru$] Por ejemplo:
CrystalReport1.SectionFont(0)="Footer;Arial;12;N;N;N;Y"

Establece la fuente para la seccin de pie como 12 puntos, Arial, tachada. Comentarios Con SectionFont, puede especificar cambios a una o ms secciones en tiempo de ejecucin. Dichos cambios se producen secuencialmente cuando se efecta la llamada "Action=1". El valor de ndice de la matriz para SectionFont simplemente especifica el orden para el cambio. As:
CrystalReport1.SectionFont(0)= "DETAIL;Arial;12;N;N;N;Y"

cuando se efectan cambios slo a la seccin DETAIL, pero


CrystalReport1.SectionMinHeight(0) = "HEADER;Arial;12;N;N;N;Y" CrystalReport1.SectionMinHeight(1) = "DETAIL;Arial;12;N;N;N;Y"

cuando se efectan cambios a ms de una seccin. Use la siguiente tabla como gua para proporcionar los valores requeridos por esta propiedad:
PARMETRO sectionCode fontName size italic TIPO DE DATOS cadena cadena nmero carcter VALOR ESPERADO Consulte la tabla de cdigos de secciones. El nombre real de la fuente; por ejemplo, Arial o Helvtica El tamao de la fuente en puntos; por ejemplo, 12 16 T = Verdadero, F = Falso, X = como est1

Crystal Reports para Visual Basic 123

Filename: 86502569.doc Project: Traditional User's Guide Template Template: Author: Kirsten Sutton Last Saved By: Marisa Olivares Revision #: 115 Page: 123 of 60 Printed: 12/27/96 12:20 A12/P12

Captulo 6 El control ActiveX de Crystal

PARMETRO bold underline strikethru

TIPO DE DATOS carcter carcter carcter

VALOR ESPERADO T = Verdadero, F = Falso, X = como est1 T = Verdadero, F = Falso, X = como est1 T = Verdadero, F = Falso, X = como est1 1X (como est) usa el valor guardado con el informe

Disponibilidad Lectura y escritura|tiempo de ejecucin

SectionFormat
Descripcin Especifica el formato para una o ms secciones del informe especificado. Uso en tiempo de ejecucin [form.]CrystalReport.SectionFormat(SectionArrayIndex%)[= sectionCode; visible; newPageBefore; newPageAfter; keepTogether; suppressBlank; resetPageNAfter; printAtPageBottom$] Por ejemplo:
CrystalReport1.SectionFormat(0)= "GH2;F;X;X;X;X;X;X"

Oculta la seccin Encabezado de grupo 2 (visible = F) y mantiene el valor predeterminado para todos los dems parmetros Comentarios Con SectionFormat puede especificar cambios a una o ms secciones en tiempo de ejecucin. Dichos cambios se producen secuencialmente cuando se realiza la llamada "Action=1". El valor de ndice secuencial para SectionFormat simplemente especifica el nmero de orden para el cambio. As:
CrystalReport1.SectionFormat(0)= "DETAIL;T;F;F;X;X;X;X"

cuando se efectan cambios slo a la seccin DETAIL, pero


CrystalReport1.SectionFormat(0) = "HEADER;T;F;F;X;X;X;X" CrystalReport1.SectionFormat(1) = "DETAIL;T;F;F;X;X;X;X"

cuando se efectan cambios a ms de una seccin.

Crystal Reports para Visual Basic

Filename: 86502569.doc Project: Traditional User's Guide Template Template: Author: Kirsten Sutton Last Saved By: Marisa Olivares Revision #: 115 Page: 124 of 60 Printed: 12/27/96 12:20 A12/P12

Captulo 6 El control ActiveX de Crystal

Use la siguiente tabla como referencia para introducir valores como parmetros para esta propiedad:
PARMETRO sectionCode visible newPageBefore newPageAfter keepTogether suppressBlank resetPageNAfter printAtPageBottom VALOR ESPERADO Consulte la tabla de cdigos de secciones. T = verdadero, F = Falso, X = como est1 T = verdadero, F = Falso, X = como est1 T = verdadero, F = Falso, X = como est1 T = verdadero, F = Falso, X = como est1 T = verdadero, F = Falso, X = como est1 T = verdadero, F = Falso, X = como est1 T = verdadero, F = Falso, X = como est1 1X (como est) usa el valor guardado con el informe

Disponibilidad Lectura y escritura|tiempo de ejecucin solamente

SectionLineHeight
Descripcin Especifica el alto de lnea en twips. Un twip es 1/1440 pulgadas; hay 20 twips en un punto. Uso en tiempo de ejecucin [form.]CrystalReport.SectionLineHeight(SequentialIndex%)[= sectionCode; line; height; ascent$] Por ejemplo:
CrystalReport1.SectionLineHeight(0) = "GH0; 1; 500; 300"

Establece el alto para la segunda lnea de la seccin cero de encabezado de grupo a un alto de 500 twips con un ascendente de 300 twips. Comentarios Con SectionLineHeight puede especificar cambios a una o ms secciones en tiempo de ejecucin. Dichos cambios se producen secuencialmente cuando se realiza la llamada "Action=1". El valor de ndice secuencial para SectionLineHeight simplemente especifica el nmero de orden para el cambio. As:
CrystalReport1.SectionLineHeight(0)= "DETAIL;1;500;300"

cuando se efectan cambios slo a la seccin DETAIL, pero


CrystalReport1.SectionLineHeight(0) = "HEADER;1;500;300" CrystalReport1.SectionLineHeight(1) = "DETAIL;1;500;300"

cuando se efectan cambios a ms de una seccin.

Crystal Reports para Visual Basic 125

Filename: 86502569.doc Project: Traditional User's Guide Template Template: Author: Kirsten Sutton Last Saved By: Marisa Olivares Revision #: 115 Page: 125 of 60 Printed: 12/27/96 12:20 A12/P12

Captulo 6 El control ActiveX de Crystal

Use la siguiente tabla como gua para suministrar los valores requeridos para esta propiedad:
sectionCo de lineN Especifica el cdigo de seccin para la seccin o secciones para las que desee establecer un nuevo alto de lnea. Especifica las lneas para las que desea establecer el alto de lnea. Los nmeros de lnea de una seccin comienzan por 0: el primer nmero de lnea es 0, el segundo es 1, etc. Especifica el alto de lnea en twips. Un twip equivale a 1/1440 pulgadas; hay 20 twips en un punto. Especifica la pendiente en twips. La pendiente es la distancia desde la parte superior del espacio de lnea asignado (alto de lnea) a la lnea base de la fuente. Este parmetro se usa para especificar la posicin de la lnea de base si se especifica un alto de lnea sobre o subdimensionado. Si se establece la pendiente a 0, el programa sita la lnea de base en la parte superior del espacio; si la pendiente se establece al mismo valor que el alto, el programa establece la lnea de base en la parte inferior del espacio. Para cualquier otra lnea de base, especifique la pendiente en twips.

height ascent

Disponibilidad Lectura y escritura|tiempo de ejecucin solamente

SectionMinHeight
Descripcin Establece el alto de seccin mnimo para la seccin de informe especificada. Uso en tiempo de ejecucin [form.]CrystalReport.SectionMinHeight(SequentialIndex%) [=sectionCode;minHeight$] Por ejemplo:
CrystalReport1.SectionMinHeight(0) = "ALL; 500"

Establece el alto mnimo para todas las secciones a 500 twips. Comentarios Con SectionMinHeight puede especificar cambios a una o ms secciones en tiempo de ejecucin. Dichos cambios se producen secuencialmente cuando se realiza la llamada "Action=1". El valor de ndice secuencial para SectionMinHeight simplemente especifica el nmero de orden para el cambio. As:
CrystalReport1.SectionMinHeight(0)= "DETAIL;500"

Crystal Reports para Visual Basic

Filename: 86502569.doc Project: Traditional User's Guide Template Template: Author: Kirsten Sutton Last Saved By: Marisa Olivares Revision #: 115 Page: 126 of 60 Printed: 12/27/96 12:20 A12/P12

Captulo 6 El control ActiveX de Crystal

cuando se efectan cambios slo a la seccin DETAIL, pero


CrystalReport1.SectionMinHeight(0) = "HEADER;500" CrystalReport1.SectionMinHeight(1) = "DETAIL;500"

cuando se efectan cambios a ms de una seccin. Disponibilidad Lectura y escritura|tiempo de ejecucin

SelectionFormula
Descripcin Especifica los registros que se van a usar al imprimir el informe. Uso en tiempo de ejecucin [form.]CrystalReport.SelectionFormulaProperty[= SelectionFormula$] Escriba la frmula de seleccin como lo hara en el Editor de frmulas de Crystal Reports. Por ejemplo, para incluir los registros que tienen una cantidad mayor que 5 en el archivo {file.Qty}, escriba "{file.QTY} > 5" como frmula de seleccin; por ejemplo, Report1.SelectionFormula = "{file.QTY} > 5" Comentarios Asegrese de que encierra la frmula de seleccin entre dobles comillas. Si la frmula de seleccin incluye comillas internas, por ejemplo:
{file.STATE} = "CA"

cambie todas las dobles comillas internas a comillas simples y encierre toda la frmula de seleccin entre dobles comillas como sigue:
"{file.STATE} = 'CA'"

Si ha creado una frmula de seleccin en el informe en tiempo de diseo, cualquier frmula de seleccin que escriba aqu se agregar a dicha frmula de seleccin. As, los registros se seleccionarn segn una combinacin de las dos frmulas de seleccin. Disponibilidad Tiempo de diseo; tiempo de ejecucin

SessionHandle
Descripcin Establece el controlador de sesin para un usuario una vez que las propiedades UserName y Password hayan abierto un archivo.mdb de Access para usarlo en el informe. Uso en tiempo de ejecucin [form.]CrystalReport.SessionHandle[= Handle%]

Crystal Reports para Visual Basic 127

Filename: 86502569.doc Project: Traditional User's Guide Template Template: Author: Kirsten Sutton Last Saved By: Marisa Olivares Revision #: 115 Page: 127 of 60 Printed: 12/27/96 12:20 A12/P12

Captulo 6 El control ActiveX de Crystal

Comentarios Si ya ha abierto una sesin de Jet en la aplicacin de Visual Basic, puede establecer esta propiedad para que sea el controlador de sesin actual. De lo contrario tendr que usar las propiedades Password y UserName para establecer la sesin de Jet. Por ejemplo:
CrystalReport1.SessionHandle = CurrentSessionHandle

establece el controlador de sesin al controlador de sesin retornado en otra parte de la aplicacin y almacenado en la variable CurrentSessionHandle. Disponibilidad Tiempo de ejecucin (lectura y escritura)

SortFields
Descripcin Especifica el o los campos que se usarn para ordenar los datos cuando se imprima el informe. Uso en tiempo de ejecucin [form.]CrystalReport.SortFields(ArrayIndex)[= "{+|-}SortField"] Escriba los campos por los que desee ordenar los datos del informe. Por ejemplo, para ordenar una base de datos de pedidos alfabticamente por cliente, y despus por fecha de pedido, puede escribir cdigo similar a ste:
CrystalReport1.SortFields(0) = "+{orders.CUSTOMER}"Report1.SortFields(1) = "+ {orders.ORDERDATE}"

Comentarios SortFields es una propiedad de matriz disponible slo en tiempo de ejecucin. Use una lnea de cdigo distinta para especificar cada campo de ordenacin. Escriba los campos de ordenacin en el orden en que desee ordenar el informe. Por ejemplo, si quiere ordenar el informe por el campo A y despus por el campo B, especifique el campo de ordenacin A en la primera lnea de cdigo y el campo de ordenacin B en la segunda lnea de cdigo. Al campo de ordenacin que especifique debe asignarse el ndice de matriz 0, al segundo campo debe asignarse el ndice de matriz 1, etc. Los valores de ndice que se asignen deben ser continuos; no se permiten saltos (0,1,2 = correcto, 0,1,3 = incorrecto) Los valores de ndice de matriz deben ser subndices en el cdigo inmediatamente despus del nombre de la propiedad; por ejemplo, Report1.SortFields(0) =. Si ha especificado campos de ordenacin para un informe en tiempo de diseo, los que escriban aqu sustituirn a los del informe.

Crystal Reports para Visual Basic

Filename: 86502569.doc Project: Traditional User's Guide Template Template: Author: Kirsten Sutton Last Saved By: Marisa Olivares Revision #: 115 Page: 128 of 60 Printed: 12/27/96 12:20 A12/P12

Captulo 6 El control ActiveX de Crystal

Si no usa esta propiedad, el programa usar las instrucciones de ordenacin que se especificaron en el informe.

Crystal Reports para Visual Basic 129

Filename: 86502569.doc Project: Traditional User's Guide Template Template: Author: Kirsten Sutton Last Saved By: Marisa Olivares Revision #: 115 Page: 129 of 60 Printed: 12/27/96 12:20 A12/P12

Captulo 6 El control ActiveX de Crystal

Si quiere borrar los campos de ordenacin de un informe, use una cadena vaca (Report1.SortFields(0) = "") Encierre los nombres de campos entre corchetes. Los campos de ordenacin pueden ser campos de la base de datos o campos de frmula. Si ordena por un campo de frmula, use el signo @ delante del nombre de la frmula; por ejemplo, @FRMULA. Disponibilidad Tiempo de ejecucin (lectura y escritura)

SQLQuery
Descripcin Obtiene y establece la cadena de consulta SQL usada por el informe especificado. Uso en tiempo de ejecucin [form.]CrystalReport.SQLQuery[=SQLQuery$] Por ejemplo:
CrystalReport1.SQLQuery = "SELECT authors.au_id, authors.au_lname, authors.au_fname FROM pubs2.dbo.authors authors WHERE authors.au_ lname > 'Madison'"

Consulta la base de datos SQL para retornar nicamente los registros en los que el nombre de los autores estn alfabticamente despus de Madison. Comentarios Puede cambiar slo las secciones WHERE y FROM de una consulta SQL. Aunque la propiedad requiere que se introduzca toda la consulta SQL, la seccin SELECT no debe ser diferente de la consulta original. Disponibilidad Lectura y escritura (tiempo de diseo y de ejecucin)

Status
Descripcin Determina el estado de impresin para el informe especificado. Uso en tiempo de ejecucin [form.]CrystalReport.Status Por ejemplo:
Status% = CrystalReport1.Status

Recupera el estado de impresin y lo guarda en la variable Status. Comentarios La propiedad Status retornar uno de los siguientes valores: 0 - El informe no se ha impreso o no se ha terminado de imprimir. 3 - El informe se termin de imprimir. 5 - El usuario cancel el informe.
Crystal Reports para Visual Basic

Filename: 86502569.doc Project: Traditional User's Guide Template Template: Author: Kirsten Sutton Last Saved By: Marisa Olivares Revision #: 115 Page: 130 of 60 Printed: 12/27/96 12:20 A12/P12

Captulo 6 El control ActiveX de Crystal

Disponibilidad Slo lectura|tiempo de ejecucin

StoredProcParam
Descripcin Obtiene y establece los parmetros de procedimiento almacenado cuando se usa un informe basado en procedimientos almacenados de SQL. Uso en tiempo de ejecucin [form.]CrystalReport.StoredProcParam(Parameter Array Index%)[= newParameter$] Por ejemplo:
CrystalReport1.StoredProcParam(0) = "06/14/1989"

Establece el primer parmetro de procedimiento almacenado a la fecha 14 de junio de 1989. Comentarios StoredProcParam establece el valor del parmetro especificado de una tabla de base de datos SQL que est basada en un procedimiento almacenado. Pase el valor al que quiera establecer el parmetro como cadena. Si el parmetro espera un tipo de datos diferente, debe pasar el valor como una cadena. Por ejemplo, para pasar el valor entero 396, use la cadena "396". El motor de impresin de Crystal realizar la conversin del valor a formato entero. Disponibilidad Lectura y escritura|tiempo de ejecucin solamente.

UserName
Descripcin Introduce el nombre asignado a un usuario para conectarse a un archivo .mdb de Access protegido con el fin de obtener los archivos de datos necesarios por el informe. Uso en tiempo de ejecucin [form.]CrystalReport.UserName[= Name$] Por ejemplo:
CrystalReport1.UserName = "MIS"

introduce el nombre de usuario "MIS" Comentarios Escriba el nombre que se le ha asignado. El nombre debe encerrarse entre comillas.

Crystal Reports para Visual Basic 131

Filename: 86502569.doc Project: Traditional User's Guide Template Template: Author: Kirsten Sutton Last Saved By: Marisa Olivares Revision #: 115 Page: 131 of 60 Printed: 12/27/96 12:20 A12/P12

Captulo 6 El control ActiveX de Crystal

Disponibilidad Tiempo de diseo; tiempo de ejecucin

WindowBorderStyle
Descripcin Especifica el tipo de borde para la ventana de impresin. Uso en tiempo de ejecucin [form.]CrystalReport.WindowBorderStyle[= BorderStyle%] Por ejemplo:
CrystalReport1.WindowBorderStyle = 2

establece un estilo de borde de tamao ajustable (Style #2) para la ventana de impresin Comentarios Seleccione uno de los siguientes estilos de borde para la ventana de impresin:
0 1 0 - NoBorder (crea una ventana sin borde). 1 - FixedSingle (crea una ventana de tamao fijo con un borde de lnea simple). 2 - Siazable (crea una ventana que el usuario puede cambiar de tamao). FixedDouble (crea una ventana de tamao fijo con un borde de lnea doble). crptNoBorder crptFixedSingle

2 3

crptSizeable crptFixedDouble

Disponibilidad Tiempo de diseo; tiempo de ejecucin

WindowControlBox
Descripcin Especifica si la ventana de impresin tendr o no un cuadro de control (men de sistema) en la esquina superior izquierda cuando el informe se dirija a una ventana. Uso en tiempo de ejecucin [form.]CrystalReport.WindowControlBox[= {True|False}] Por ejemplo:
CrystalReport1.WindowControlBox = True

especifica que aparezca un cuadro de control (men del sistema) en la ventana de impresin.

Crystal Reports para Visual Basic

Filename: 86502569.doc Project: Traditional User's Guide Template Template: Author: Kirsten Sutton Last Saved By: Marisa Olivares Revision #: 115 Page: 132 of 60 Printed: 12/27/96 12:20 A12/P12

Captulo 6 El control ActiveX de Crystal

Comentarios Seleccione True si quiere que la ventana contenga un cuadro de control. De lo contrario, seleccione False. Seleccione un valor aqu slo si est imprimiendo hacia una ventana (si Destination = 0). Disponibilidad Tiempo de diseo; tiempo de ejecucin

WindowControls
Descripcin Especifica si aparecern o no controles de impresin en la ventana Vista previa cuando la impresin se dirija a una ventana. Uso en tiempo de ejecucin [form.]CrystalReport.WindowControls[=TrueFalse%] Por ejemplo:
CrystalReport1.WindowControls = 1

Especifica qu controles de impresin aparecern en la ventana Vista previa. Comentarios Para TrueFalse% use uno de los siguientes: False = 0, True = 1. Disponibilidad Lectura y escritura (tiempo de diseo y de ejecucin)

WindowHeight
Descripcin Establece el alto de la ventana de impresin cuando el informe se dirija a una ventana. Uso en tiempo de ejecucin [form.]CrystalReport.WindowHeight[= Height%] Por ejemplo:
CrystalReport1.WindowHeight = 300

establece el alto de la ventana de impresin a 300 pxeles. Comentarios Si no le satisfacen los valores predeterminados, escriba el alto externo que desee para la ventana de impresin en pxeles. Seleccione un valor aqu slo si est imprimiendo en una ventana (si Destination = 0).

Crystal Reports para Visual Basic 133

Filename: 86502569.doc Project: Traditional User's Guide Template Template: Author: Kirsten Sutton Last Saved By: Marisa Olivares Revision #: 115 Page: 133 of 60 Printed: 12/27/96 12:20 A12/P12

Captulo 6 El control ActiveX de Crystal

Disponibilidad Tiempo de diseo; tiempo de ejecucin

WindowLeft
Descripcin Establece la distancia, en pxeles, desde el borde izquierdo de la ventana principal a la ventana de impresin. Si la ventana de impresin es de nivel superior, la distancia se mide desde la izquierda de la pantalla. Uso en tiempo de ejecucin [form.]CrystalReport.WindowLeft[= Distance%] Por ejemplo:
CrystalReport1.WindowLeft = 100

establece el borde izquierdo de la ventana de impresin a 100 pxeles desde el borde izquierdo de la pantalla. Comentarios Si no le satisface el valor predeterminado, escriba el nmero de pxeles que desee que haya entre el borde izquierdo de la pantalla y el de la ventana. Seleccione un valor aqu slo si est imprimiendo en una ventana (si Destination = 0). Disponibilidad Tiempo de diseo; tiempo de ejecucin

WindowMaxButton
Descripcin Especifica si la ventana de impresin tendr o no un botn de maximizar cuando el informe se imprima en una ventana. Uso en tiempo de ejecucin [form.]CrystalReport.WindowMaxButton[= {True|False}] Por ejemplo:
CrystalReport1.WindowMaxButton = False

especifica que no aparezca el botn de Maximizar en la ventana de impresin. Comentarios Seleccione True si quiere que la ventana contenga un botn de maximizar. De lo contrario seleccione False. Seleccione un valor aqu slo si est imprimiendo en una ventana (si Destination = 0). Disponibilidad Tiempo de diseo; tiempo de ejecucin

Crystal Reports para Visual Basic

Filename: 86502569.doc Project: Traditional User's Guide Template Template: Author: Kirsten Sutton Last Saved By: Marisa Olivares Revision #: 115 Page: 134 of 60 Printed: 12/27/96 12:20 A12/P12

Captulo 6 El control ActiveX de Crystal

WindowMinButton
Descripcin Especifica si la ventana de impresin tendr o no un botn de minimizar cuando el informe se imprima en una ventana. Uso en tiempo de ejecucin [form.]CrystalReport.WindowMinButton[= {True|False}] Por ejemplo:
CrystalReport1.WindowMinButton = True

especifica que aparezca un botn de Minimizar en la ventana de impresin. Comentarios Seleccione True si quiere que la ventana de impresin contenga un botn de minimizar. De lo contrario, seleccione False. Seleccione un valor aqu slo si est imprimiendo en una ventana (si Destination = 0). Disponibilidad Tiempo de diseo; tiempo de ejecucin

WindowParentHandle
Descripcin Especifica el controlador de la ventana principal si la ventana de impresin va a ser secundaria de otra ventana. Uso en tiempo de ejecucin [form.]CrystalReport.WindowParentHandle[= ParentHandle%] Comentarios Esta propiedad es slo de tiempo de ejecucin. Por ejemplo:
CrystalReport1.WindowParentHandle = Form1.hWnd

establece WindowParentHandle al controlador de Form1. Esto indica que la ventana de impresin es secundaria de Form1 Disponibilidad Tiempo de ejecucin (lectura y escritura)

WindowState
Descripcin Establece el estado de la ventana Vista prevista, normal, minimizada, o maximizada, cuando el informe se dirija a una ventana Vista previa.

Crystal Reports para Visual Basic 135

Filename: 86502569.doc Project: Traditional User's Guide Template Template: Author: Kirsten Sutton Last Saved By: Marisa Olivares Revision #: 115 Page: 135 of 60 Printed: 12/27/96 12:20 A12/P12

Captulo 6 El control ActiveX de Crystal

Uso en tiempo de ejecucin [form.]CrystalReport.WindowState[= State%] Por ejemplo:


CrystalReport1.WindowState= 2

Cuando el informe se imprime en una ventana Vista previa, esta ventana aparece maximizada cuando se abre. Comentarios Use los siguientes valores para establecer la propiedad WindowState:
0 = Normal La ventana Vista previa no aparece minimizada ni maximizada. Aparece con un tamao y posicin predeterminados definidos previamente por la aplicacin o por Windows. La ventana Vista previa aparece minimizada como un icono junto a la esquina inferior izquierda de la pantalla. El icono puede restaurarse para mostrar la ventana en estado normal. La ventana Vista previa se maximiza cuando se abre para ocupar toda la pantalla. crptNormal

1 = Minimized

crptMinimized

2 = Maximized

crptMaximized

Disponibilidad Tiempo de diseo; tiempo de ejecucin

WindowTitle
Descripcin Especifica el ttulo que quiera que aparezca en la barra de ttulo de la ventana de impresin cuando el informe se dirija a una ventana. Uso en tiempo de ejecucin [form.]CrystalReport.WindowTitle[= Title$] Por ejemplo:
CrystalReport1.WindowTitle = "Ingresos trimestrales"

establece el ttulo de la ventana de impresin (la cadena que aparece en la barra de ttulo) como "Ingresos trimestrales"

Crystal Reports para Visual Basic

Filename: 86502569.doc Project: Traditional User's Guide Template Template: Author: Kirsten Sutton Last Saved By: Marisa Olivares Revision #: 115 Page: 136 of 60 Printed: 12/27/96 12:20 A12/P12

Captulo 6 El control ActiveX de Crystal

Comentarios Asegrese de que el ttulo se encierra entre comillas. Seleccione un valor aqu solo si est imprimiendo en una ventana (si Destination = 0). Disponibilidad Tiempo de diseo; tiempo de ejecucin

WindowTop
Descripcin Establece la distancia, en pxeles, desde el borde superior de la ventana primaria a la ventana de impresin. Si la ventana de impresin es de nivel superior, la distancia se mide desde el borde superior de la pantalla. Uso en tiempo de ejecucin [form.]CrystalReport.WindowTop[= Distance%] Por ejemplo:
CrystalReport1.WindowTop = 100

establece el borde superior de la ventana de impresin a 100 pxeles desde la parte superior de la pantalla. Comentarios Si no est satisfecho con el valor predeterminado, escriba el nmero de pxeles que quiera que haya entre el borde superior de la pantalla y el de la ventana. Seleccione un valor aqu slo si est imprimiendo en una ventana (si Destination = 0). Disponibilidad Tiempo de diseo; tiempo de ejecucin

WindowWidth
Descripcin Especifica el ancho de la ventana de impresin en pxeles. Uso en tiempo de ejecucin [form.]CrystalReport.WindowWidth[= Width%] Por ejemplo:
CrystalReport1.WindowWidth = 480

especifica un ancho de ventana de impresin de 480 pxeles.

Crystal Reports para Visual Basic 137

Filename: 86502569.doc Project: Traditional User's Guide Template Template: Author: Kirsten Sutton Last Saved By: Marisa Olivares Revision #: 115 Page: 137 of 60 Printed: 12/27/96 12:20 A12/P12

Captulo 6 El control ActiveX de Crystal

Comentarios Si no est satisfecho con el valor predeterminado, escriba el ancho externo de la ventana, en pxeles. Seleccione un valor aqu slo si est imprimiendo en una ventana (si Destination = 0). Disponibilidad Tiempo de diseo; tiempo de ejecucin

Mtodos del control ActiveX Crystal


PrintReport
Descripcin PrintReport inicia la impresin del informe. Uso en tiempo de ejecucin [form.]CrystalReport.PrintReport Por ejemplo:
Result% = CrystalReport1.PrintReport

imprime el informe especificado. Comentarios PrintReport retorna un cdigo de resultado, 0 si la llamada es satisfactoria, un cdigo de error en el intervalo 20XXX si falla. Tambin puede imprimir un informe mediante la propiedad Action. Sin embargo, si algo va mal, se obtiene un error de ejecucin que finalizar la aplicacin. Por esta razn, necesitar instalar un controlador de error. Disponibilidad Tiempo de ejecucin

Crystal Reports para Visual Basic

Filename: 86502569.doc Project: Traditional User's Guide Template Template: Author: Kirsten Sutton Last Saved By: Marisa Olivares Revision #: 115 Page: 138 of 60 Printed: 12/27/96 12:20 A12/P12

Das könnte Ihnen auch gefallen