Beruflich Dokumente
Kultur Dokumente
C A P T U L O
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
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.
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
pueda usar el control ActiveX Crystal. El tipo de interfaz de usuario que seleccione no es importante para Crystal Reports.
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
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.
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
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.
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
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.
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
DiscardSavedData
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
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
PrintDay
PrinterCollation
PrinterCopies
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
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
PrintFileUseRptNumberFmt
PrintMonth
PrintYear
RecordsPrinted
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
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.
SortFields
Top UserName
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
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
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
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
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"
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
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
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
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"
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
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
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
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
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
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
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
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}"
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
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.
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
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 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
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
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 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
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
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.
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"
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
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 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.
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
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
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.
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
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
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
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})"
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
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
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
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
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.
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
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
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
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
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%]
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
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
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
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
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.
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
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%]
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
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= "@"
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
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
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
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
crptTabSepText
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
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
crptExcel21
crptExcel30
crptExcel40
crpt123wk1
crpt123wk3
crpt123wks
crptRTF crptWinWord
crptExcel50
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
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.
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
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
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
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.
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
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"
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
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
ReportStartPage
Descripcin Determina la primera pgina impresa en el informe especificado. Uso en tiempo de ejecucin [form.]CrystalReport.ReportStartPage
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
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 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
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
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
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"
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
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
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"
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
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
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"
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
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%]
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
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.
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
Si no usa esta propiedad, el programa usar las instrucciones de ordenacin que se especificaron en el informe.
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
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
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.
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
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
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.
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
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).
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
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
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
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.
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
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
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"
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
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
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
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
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
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