Leccion 11.6-ActiveX

8/2/2019 Leccion 11.6-ActiveX

http://slidepdf.com/reader/full/leccion-116-activex 1/60

Crystal Reports para Visual Basic 79


El motor de informes de CrystalAdemás de actuar como una aplicación de generación de informes independiente yeficaz, Crystal Reports proporciona un módulo de generación de informes que puedevincular 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 código.

El motor de informes de Crystal es una biblioteca de vínculos dinámicos (DLL) que permite que las aplicaciones tengan acceso a las mismas características de impresiónde informes que están disponibles en Crystal Reports. Como usuario con licencia deCrystal Reports, recibe derechos para entregar gratuitamente la DLL del motor deinformes (CRPE.DLL) con cualquier aplicación que cree.

Desde una aplicación, tiene acceso al motor de informes mediante el control de

Crystal ActiveX. Cuando se compilan, las aplicaciones enlazan con el motor deinformes para agregar funcionalidad de generación de informes a la aplicación. Losinformes pueden ser simples, produciendo un único informe que se envía a unaimpresora o a una ventana de impresión sin opciones disponibles para el usuario, o

puede ser complejo, permitiendo que el usuario cambie aspectos tales como laselección de registros, ordenación, agrupación y decisión de dónde debe enviarse elinforme resultante.

C A P Í T U L O 6

El control ActiveX de Crystal

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





Crystal Reports para Visual Basic

Capítulo 6 El control ActiveX de Crystal

Antes de usar el control ActiveXAntes de agregar el control ActiveX a una aplicación, debe familiarizarse conalgunas características clave del motor de informes. Revise los siguientes puntos yasegúrese de entenderlos todos antes de tratar de usar el control ActiveX.

• El motor de informes genera informes existentes. No puede crear archivos deinforme mediante la funcionalidad del motor de informes. Los informes debencrearse mediante la aplicación Crystal Reports. Asegúrese de comprender el

proceso de creación de informes antes de tratar de generar informes con elmotor de informes.

• El motor de informes proporciona un cómodo complemento, por medio delcontrol ActiveX, del proyecto de la aplicación de Visual Basic existente. Conunas pocas líneas de código se produce una eficaz herramienta de diseño y

distribución de informes que de otra forma podría necesitar miles de líneas decódigo y varias semanas de producción.

• El motor de informes no requiere el uso de una interfaz de usuario fija; estádiseñado para funcionar con su proyecto de desarrollo existente y le permitedefinir la interfaz de usuario con la que sus clientes y usuarios esténfamiliarizados y esperen de su producto.

Uso del motor de informes de CrystalCualquier proyecto de Visual Basic que incorpore el motor de informes Crystalrequiere tres pasos:

• Crear los informes a los que tendrán acceso sus usuarios.• Diseñar la interfaz de usuario en Visual Basic que controlará el motor de

informes.

• Agregar el control ActiveX Crystal a su aplicación.

Creación de informesLa creación de informes para incluirlos en aplicaciones es idéntica a la creación deinformes para su propio uso; no existen restricciones. Mediante los procedimientos

perfilados en el manual y la Ayuda de Crystal Reports, cree tantos tipos de informescomo quiera poner a disposición de los usuarios. Puede crear informes tan simples otan sofisticados como dicten sus necesidades.

Diseño de la interfaz de usuarioLa interfaz que desarrolle para permitir que los usuarios impriman informes sólo estalimitado por sus necesidades y por su imaginación. Funcionará siempre y cuando







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







Los métodos comunes de uso del motor de informes incluye un único comando demenú que produce un informe, un cuadro de diálogo que permite varias opciones

para imprimir informes o una aplicación cliente completamente independiente a laque llama su aplicación. Todas las técnicas son aceptables y cada una tiene susventajas. La forma en que diseñe la interfaz de usuario puede depender de losiguiente:

• el propósito de la aplicación,

• los tipos de informes que usará la aplicación,

• las opciones de impresión que quiera ofrecer con los informes, y

• si la aplicación ofrecerá un único informe o una elección entre varios informes.

Considere detenidamente la aplicación y las necesidades de los informes, y diseñe lainterfaz de usuario que utilizará el motor de informes más eficientemente.

El control ActiveXActiveX es una nueva tecnología de Microsoft Corporation diseñada para traer aplicaciones más eficaces a equipos personales y redes locales. ActiveX va más alláde las aplicaciones que producen documentos estáticos para un entorno de Windowsque proporciona controles activos, documentos y aplicaciones de cliente que puedenoperar e interaccionar no solo entre sí, sino con redes intranet y con Internet.

Los controles ActiveX proporcionan capacidades complementarias que le permitenagregar componentes de aplicación, e incluso aplicaciones completas, a sus propios

proyectos de desarrollo sin escribir más que unas pocas líneas de código. CrystalReports 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

fácilmente todo el poder de procesamiento de informes de Crystal Reports a sus propias aplicaciones de Visual Basic.

Consulte la documentación de Visual Basic para obtener información completaacerca del uso de controles ActiveX con Visual Basic. El resto de este capítulodescribe información específica del control ActiveX Crystal.

Agregar el control ActiveX a un proyectoEl control ActiveX Crystal se instala en el directorio \WINDOWS\SYSTEM alinstalar Visual Basic 5.0. El control ActiveX se agrega a un proyecto de Visual Basicmediante 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 dediálogo Componentes.







4 Si el control Crystal Report aparece en la lista Controles, haga clic en la casillade verificación 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 enExaminar y aparecerá el cuadro de diálogo Agregar control ActiveX.

Nota Crystal Report Control es el nombre del control ActiveXCrystal cuando se agrega a un proyecto de desarrollo. El términocontrol ActiveX hace referencia a un tipo de control, mientras queCrystal Report Control es el nombre del control ActiveX Crystalproporcionado por Crystal Reports. En esta documentación, lostérminos control ActiveX Crystal y Crystal Report Control se usanindistintamente para hacer referencia al control ActiveX incluidocon Crystal Reports para Visual Basic.

6 Use los controles del cuadro de diálogo 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 enAbrir.

7 Crystal Report Control aparecerá en el cuadro de lista Controles. Haga clic en lacasilla de verificación que hay junto al nombre del control y haga clic enAceptar.

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 laherramienta y el programa lo instalará en el formulario activo.

Uso del control ActiveXUna vez que tenga un objeto control ActiveX Crystal en el formulario, se crea laconexión entre la aplicación y Crystal Reports estableciendo las propiedades delobjeto en tiempo de diseño o cambiándolas en tiempo de ejecución. Las propiedadesde ActiveX le permiten especificar:

• el nombre del informe que desea imprimir como respuesta al evento de unaaplicación,

• el destino de un informe (ventana Vista previa, archivo de disco, impresora ocorreo electrónico),

• el número de copias que desea imprimir (si el informe va a la impresora),

• información del archivo de impresión (si el informe va a un archivo de disco),

• información de tamaño y posición de la ventana (si el informe va a una ventanaVista previa),







• información de fórmula de selección (si quiere limitar los registros del informe),

• información de orden, y

• otras propiedades relacionadas.

Las propiedades del control ActiveX Crystal pueden cambiarse en tiempo de diseñoo en tiempo de ejecución. Sin embargo, tenga en cuenta que algunas propiedadessólo están disponibles en tiempo de ejecución. Estas propiedades no aparecen entiempo de diseño.

Cambio de propiedades en tiempo dediseño

10 Haga clic en el control ActiveX que aparece en el formulario para seleccionarlo.

11 Haga clic con el botón secundario del mouse (ratón) y elija el comando

Propiedades de Crystal del menú contextual que aparece. Aparecerá el cuadrode diálogo Páginas de propiedades.

12 Use las fichas y los controles de este cuadro de diálogo para cambiar las propiedades del control ActiveX en tiempo de diseño.

Nota Las propiedades del control ActiveX también aparecen en elcuadro Propiedades de Visual Basic en tiempo de diseño.

Cambio de propiedades en tiempo deejecución

La mayoría de las propiedades del control ActiveX pueden establecerse en tiempo deejecución agregando entradas simples al código del procedimiento. Las propiedades

establecidas en tiempo de ejecución sustituyen a los valores establecidos en tiempode diseño.

Use la propiedad Action o el método PrintReport para procesar realmente elinforme en tiempo de ejecución. La propiedad Action y el método PrintReport sólo

pueden usarse en tiempo de ejecución y son los únicos medios por los que el controlActiveX puede generar el informe realmente.

Para obtener más información acerca de cómo establecer el valor de determinadas propiedades en tiempo de ejecución, consulte la descripción de cada propiedad o enla Ayuda en pantalla de Crystal Reports. Cada descripción incluye código de ejemplo

para establecer la propiedad en la aplicación de Visual Basic.







Índice de propiedades ActiveXA continuación se enumeran las propiedades ActiveX, además de una brevedescripción.

Action Es la propiedad que desencadena la impresióndel informe.

BoundReportFooter Propiedad True o False que especifica si el piede página va a aparecer o no en el informeenlazado predeterminado.

BoundReportHeading Propiedad de cadena que permite al usuarioasignar un título al informe.

Connect Inicia una sesión en un servidor SQL.

CopiesToPrinter Especifica el número de copias que se van a

imprimir si imprime en una impresora.DataFiles Especifica la ubicación de los archivos o tablas

de base de datos usados en el informe.

DataSource Especifica en qué control de datos busca losdatos el control ActiveX Crystal Reports.

Destination Especifica el destino en el que se imprimirá elinforme (Ventana, Impresora o Archivo).

DetailCopies Especifica el número de copias de cada registrode la sección Detalles que imprimirá el

programa.

DiscardSavedData Si los datos se guardan con el informeespecificado, establecer esta propiedad a 1(True) descarta los datos.

EMailCCList Especifica la lista "CC" a la que desea enviar elmensaje de correo electrónico.

EMailMessage Especifica la cadena del mensaje de correoelectrónico.

EMailSubject Especifica la línea de asunto del mensaje decorreo electrónico.

EMailToList Especifica la lista "A" a la que desea enviar elmensaje de correo electrónico.

Formulas Especifica una nueva cadena para una fórmulaexistente.

GraphData Obtiene y establece los datos usados para ungráfico especificado.







GraphOptions Obtiene y establece una serie de opciones parael gráfico especificado.

GraphText Obtiene y establece los diversos componentesde texto para el gráfico especificado.

GraphType Obtiene y establece el tipo de gráfico usado enla sección seleccionada del informeespecificado.

GroupCondition Especifica qué tipo de cambio en el Campo decondición de grupo desencadenará la creaciónde un grupo.

GroupSelectionFormula Especifica los grupos que se van a usar cuandoimprima el informe.

GroupSortFields Especifica el o los campos de grupo que seusarán para ordenar el los datos al imprimir informe.

LastErrorNumber Devuelve el código de error para el últimoerror de ejecución.

LastErrorString Devuelve la cadena de error para el últimoerror de tiempo de ejecución.

Left Consulte la documentación de Visual Basic.

MarginBottom Obtiene y establece el margen inferior para elinforme especificado.

MarginLeft Obtiene y establece el margen izquierdo para elinforme especificado.

MarginRight Obtiene y establece el margen derecho para elinforme especificado.

MarginTop Obtiene y establece el margen superior para el

informe especificado.Name Consulte la documentación de Visual Basic.

Password Introduce la contraseña necesaria para usar lastablas de la base de datos en un archivorestringido .mdb de Access.

PrintDay Obtiene y establece el componente día de lafecha de impresión (si es diferente de la fechareal en que se imprime el informe).

PrinterCollation Si especifica más de una copia para imprimir (mediante la propiedad PrinterCopies),PrinterCollation especifica si las copias seintercalarán o no.

PrinterCopies Obtiene y establece el número de copias delinforme para imprimir.







PrinterDriver Obtiene y establece el nombre del controlador de impresora que imprimirá el informe.

PrinterName Obtiene y establece el nombre de la impresoraque imprimirá el informe.

PrinterPort Obtiene y establece el nombre del puerto deimpresora que imprimirá el informe.

PrinterStartPage Obtiene y establece la primera página que se vaa imprimir.

PrinterStopPage Obtiene y establece la última página que se vaa imprimir.

PrintFileCharSepQuote Obtiene y establece el carácter separador paraencerrar datos de campos alfanuméricoscuando se imprime a un archivo con el formatoSeparado por caracteres.

PrintFileCharSepSeparator Obtiene y establece el o los caracteres que deseusar para separar los campos cuando seimprime a un archivo con el formato Valor separador por caracteres.

PrintFileName Especifica el nombre del archivo en el que seimprimirá el informe.

PrintFileType Especifica el tipo del archivo en el que seimprimirá el informe.

PrintFileUseRptDateFmt Cuando se imprime en un archivo, indica si el programa debe guardar o no las fechas en elmismo formato de fecha (MDA, DMA, etc.)que el utilizado en el informe o bien optimizar las fechas para el formato de archivoseleccionado.

PrintFileUseRptNumberFmt Cuando se imprime en un archivo, indica si el programa debe imprimir o no números en elmismo formato (decimales, negativos, etc.) quese ha usado en el informe o bien optimizar losnúmeros para el formato de archivoseleccionado.

PrintMonth Obtiene y establece el componente mes de lafecha de impresión (si es diferente de la fechareal de impresión del informe).

PrintYear Obtiene y establece el componente año de lafecha de impresión (si es diferente de la fechareal de impresión del informe).

RecordsPrinted Determina el número de registros impresosrealmente.







RecordsRead Determina el número de registros leídosrealmente.

RecordsSelected Determina el número de registrosseleccionados.

ReportDisplayPage Indica qué página de un informe de varias páginas se está mostrando actualmente en laventana Vista previa.

ReportFileName Especifica el informe que se va a imprimir.

ReportLatestPage Determina la última página impresa delinforme especificado.

ReportSource Especifica el origen del informe como unarchivo de informe, un control de datos, o uncontrol de datos de cuadrícula.

ReportStartPage Determina la primera página impresa en el

informe especificado.SectionFont Especifica la fuente para una sección.

SectionFormat Especifica el formato para una sección.

SectionLineHeight Especifica el alto de línea para una sección.

SectionMinHeight Establece el alto de sección mínimo para lasección de informe especificada.

SelectionFormula Especifica los registros que se van a usar alimprimir el informe.

SessionHandle Establece el controlador de sesión para unusuario una vez que las propiedades UserName

y Password hayan abierto un archivo .mdb deAccess para usarlo en el informe.

SortFields Especifica el o los campos que se usarán paraordenar los datos cuando se imprima elinforme.

SQLQuery Obtiene y establece la cadena de consulta SQLusada por el informe especificado.

Status Determina el estado de impresión del informeespecificado.

StoredProcParam Obtiene y establece los parámetros de procedimiento almacenados cuando se usa uninforme basado en procedimientosalmacenados SQL.

Top Consulte la documentación de Visual Basic.

UserName Introduce el nombre asignado a un usuario para

conectarse a un archivo .mdb de Access protegido, para obtener los archivos de datosrequeridos por el informe.







WindowBorderStyle Especifica el tipo de borde para la ventana deimpresión.

WindowControlBox Especifica si la ventana de impresión tendrá ono un cuadro de control (menú de sistema) enla esquina superior izquierda cuando el informese dirija a una ventana.

WindowControls Especifica si aparecerán o no controles deimpresión en la ventana Vista previa cuando laimpresión se dirija a una ventana.

WindowHeight Establece el alto de la ventana de impresióncuando ésta se dirija a una ventana.

WindowLeft Establece la distancia, en píxeles, desde el borde izquierdo de la ventana primaria a laventana de impresión. Si la ventana deimpresión es de nivel superior, la distancia se

mide desde el borde izquierdo de la pantalla.WindowMaxButton Especifica si la ventana de impresión tendrá o

no un botón de maximizar cuando el informe seimprima en una ventana.

WindowMinButton Especifica si la ventana de impresión tendrá ono un botón de minimizar cuando el informe seimprima en una ventana.

WindowParentHandle Especifica el controlador de la ventana primaria si la ventana de impresión va a ser secundaria de otra ventana.

WindowState Establece el estado de la ventana Vista previa(normal, minimizada o maximizada) cuando elinforme se dirija a una ventana Vista previa.

WindowTitle Especifica el título que desea que aparezca enla barra de título de la ventana de impresióncuando el informe se dirija a una ventana.

WindowTop Establece la distancia, en píxeles, desde el borde superior de la ventana primaria a laventana de impresión. Si la ventana deimpresión es de nivel superior, la distancia semide desde el borde superior de la pantalla.

WindowWidth Especifica el ancho de la ventana de impresiónen píxeles.







Índice de métodos ActiveXPrintReport Desencadena la impresión del informe.

Propiedades del control ActiveX CrystalAction

Descripción

Action es la propiedad que desencadena la impresión del informe.

Uso en tiempo de ejecución

[formulario.]CrystalReport.Action = 1

Por ejemplo:

CrystalReport1.Action = 1

«imprime el informe especificado.»

Comentarios

Establezca la propiedad Action a 1 en el código del procedimiento(CrystalReport1.Action = 1) para imprimir el informe como respuesta a un eventodel usuario.

Disponibilidad

Sólo de escritura en tiempo de ejecución

BoundReportFooterDescripción

Propiedad True o False que especifica si el pie de página va a aparecer o no en elinforme enlazado predeterminado.


[formulario.]CrystalReport1.BoundReportFooter = True

Por ejemplo:

CrystalReport1.BoundReportFooter = True

Disponibilidad

Tiempo de diseño; tiempo de ejecución

BoundReportHeadingDescripción

Propiedad de cadena que permite al usuario asignar el título del informe.


[formulario.]CrystalReport1.BoundReportHeading = "título de informe"







Por ejemplo:

CrystalReport1.BoundReportHeading = "Ventas por región"

«imprime el título indicado para el informe especificado.»

Disponibilidad


ConnectDescripción

Inicia una sesión en un servidor SQL.


[formulario.]CrytalReport.Connect[= Name;UserID;Password;DatabaseQualifier$]

Por ejemplo:

CrystalReport1.Connect = "DSN = Contabilidad;UID = 734;PWD = grande;DSQ =Administración"

«conecta con la base de datos "Administración" del servidor "Contabilidad"usando el Id. de usuario 734 y la contraseña "grande".»

Comentarios

Escriba los parámetros necesarios para iniciar una sesión en el servidor SQL quenecesita activar para el informe.

Los parámetros deben aparecer con el siguiente formato:

DSN = nombre;UID = Idusuario;PWD = contraseña;DSQ = calificador base dedatos

• nombre es el nombre del servidor.

• Id. usuario es el nombre que se le ha asignado para iniciar una sesión en elservidor SQL.

• contraseña es la contraseña que se le ha asignado para iniciar una sesión en elservidor 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 elcontrolador ODBC para la base de datos SQL que piense utilizar eindicar la ubicación Database/BIN en la ruta de acceso.

Nota Este parámetro sólo se requiere cuando sea aplicable alcontrolador ODBC que esté usando.

Disponibilidad








CopiesToPrinterDescripción

Especifica el número de copias que se van a imprimir si imprime en unaimpresora (si el valor que asigna a la propiedad Destination es 1 - Printer).


[formulario.]CrystalReport.CopiesToPrinter[= NumCopias%]

Por ejemplo:

CrytalReport1.CopiesToPrinter = 3

«imprime tres copias del informe especificado.»

Comentarios

El número especificado no debe ser cero ni negativo.

Disponibilidad

Tiempo de diseño; tiempo de ejecuciónDataFiles

Descripción

Especifica la ubicación de los archivos o tablas de base de datos usados en elinforme.


[formulario.]CrystalReport.DataFiles(ÍndiceMatriz)[= Ubicación$]

• Escriba el nombre y la ruta de acceso a cada archivo o tabla de base de datosdel informe para el que quiera cambiar la ubicación.

• Use una línea de código distinta por cada archivo para el que desee cambiar laubicación.

• El orden de los archivos la matriz debe reflejar el orden de los archivos delinforme. (Puede usar el comando Establecer ubicación 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 ubicación 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"







Comentarios

• DataFiles es una propiedad de matriz que sólo está disponible en tiempo deejecución.

• Use esta propiedad si desea ejecutar el informe con archivos de diferentesubicaciones de las especificadas en el informe.

• Si utiliza esta propiedad, no tiene que cambiar las ubicaciones de todos losarchivos del informe. Simplemente asegúrese de que el índice de la matriz

para cada archivo que cambie coincida con la posición de dicho archivo enel 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 elinforme.

Disponibilidad

Tiempo de ejecución

DataSourceDescripción

Especifica en qué control de datos el buscará los datos el control ActiveX Crystal.

Disponibilidad

Solo en tiempo de diseño

DestinationDescripción

Especifica el destino en el que se imprimirá el informe (Ventana, Impresora oArchivo).

Uso en tiempo de ejecución[formulario.]CrystalReport.Destination[= Destino%]

Por ejemplo:

CrystalReport1.Destination = 0

«envía el informe especificado a una ventana de impresión.»

Comentarios

Seleccione uno de los siguientes destinos de impresión:

0 0 =Window (envía el informe a unaventana de impresión)

crptToWindow

1 1 =Printer (envía el informe a unaimpresora)

crptToPrinter







2 2 =File (imprime el informe a un archivode disco para su impresión posterior o para

importarlo en otras aplicaciones. Siselecciona esta propiedad, también tendráque establecer las propiedadesPrintFileName y PrintFileType).

crptToFile

3 3 =MAPI (envía el informe a otra personade la red local por correo electrónico víaMAPI (Microsoft Mail). El informe seanexa a la carta de correo electrónico en elformato especificado por la propiedadPrintFileType).

crptMapi

Disponibilidad


DetailCopiesDescripción

Especifica el número de copias de cada registro de la sección Detalles queimprimirá el programa.


[formulario.]CrystalReport.DetailCopies[= NúmCopias%]

Por ejemplo:

CrystalReport1.DetailCopies = 3

«Especifica que se impriman tres (3) copias de cada registro en la secciónDetalles.»

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 sección Detalles del informe.

Disponibilidad

Lectura y escritura (tiempo de diseño y de ejecución)

DiscardSavedDataDescripción

Si los datos se guardan con el informe especificado, establecer esta propiedad a 1(True) descarta los datos.


[formulario.]CrystalReport.DiscardSavedData[= TrueFalse%]

Por ejemplo:

CrystalReport1.DiscardSavedData = 1

«Descarta los datos guardados con el informe especificado.»







Comentarios

Para TrueFalse% use uno de los siguientes valores: False = 0, True = 1.

Disponibilidad


EMailCCListDescripción

Especifica la lista "CC" a la que desea enviar el mensaje de correo electrónico.


[formulario.]CrystalReport.EMailCCList [= ListaCC$]

Por ejemplo:

CrystalReport1.EMailCCList = "Juana Bravo;Jesús Díaz "

«Envía una Copia del mensaje de correo electrónico a Juana Bravo y a Jesús

Díaz»Comentarios

• Aplicable a MAPI.

• Los nombres múltiples deben separarse por signos de punto y coma.

Disponibilidad


EMailMessageDescripción

Especifica la cadena que desea que aparezca como el cuerpo del mensaje decorreo electrónico.

Uso en tiempo de ejecución[formulario.]CrystalReport.EMailMessage[=Mensaje$]

Por ejemplo:

CrystalReport1.EMailMessage = "La reunión es a las 4:00"

«Establece "La reunión es a las 4:00" como cuerpo del mensaje de correoelectrónico.»

Comentarios

Aplicable a MAPI.

Disponibilidad


EMailSubjectDescripción

Especifica la línea de asunto del mensaje de correo electrónico.


[formulario.]CrystalReport.EMailSubject[= Asunto$]







Por ejemplo:

CrystalReport1.EMailSubject = "Reunión del personal "

«Establece "Reunión del personal " como la línea de asunto de un mensaje decorreo electrónico.»

Comentarios

Aplicable a MAPI.

Disponibilidad


EMailToListDescripción

Especifica la lista "A" a la que desee enviar el mensaje de correo electrónico.


[formulario.]CrystalReport.EMailToList [=ListaA$]Por ejemplo:

CrystalReport1.EMailToList = "Jesús Díaz "

«Establece "Jesús Díaz " como único nombre de la lista "A".»

Comentarios

• Aplicable a MAPI.

• Varios nombres deben separarse por signos de punto y coma.

Disponibilidad


FormulasDescripción

Especifica una nueva cadena para una fórmula existente.


[formulario.]CrystalReport.Formulas(ÍndiceMatriz)[= "NombreFórmula=TextoFórmula"]

Escriba el nombre de la fórmula y la cadena que quiera que sustituya a laexistente para cada fórmula del informe que desee cambiar.

Por ejemplo, para cambiar una fórmula @COMISIÓN a {archivo.VENTAS}*.1, yuna segunda fórmula @TOTAL a {archivo.VENTAS} + {archivo.COMISIÓN},escriba lo siguiente:

CrystalReport1.Formulas(0) = "COMISIÓN= {archivo.VENTAS} * .1"

CrystalReport1.Formulas(1) = "TOTAL= {archivo.VENTAS} +{archivo.COMISIÓN}"







Comentarios

• Formulas es una propiedad de matriz que sólo está disponible en tiempo deejecución.

• Use una línea de código distinta para cada fórmula que desee cambiar.

• Cambie sólo aquellas fórmulas que quiera cambiar.

• La primera fórmula que cambie debe asignarse al índice (0) de la matriz, lasegunda debe asignarse al índice (1), etc.

• La nueva cadena de fórmula debe cumplir los requisitos sintácticos de CrystalReports.

• Esta propiedad se borra una vez impresa la tarea. Si imprime por segunda vez,el programa vuelve a las fórmulas según se especificaron originalmente enel informe.

Nota Los espacios en blanco son significativos en los nombres defórmulas. Por esta razón, el signo igual debe seguir al nombre dela fórmula sin espacio entre ellos.

Nota El signo @ no se usa cuando se designa un nombre defórmula en esta propiedad.

Nota Esta propiedad no puede utilizarse para crear nuevasfórmulas. Sólo pueden cambiarse fórmulas existentes.

Disponibilidad

Tiempo de ejecución (lectura y escritura)

GraphDataDescripción

Obtiene y establece los datos usados un gráfico especificado.


[formulario.]CrystalReport.GraphData(ÍndiceMatriz%)[= CódigoSección; NúmeroGráfico; fila; columna; campo; dirección$]

Por ejemplo:

CrystalReport1.GraphData(0)= "DETAIL; 1; GROUP1; GROUP2; 0;COLANDROW"

«El valor de Group 1 se usa para las líneas del gráfico, el valor de Group 2 se usa para las columnas, el primer campo de resumen agregado al informe se usa paraestablecer el valor de la elevación del gráfico, y los valores de columnas y filas seusan para crear el gráfico.»







Comentarios

Con GraphData puede especificar cambios a uno o más gráficos en tiempo de

ejecución. Dichos cambios tienen lugar de forma secuencial cuando se realice lallamada "Action=1". El valor de índice de la matriz para GraphData especificasimplemente el número de orden para los cambios. Así:

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

cuando se hagan cambios a un único gráfico, pero

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

cuando se realicen cambios a más de un gráfico.

Use la siguiente tabla como guía para proporcionar los valores requeridos por esta propiedad:

PARAMETRO DESCRIPCION VALOR ESPERADOsectionCode Especifica la sección en

que desea modificar ungráfico.

Consulte la tabla de códigos desección.

GraphNum El número del gráficodentro de la sección quedesea modificar.

Los gráficos de una sección senumeran desde cero, de izquierda aderecha y de arriba abajo.

Row El número de grupo delinforme usado para crear filas en el gráfico.

GROUP1, GROUP2, GROUP3, . . .,GROUP9

col El número de grupo delinforme usado para crear columnas del gráfico.

GROUP1, GROUP2, GROUP3, . . .,GROUP9

field El campo de resumen quecontiene los valoresmáximos de cada cima delgráfico.

El primer campo de resumen agregadoa un informe se numera como 0, elsegundo como 1, etc.

direction Si los valores de las filas,las columnas o ambos seusan para crear el gráfico.

ROWS, COLS, ROWANDCOL, oCOLANDROW

Disponibilidad

Lectura y escritura|tiempo de ejecución







GraphOptionsDescripción

Obtiene y establece una serie de opciones para el gráfico especificado.


[formulario.]CrystalReport.GraphOptions(ÍndiceMatriz%)[= CódigoSección; NúmeroGráfico; fuente; DirecciónBarras;etiquetas;cuadrícula;leyenda;máx;mín$]

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 líneas de cuadrícula del primer gráfico de la sección Pie de página.»

Comentarios

Con GraphOptions puede especificar cambios a uno o más gráficos en tiempo deejecución. Dichos cambios se llevan a cabo de forma secuencial cuando se realizala llamada "Action=1". El valor de índice de la matriz para GraphOptionsespecifica simplemente el número de orden para el cambio. Así:

CrystalReport1.GraphOptions(0) = "DETAIL; 1; Arial; H; T; F;legend; max; min"

cuando sólo se cambia un gráfico, 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 más de un gráfico.

Use el siguiente diagrama como guía para introducir los valores de propiedadrequeridos:

PARÁMETRO DESCRIPCIÓN VALORES ESPERADOSsectionCode Especifica la sección en

la que desea modificar ungráfico.

Consulte la tabla de códigos desección.

GraphNum Especifica qué gráfico dela sección deseamodificar.

Los gráficos de una sección senumeran, comenzando por cero, deizquierda a derecha y de arriba abajo.

FontFace Especifica la fuente paratodo el gráfico.

Nombre real de fuente; por ejemplo,Arial

barDirection En un gráfico de barras,especifica la dirección en

la que desea queaparezcan las barras.

H = horizontal, V = vertical, X =como esté







PARÁMETRO DESCRIPCIÓN VALORES ESPERADOSlabelRisers Especifica si quiere que

se muestren los valoresde datos de cada cima.

T= verdadero, F = Falso, X = como

esté

gridLines Especifica si quiere quese muestren las líneas dela cuadrícula.

T= verdadero, F = Falso, X = comoesté

legend Especifica si quiere quese muestre una leyenda.

T= verdadero, F = Falso, X = comoesté

max Especifica el valor máximo que desea incluir en un gráfico.

Indique un número.

Min Especifica el valor mínimo que desea incluir en un gráfico.

Indique un número.

Disponibilidad


GraphTextDescripción

Obtiene y establece los diversos componentes de texto para el gráficoespecificado.


[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 gráfico de la sección Encabezadode página.»

Comentarios

Seleccione el código de sección de la tabla de código de secciones.

Con GraphText puede especificar cambios a uno o más gráficos en tiempo deejecución. Dichos cambios tienen lugar de forma secuencial cuando se realiza lallamada "Action=1". El valor de índice de la matriz de GraphText simplementeespecifica el número de orden para los cambios. Así:

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

z string"







cuando se efectúan cambios a un único gráfico, 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; seriesstring; group string; x string;y string; z string"

cuando se realizan cambios a más de un gráfico.

"title", "subTitle", "footnote", "series", "group", "x","y", y "z" son las cadenas quedese etiquetar para las partes adecuadas del gráfico.

Disponibilidad


GraphTypeDescripción

Obtiene y establece el tipo de gráfico usado en la sección seleccionada del

informe especificado.Uso en tiempo de ejecución

[form.]CrystalReport.GraphType(ArrayIndex%)[=sectionCode;graphNum;graphType$]

Por ejemplo:

CrystalReport1.GraphType(0)= "GH1; 0; PIE"

«Especifica un gráfico circular como el primer gráfico (graphNum =0) de lasección Encabezado de grupo 1 »

Comentarios

Con GraphType puede especificar cambios a uno o más gráficos en tiempo deejecución. Dichos cambios tienen lugar secuencialmente cuando se realiza la

llamada "Action=1". El valor de índice de la matriz de GraphType especifica elorden para los cambios. Así:

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

cuando se realizan cambios a un único gráfico, pero

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

cuando se realizan cambios a más de un gráfico.

Seleccione el código de sección en la tabla de códigos de secciones.

Los números de gráficos comienzan por 0; el primer gráfico de una sección es elnúmero 0, el segundo es 1, etc.







Cuando hay varios gráficos en una sección se numeran de izquierda a derecha yde arriba abajo.

Seleccione de los siguientes tipos de gráficos para el valor graphType de esta propiedad:

PARA ESTE TIPO DE GRÁFICO USE ESTE CÓDIGO PARAGRAPHTYPE

Lado a lado SIDEBYSIDE

Columna 3-D 3DSIDE

Apiladas STACKEDBAR

Apiladas 3-D 3DSTACKED

Porcentaje PERCENTBAR

Porcentaje 3-D 3DPERCENT

Línea LINE

Área AREABarras 3-D 3DBARS

Circular PIE

Múltiple MULTIPLEPIE

Proporcionado WEIGHTEDPIE

Disponibilidad


GroupConditionDescripción

Especifica qué tipo de cambio en el campo de condición de grupo desencadenarála creación de un grupo.


[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 agrupación.»







Comentarios

Consulte las siguientes tablas para valores de parámetros de esta propiedad:

PARÁMETRO DESCRIPCIÓN VALORES ESPERADOSgroup El grupo en que el que

desea establecer lacondición de grupo.

El grupo más externo del informe esGROUP1, el siguiente grupo esGROUP2, etc.

field El nombre del campoque producirá unaagrupación siempre quecambie su valor.

Indique el nombre en el siguienteformato: {tabla.campo}

condition Indique la condición que producirá la agrupación.

Consulte las siguientes tablas.

SortDirection La dirección en que seordenarán los grupos.

A = Ascendente,

D = Descendente

Condiciones de campo de fecha

CONDICIÓN CÓDIGO DE CONDICIÓNDiario DAILY

Semanal WEEKLY

Quincenal BIWEEKLY

Semi-mensual SEMIMONTHLY

Mensual MONTHLY

Trimestral QUARTERLY

Semi-anual SEMIANNUALLY

Anual ANNUALLY

Condiciones de campo booleanoCONDICIÓN CÓDIGO DE CONDICIÓNA sí TOYES

A No TONO

Cada Yes EVERYYES

Cada No EVERYNO

Próximo Yes NEXTISYES

Próximo No NEXTISNO

Condición para los demás tipos de datos

CONDICIÓN CÓDIGO DE CONDICIÓNCualquier cambio ANYCHANGE

Disponibilidad

Lectura y escritura|tiempo de ejecución solamente







GroupSelectionFormulaDescripción

Especifica los grupos que se van a utilizar cuando se imprima el informe.


[form.]CrystalReport.GroupSelectionFormula[= "GroupSelectionFormula"]

Escriba la fórmula de selección de grupo como si le introdujera en el Editor defórmulas. Por ejemplo, para limitar el informe a aquellos grupos que tengan unsubtotal en el campo header.AMOUNT menor que $10.000 (con subtotales

producidos por cambios en el campo header.CUSTNUMB), debe introducir losiguiente como fórmula de selección de grupo:

CrystalReport1.GroupSelectionFormula = Sum ( {header.AMOUNT},{header.CustNumb}) < 10000

Comentarios

Si la fórmula de selección de grupo incluye comillas internas, cambie todas lasdobles comillas internas a comillas simples y encierre la fórmula de selección degrupo entre dobles comillas.

Nota Si ha creado una fórmula de selección de grupo en tiempode diseño, cualquier fórmula de selección de grupo que indiqueaquí se agregará a dicha fórmula de selección de grupo,conectada por "and". Así, los registros se seleccionarán segúnuna combinación de las dos fórmulas.

Disponibilidad


GroupSortFieldsDescripciónEspecifica el o los campos de grupo que se usarán para ordenar los datos cuandose imprima el informe.


[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 CrystalReports ha contado el número de clientes de cada grupo. Para imprimir el grupocon el mayor contador primero y después con el siguiente contador, etc. (ordendescendente), especifique una cadena de caracteres similar a la siguiente:

CrystalReport1.GroupSortFields(0) = "-Count({customer.CUSTOMER},{customer.STATE})"







Comentarios

• GroupSortFields es una propiedad de matriz sólo disponible en tiempo deejecución.

• Use una línea de código distinta para especificar cada campo de orden degrupo.

• Introduzca los campos de ordenación en el orden en que desee ordenarlos en elinforme. Por ejemplo, si primero quiere ordenar el informe según el campode ordenación de grupo A y después según el campo B, especifique elcampo de ordenación A en la primera línea de código y el campo B en lasegunda línea de código.

• Al primer campo de ordenación de grupo que especifique debe asignarse elíndice de matriz 0, al segundo campo de ordenación de grupo debeasignarse 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 subíndices en el códigoinmediatamente después del nombre de la propiedad; por ejemplo,CrystalReport1.GroupSortFields(0) =.

• Si ha especificado campos de ordenación para el informe en tiempo de diseño,los campos de ordenación introducidos aquí sustituirán a los campos deordenación del informe.

• Si no usa esta propiedad, el programa usará las instrucciones de ordenaciónque se especificaron en el informe.

• Si desea borrar los campos de ordenación de grupo del informe, use una

cadena vacía (CrystalReport1.GroupSortFields(0) = "")• Esta propiedad se borra cuando se imprime la tarea. Si se imprime una segunda

vez, el programa restablece los campos de ordenación de grupoespecificados originalmente en el informe.

Nota La entrada del campo de ordenación de grupo debe irseguida del signo de dirección (+ o -) sin espacios.

Nota Para encontrar la sintaxis correcta para cualquier grupo delinforme usando Crystal Reports para Visual Basic: seleccioneInsertar|Campo de fórmula, escriba cualquier nombre defórmula en el cuadro de diálogo Insertar fórmula cuandoaparezca, haga clic en el botón de desplazamiento de la lista

Campos en el de fórmulas Editor cuando aparezca, y haga dobleclic en el campo de grupo que desee.

Crystal Reports escribe el nombre del campo de grupo en elcuadro Texto de fórmula. Use el nombre y la sintaxis de dicho







cuadro de texto cuando construya la cadena del campo deordenación de grupo.







Disponibilidad


LastErrorNumberDescripción

Devuelve el código de error del último error de ejecución.


[form.]CrystalReport.LastErrorNumber

Por ejemplo:

' Si ocurre un error, ir a ErrorHandler ErrorHandler:MsgBoxCrystalReport1.LastErrorNumber

«si se produce un error, este código invoca un cuadro de mensajes que muestra elnúmero del error.»

ComentariosLastErrorNumber es una propiedad sólo de tiempo de ejecución.

Nota LastErrorNumber debe aparecer después de la llamada aAction para mostrar los valores relevantes. Después de imprimirel informe, puede consultar esta propiedad para obtener unnúmero de error (si lo hubiera). Si no hubo ningún error en laimpresión, LastErrorNumber = 0.

Disponibilidad


LastErrorStringDescripción

Devuelve la cadena de error del último error de ejecución.Uso en tiempo de ejecución

[form.]CrystalReport.LastErrorString

Por ejemplo:

'Si ocurre un error, ir a ErrorHandler ErrorHandler:MsgBoxCrystalReport1.LastErrorString

«si se produce un error, este código invoca un cuadro de mensajes que muestra lacadena del error.»

Comentarios

LastErrorString es una propiedad sólo en tiempo de ejecución.

Nota LastErrorString debe aparecer después de la llamada a

Action para que muestre valores relevantes. Tras imprimir elinforme, puede consultar esta propiedad para obtener unacadena de error (si la hay). Si no se produjo ningún error en laimpresión, LastErrorNumber = 0.







Disponibilidad








MarginBottomDescripción

Obtiene y establece el margen inferior para el informe especificado.


[form.]CrystalReport.MarginBottom[=MarginSetting%]

Por ejemplo:

CrystalReport1.MarginBottom = 720

«Establece un margen inferior de 1/2 pulgada para el informe (1 pulgada = 1440twips)»

Comentarios

MarginSetting% es el margen deseado, en twips.

Disponibilidad

Lectura y escritura (tiempo de diseño y de ejecución)MarginLeft

Descripción

Obtiene y establece el margen izquierdo para el informe especificado.


[form.] CrystalReport.MarginLeft[=MarginSetting%]

Por ejemplo:

CrystalReport1.MarginLeft = 1440

«Establece un margen izquierdo de 1 pulgada para el informe (1 pulgada = 1440twips)»

Comentarios


Disponibilidad


MarginRightDescripción

Obtiene y establece el margen derecho para el informe especificado.


[form.]CrystalReport.MarginRight[=MarginSetting%]

Por ejemplo:

CrystalReport1.MarginRight=1440

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







Comentarios


Disponibilidad


MarginTopDescripción

Obtiene y establece el margen superior para el informe especificado.


[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


Disponibilidad


PasswordDescripción

Introduce la contraseña necesaria para usar las tablas de la base de datos en unarchivo .mdb restringido de Access.


[form.]CrystalReport.Password[= Password$]

Por ejemplo:CrystalReport1.Password = "lluvia"

«introduce la contraseña "lluvia".»

Comentarios

Escriba la contraseña que ha asignado.

Disponibilidad


PrintDayDescripción

Obtiene y establece el componente día de la fecha de impresión (si es distinta dela fecha real en que se imprime el informe).


[form.]CrystalReport.PrintDay[=Day%]







Por ejemplo:

CrystalReport1.PrintDay = 23

«Establece 23 como día de impresión.»

Comentarios

• Escriba un valor entre 1 y 31

• Las propiedades PrintYear, PrintMonth y PrintDay funcionan juntas. Debecambiar el valor de las tres para cambiar la fecha de impresión. Si nocambia las tres, se usa la fecha de impresión guardada con el informe.Puede ser la fecha actual si no se guardó una fecha específica con elinforme.

Disponibilidad


PrinterCollationDescripción

Si especifica más de una copia para imprimir (mediante la propiedadPrinterCopies), PrinterCollation especifica si las copias se intercalarán o no.


[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 CÓDIGO CONSTANTESUncollated 0 crptUncollated

Collated 1 crptCollated

Default Collation 2 crptDefault

Disponibilidad


PrinterCopiesDescripción

Obtiene y establece el número de copias del informe a imprimir.


[form.]CrystalReport.PrinterCopies[=NumCopies%]Por ejemplo:

CrystalReport1.PrinterCopies = 3

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







Comentarios

El número utilizado para PrinterCopies no debe ser cero ni negativo.

Disponibilidad


PrinterDriverDescripción

Obtiene y establece el nombre del controlador de impresora que imprimirá elinforme.


[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 funcionanconjuntamente para definir la impresora a la que se enviará el informe. Las tres

propiedades deben establecerse para definir una nueva impresora. Si no seestablecen las tres propiedades, se usará la impresora definida en el informe.Puede ser la impresora predeterminada del usuario si no se especificó ninguna enel informe.

Disponibilidad


PrinterNameDescripción

Obtiene y establece el nombre de la impresora que imprimirá el informe.


[form.]CrystalReport.PrinterName[= PrinterName$]

Por ejemplo:

CrystalReport1.PrinterName= "Epson LQ-850"

«Especifica la impresora Epson LQ-850 »

Comentarios

Las propiedades PrinterDriver, PrinterName y PrinterPort funcionanconjuntamente para definir la impresora a la que se enviará el informe. Las tres

propiedades deben establecerse para definir una nueva impresora. Si no seestablecen las tres propiedades, se usará la impresora definida en el informe.Puede ser la impresora predeterminada del usuario si no se especificó ninguna enel informe.







Disponibilidad


PrinterPortDescripción

Obtiene y establece el nombre del puerto para la impresora especificada.


[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 seestablecen las tres propiedades, se usará la impresora definida en el informe.Puede ser la impresora predeterminada del usuario si no se especificó ninguna enel informe.

Disponibilidad


PrinterStartPageDescripción

Obtiene y establece la primera página que se va a imprimir.


[form.]CrystalReport.PrinterStartPage[= StartPage%]

Por ejemplo:

CrystalReport1.PrinterStartPage = 7

«Especifica que la impresión comenzará con la página 7 del informe.»

Comentarios

Si se usa un valor menor o igual que 0 para PrinterStartPage, el valor se pasa por alto y la impresión comienza con la página 1.

Disponibilidad


PrinterStopPageDescripción

Obtiene y establece la última página que se va a imprimir.Uso en tiempo de ejecución

[form.]CrystalReport.PrinterStopPage[=StopPage%]







Por ejemplo:

CrystalReport1.PrinterStopPage = 12

«Especifica que la impresión finalice con la página 12 del informe.»

Comentarios

Use un valor -1 para PrinterStopPage con el fin de indicar que la impresióncontinúe hasta la última página.

Disponibilidad


PrintFileCharSepQuoteDescripción

Obtiene y establece el carácter de comillas para encerrar datos de camposalfanuméricos cuando se imprime a un archivo con el formato Separado por caracteres.


[form.]CrystalReport.PrintFileCharSepQuote[=Quote$]

Por ejemplo:

CrystalReport1.PrintFileCharSepQuote = " ' "

«Usa el carácter de separación ' para encerrar valores guardados en formatoseparados por caracteres.»

Comentarios

• Aplicable sólo cuando PrintFileType es 5 - Valores separados por caracteres.

• Aplicable sólo cuando Destination es 2 - Archivo, 3 - Correo electrónico víaMAPI.

• Si se asigna una cadena a PrintFileCharSepQuote de más de un carácter, elVBX sólo emplea el primer carácter de dicha cadena. Por ejemplo, si asigna"quote" a la propiedad, el VBX sólo reconocerá "q".

Disponibilidad


PrintFileCharSepSeparatorDescripción

Obtiene y establece el o los caracteres que desea usar para separar los camposcuando se imprime a un archivo con el formato Valor separador por caracteres.


[form.]CrystalReport.PrintFileCharSepSeparator[=Separator$]

Por ejemplo:CrystalReport1.PrintFileCharSepSeparator= "@"

«Especifica que el carácter "@" se usará para separar valores de campos.»







Comentarios

• Aplicable sólo cuando PrintFileType es 5 - Valores separados por caracteres.


Disponibilidad


PrintFileNameDescripción

Especifica el nombre del archivo en el que se imprimirá el informe.


[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 botón con tres puntos delcuadro de diálogo Configuración para invocar el cuadro de diálogo Elegir nombre de archivo de impresión. En dicho cuadro de diálogo, seleccione elnombre y la ruta de acceso del archivo en el que desee imprimir el informe.

• Seleccione un valor para esta propiedad sólo si va a imprimir en un archivo (siel valor asignado a la propiedad Destination es 2 - Archivo).

Nota Si quiere especificar PrintFileName en tiempo de

ejecución, asegúrese que lo encierra entre comillas en el código.Disponibilidad


PrintFileTypeDescripción

Especifica el tipo del archivo de impresión cuando se imprima un informe a unarchivo.


[form.]CrystalReport.PrintFileType[= FileType%]

Por ejemplo:

CrystalReport1.PrintFileType = 1

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







Comentarios

Seleccione uno de los siguientes tipos de archivo de impresión 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 comaso separadores. Cada registrotiene un ancho de campo fijo.

crptRecord

1 - Tab separated Valores separador por tabuladores. Presenta losdatos en forma tabular.Encierra los datos de camposalfanuméricos entre comillasy separa los campos contabuladores.

crptTabSep

2 - Text Estilo texto. Guarda los datos

en formato de texto ASCIIcon todos los valoresseparados por espacios en

blanco. Este estilo es mássimilar a la página impresa.

crptText

3 - DIF Guarda los datos en formatoDIF (formato de intercambiode datos). Este formato sesuele utilizar para latransferencia de datos entrediferentes programas de hojade cálculo.

crptDIF

4 - CSV Valores separados por comas.

Encierra los datos de camposalfanuméricos entre comillasy separa los campos concomas.

crptCSV

5 - Character Separated Guarda los datos en formatode texto ASCII con todos losvalores separados por tabuladores.

crptCharSep

6 - Tab separated Text Guarda los datos comovalores separados por caracteres en formato de textoASCII. Todos los valores seseparan por un carácter ocaracteres especificados por la propiedadPrintFileCharSepSeparator .

crptTabSepText







7 - Crystal Reports RPT Se usa el formato RPTestándar de Crystal Reports.

Más frecuente para enviar elinforme a otro usuario por correo electrónico.

crptCrystal

8 - Excel 2.1 XLS Exporta el informe como unahoja de cálculo de MicrosoftExcel 2.1.

crptExcel21


crptExcel30


crptExcel40

11 - Lotus 1-2-3 WK1 Exporta el informe como

formato WK1 de hoja decálculo de Lotus 1-2-3.

crpt123wk1

12 - Lotus 1-2-3 WK3 Exporta el informe comoformato WK3 de hoja decálculo de Lotus 1-2-3.

crpt123wk3

13 - Lotus 1-2-3 WKS Exporta el informe comoformato WKS de hoja decálculo de Lotus 1-2-3.

crpt123wks

15 - RTF Guarda los datos en formatode texto enriquecido.

crptRTF

17 - Word for Windows Usa el formato de MicrosoftWord para Windows paraguardar los datos del informe.

crptWinWord


crptExcel50

20 - HTML 3.0 Exporta el informe enformato HTML.

crptHTML30

21 - Internet Expl Exporta el informe enformato Internet Explorer.

crptIntExpl

22 - Netscape Exporta el informe enformato Netscape.

crptNetscape

Disponibilidad








PrintFileUseRptDateFmtDescripción

Cuando se imprime en un archivo, indica si el programa debe guardar las fechasen 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.


[form.]CrystalReport.PrintFileUseRptDateFmt[= TrueFalse%]

Por ejemplo:

CrystalReport1.PrintFileUseRptDateFmt = 1

«Especifica que el programa debe imprimir las fechas en el mismo formato que elempleado en el informe.»

Comentarios

•

Aplicable sólo cuando PrintFileType es 0 - Registro, 1 - Separado por tabuladores, 3 - Formato de intercambio de datos (DIF), 4 - CSV o 5 -Separado por caracteres.


• Para TrueFalse%, use uno de los siguientes valores: False = 0, True = 1.

Disponibilidad


PrintFileUseRptNumberFmtDescripción

Cuando se imprime en un archivo, indica si el programa debe imprimir números

en el mismo formato (decimales, negativos, etc.) que se ha usado en el informe o bien optimizar los números para el formato de archivo seleccionado.


[form.]CrystalReport.PrintFileUseRptNumberFmt[=TrueFalse%]

Por ejemplo:

CrystalReport1.PrintFileUseRptNumberFmt = 1

«Especifica que el programa debe imprimir los números en el mismo formato queel empleado en el informe.»







Comentarios

• Aplicable sólo cuando PrintFileType es 0 - Registro, 1 - Separado por tabuladores, 3 - Formato de intercambio de datos (DIF), 4 - CSV o 5 -Separado por caracteres


• Para TrueFalse%, use uno de los siguientes valores: False = 0, True = 1.

Disponibilidad


PrintMonthDescripción

Obtiene y establece el componente mes de la fecha de impresión (si es diferente

de la fecha real de impresión del informe).Uso en tiempo de ejecución

[form.]CrystalReport.PrintMonth[= Month%]

Por ejemplo:

CrystalReport1.PrintMonth= 7

«Establece Julio como el mes de impresión.»

Comentarios

• Indique un valor entre 1-12 con Enero = 1, Diciembre = 12.

• Las propiedades PrintYear, PrintMonth y PrintDay funcionanconjuntamente. Debe cambiar el valor de las tres para cambiar la fecha deimpresión. Si no cambia las tres, se usará la fecha de impresión guardadacon el informe. Puede ser la fecha actual si no se guardó una fechaespecífica con el informe.

Disponibilidad


PrintYearDescripción

Obtiene y establece el componente año de la fecha de impresión (si es diferentede la fecha real de impresión del informe).


[form.]CrystalReport.PrintYear[=Year%]

Por ejemplo:CrystalReport1.PrintYear = 1994

«Establece el componente año de la fecha de impresión como 1994.»







Comentarios

• Indique el año de impresión como un número de cuatro dígitos.

• Las propiedades PrintYear, PrintMonth y PrintDay funcionanconjuntamente. Debe cambiar el valor de las tres para cambiar la fecha deimpresión. Si no cambia las tres, se usará la fecha de impresión guardadacon el informe. Puede ser la fecha actual si no se guardó una fechaespecífica con el informe.

Disponibilidad


RecordsPrintedDescripción

Determina el número de registros impresos realmente.

Uso en tiempo de ejecución[form.]CrystalReport.RecordsPrinted

Por ejemplo:

Printed& = CrystalReport1.RecordsPrinted

«Recupera el número de registros impresos y lo almacena en la variable Printed.»

Comentarios

Si el informe que se está imprimiendo contiene una o más fórmulas de selecciónde grupos, el valor retornado por RecordsPrinted puede ser mucho menor que elvalor retornado por RecordsSelected. De lo contrario, este valor debe ser igualque RecordsSelected.

Disponibilidad

Sólo lectura|tiempo de ejecuciónRecordsRead

Descripción

Determina el número de registros procesados realmente.


[form.]CrystalReport.RecordsRead

Por ejemplo:

Read% = CrystalReport1.RecordsRead

«Recupera el número de registros leídos y lo guarda en la variable Read.»

Comentarios

Si el motor de impresión de Crystal Reports genera una consulta SQL paraobtener los datos desde una base de datos SQL cuando se imprime el informe,RecordsRead sólo recuperará el número de registros recibidos por el motor deimpresión desde la consulta. Este valor puede ser mucho menor que el número deregistros reales de la tabla de la base de datos SQL.







Disponibilidad

Sólo lectura|tiempo de ejecución

RecordsSelectedDescripción

Determina el número de registros seleccionados para incluirlos en el informe delnúmero total de registros leídos.


[form.]CrystalReport.RecordsSelected

Por ejemplo:

Selected& = CrystalReport1.RecordsSelected

«Recupera el número de registros seleccionados y lo guarda en la variableSelected.»

ComentariosRecordsSelected retornará un valor entre cero y el valor retornado por RecordsRead. El valor retornado por RecordsSelected depende de las consultasy las fórmulas de selección definidas en el informe.

Disponibilidad


ReportDisplayPageDescripción

Indica qué página de un informe de varias páginas se está mostrando actualmenteen la ventana Vista previa.


[form.]CrystalReport.ReportDisplayPage

Por ejemplo:

Result% = CrystalReport1.DisplayPage

«Recupera el número de la página mostrada y lo almacena en la variable Result.»

Disponibilidad


ReportFileNameDescripción

Especifica el informe que se va a imprimir.


[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.»







Comentarios

Puede hacer doble clic en esta propiedad o en el botón con tres puntos del cuadro

Configuración para invocar el cuadro de diálogo Elegir archivo de informe. Endicho cuadro de diálogo, seleccione el nombre y la ruta de acceso del informe quequiera que imprima el programa como respuesta a un evento CRW CustomControl.

Nota Si quiere especificar ReportFileName en tiempo deejecución, asegúrese de encerrarlo entre comillas en el código.

Disponibilidad


ReportLatestPageDescripción

Determina la última página impresa del informe especificado.


[form.]CrystalReport.ReportLatestPage

Por ejemplo:

Latest% = CrystalReport1.ReportLatestPage

«Recupera el número de la última página impresa y lo almacena en la variableLatest.»

Disponibilidad


ReportSourceDescripción

Especifica de donde vendrá la plantilla del informe.Uso en tiempo de ejecución

[form.]CrystalReport1.ReportSource = [TrueFalse%]

Por ejemplo:

CrystalReport1.ReportSource = 1

Disponibilidad


ReportStartPageDescripción

Determina la primera página impresa en el informe especificado.


[form.]CrystalReport.ReportStartPage







Por ejemplo:

StartPage% = CrystalReport1.ReportStartPage

«Recupera el número de la primera página impresa y lo almacena en la variableStartPage.»

Disponibilidad

Sólo lectura|tiempo de ejecución solamente

SectionFontDescripción

Especifica la fuente para una o más secciones del informe especificado.


[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 sección de pie como 12 puntos, Arial, tachada.»

Comentarios

Con SectionFont, puede especificar cambios a una o más secciones en tiempo deejecución. Dichos cambios se producen secuencialmente cuando se efectúa lallamada "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 efectúan cambios sólo a la sección DETAIL, pero

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

CrystalReport1.SectionMinHeight(1) = "DETAIL;Arial;12;N;N;N;Y"cuando se efectúan cambios a más de una sección.

Use la siguiente tabla como guía para proporcionar los valores requeridos por esta propiedad:

PARÁMETRO TIPO DEDATOS

VALOR ESPERADO

sectionCode cadena Consulte la tabla de códigos de secciones.

fontName cadena El nombre real de la fuente; por ejemplo,Arial o Helvética

size número El tamaño de la fuente en puntos; por ejemplo, 12 ó 16

italic carácter T = Verdadero, F = Falso, X = como está1







PARÁMETRO TIPO DEDATOS

VALOR ESPERADO

bold carácter T = Verdadero, F = Falso, X = como está1underline carácter T = Verdadero, F = Falso, X = como está1

strikethru carácter T = Verdadero, F = Falso, X = como está11X (como está) usa el valor guardado con elinforme

Disponibilidad


SectionFormatDescripción

Especifica el formato para una o más secciones del informe especificado.


[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 sección Encabezado de grupo 2 (visible = F) y mantiene el valor predeterminado para todos los demás parámetros»

Comentarios

Con SectionFormat puede especificar cambios a una o más secciones en tiempode ejecución. Dichos cambios se producen secuencialmente cuando se realiza lallamada "Action=1". El valor de índice secuencial para SectionFormat

simplemente especifica el número de orden para el cambio. Así:CrystalReport1.SectionFormat(0)= "DETAIL;T;F;F;X;X;X;X"


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

cuando se efectúan cambios a más de una sección.







Use la siguiente tabla como referencia para introducir valores como parámetros para esta propiedad:

PARÁMETRO VALOR ESPERADOsectionCode Consulte la tabla de códigos de secciones.

visible T = verdadero, F = Falso, X = como está1

newPageBefore T = verdadero, F = Falso, X = como está1

newPageAfter T = verdadero, F = Falso, X = como está1

keepTogether T = verdadero, F = Falso, X = como está1

suppressBlank T = verdadero, F = Falso, X = como está1

resetPageNAfter T = verdadero, F = Falso, X = como está1

printAtPageBottom T = verdadero, F = Falso, X = como está1 1X (como está)usa el valor guardado con el informe

DisponibilidadLectura y escritura|tiempo de ejecución solamente

SectionLineHeightDescripción

Especifica el alto de línea en twips. Un twip es 1/1440 pulgadas; hay 20 twips enun punto.


[form.]CrystalReport.SectionLineHeight(SequentialIndex%)[= sectionCode; line;height; ascent$]

Por ejemplo:

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

«Establece el alto para la segunda línea de la sección cero de encabezado degrupo a un alto de 500 twips con un ascendente de 300 twips.»

Comentarios

Con SectionLineHeight puede especificar cambios a una o más secciones entiempo de ejecución. Dichos cambios se producen secuencialmente cuando serealiza la llamada "Action=1". El valor de índice secuencial paraSectionLineHeight simplemente especifica el número de orden para el cambio.Así:

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


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








Use la siguiente tabla como guía para suministrar los valores requeridos para esta propiedad:

sectionCode

Especifica el código de sección para la sección o secciones para las quedesee establecer un nuevo alto de línea.

lineN Especifica las líneas para las que desea establecer el alto de línea. Losnúmeros de línea de una sección comienzan por 0: el primer número delínea es 0, el segundo es 1, etc.

height Especifica el alto de línea en twips. Un twip equivale a 1/1440 pulgadas;hay 20 twips en un punto.

ascent Especifica la pendiente en twips. La pendiente es la distancia desde la parte superior del espacio de línea asignado (alto de línea) a la línea basede la fuente. Este parámetro se usa para especificar la posición de la líneade base si se especifica un alto de línea sobre o subdimensionado. Si seestablece la pendiente a 0, el programa sitúa la línea de base en la parte

superior del espacio; si la pendiente se establece al mismo valor que elalto, el programa establece la línea de base en la parte inferior del espacio.Para cualquier otra línea de base, especifique la pendiente en twips.

Disponibilidad

Lectura y escritura|tiempo de ejecución solamente

SectionMinHeightDescripción

Establece el alto de sección mínimo para la sección de informe especificada.


[form.]CrystalReport.SectionMinHeight(SequentialIndex%)[=sectionCode;minHeight$]

Por ejemplo:CrystalReport1.SectionMinHeight(0) = "ALL; 500"

«Establece el alto mínimo para todas las secciones a 500 twips.»

Comentarios

Con SectionMinHeight puede especificar cambios a una o más secciones entiempo de ejecución. Dichos cambios se producen secuencialmente cuando serealiza la llamada "Action=1". El valor de índice secuencial paraSectionMinHeight simplemente especifica el número de orden para el cambio.Así:

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








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

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


Disponibilidad


SelectionFormulaDescripción

Especifica los registros que se van a usar al imprimir el informe.


[form.]CrystalReport.SelectionFormulaProperty[= SelectionFormula$]

Escriba la fórmula de selección como lo haría en el Editor de fórmulas de Crystal

Reports. Por ejemplo, para incluir los registros que tienen una cantidad mayor que5 en el archivo {file.Qty}, escriba "{file.QTY} > 5" como fórmula de selección; por ejemplo, Report1.SelectionFormula = "{file.QTY} > 5"

Comentarios

• Asegúrese de que encierra la fórmula de selección entre dobles comillas.

• Si la fórmula de selección incluye comillas internas, por ejemplo:

{file.STATE} = "CA"

cambie todas las dobles comillas internas a comillas simples y encierre toda lafórmula de selección entre dobles comillas como sigue:

"{file.STATE} = 'CA'"

• Si ha creado una fórmula de selección en el informe en tiempo de diseño,

cualquier fórmula de selección que escriba aquí se agregará a dicha fórmulade selección. Así, los registros se seleccionarán según una combinación delas dos fórmulas de selección.

Disponibilidad


SessionHandleDescripción

Establece el controlador de sesión para un usuario una vez que las propiedadesUserName y Password hayan abierto un archivo.mdb de Access para usarlo en elinforme.


[form.]CrystalReport.SessionHandle[= Handle%]







Comentarios

Si ya ha abierto una sesión de Jet en la aplicación de Visual Basic, puede

establecer esta propiedad para que sea el controlador de sesión actual. De locontrario tendrá que usar las propiedades Password y UserName para establecer la sesión de Jet.

Por ejemplo:

CrystalReport1.SessionHandle = CurrentSessionHandle

«establece el controlador de sesión al controlador de sesión retornado en otra parte de la aplicación y almacenado en la variable CurrentSessionHandle.»

Disponibilidad


SortFieldsDescripción

Especifica el o los campos que se usarán para ordenar los datos cuando seimprima el informe.


[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 alfabéticamente por cliente, y después por fecha de pedido, puede escribir código similar a éste:

CrystalReport1.SortFields(0) = "+{orders.CUSTOMER}"Report1.SortFields(1) = "+{orders.ORDERDATE}"

Comentarios

• SortFields es una propiedad de matriz disponible sólo en tiempo de ejecución.

• Use una línea de código distinta para especificar cada campo de ordenación.

• Escriba los campos de ordenación en el orden en que desee ordenar el informe.Por ejemplo, si quiere ordenar el informe por el campo A y después por elcampo B, especifique el campo de ordenación A en la primera línea decódigo y el campo de ordenación B en la segunda línea de código.

• Al campo de ordenación 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 subíndices en el códigoinmediatamente después del nombre de la propiedad; por ejemplo,Report1.SortFields(0) =.

• Si ha especificado campos de ordenación para un informe en tiempo de diseño,los que escriban aquí sustituirán a los del informe.







• Si no usa esta propiedad, el programa usará las instrucciones de ordenaciónque se especificaron en el informe.







• Si quiere borrar los campos de ordenación de un informe, use una cadena vacía(Report1.SortFields(0) = "")

• Encierre los nombres de campos entre corchetes.

• Los campos de ordenación pueden ser campos de la base de datos o campos defórmula. Si ordena por un campo de fórmula, use el signo @ delante delnombre de la fórmula; por ejemplo, @FÓRMULA.

Disponibilidad


SQLQueryDescripción

Obtiene y establece la cadena de consulta SQL usada por el informe especificado.


[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 queel nombre de los autores están alfabéticamente después de Madison.»

Comentarios

Puede cambiar sólo las secciones WHERE y FROM de una consulta SQL.Aunque la propiedad requiere que se introduzca toda la consulta SQL, la secciónSELECT no debe ser diferente de la consulta original.

Disponibilidad


StatusDescripción

Determina el estado de impresión para el informe especificado.


[form.]CrystalReport.Status

Por ejemplo:

Status% = CrystalReport1.Status

«Recupera el estado de impresión 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.







Disponibilidad


StoredProcParamDescripción

Obtiene y establece los parámetros de procedimiento almacenado cuando se usaun informe basado en procedimientos almacenados de SQL.


[form.]CrystalReport.StoredProcParam(Parameter Array Index%)[=newParameter$]

Por ejemplo:

CrystalReport1.StoredProcParam(0) = "06/14/1989"

«Establece el primer parámetro de procedimiento almacenado a la fecha 14 de junio de 1989.»

Comentarios

StoredProcParam establece el valor del parámetro especificado de una tabla de base de datos SQL que está basada en un procedimiento almacenado. Pase elvalor al que quiera establecer el parámetro como cadena. Si el parámetro esperaun 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 impresión deCrystal realizará la conversión del valor a formato entero.

Disponibilidad

Lectura y escritura|tiempo de ejecución solamente.

UserNameDescripción

Introduce el nombre asignado a un usuario para conectarse a un archivo .mdb deAccess protegido con el fin de obtener los archivos de datos necesarios por elinforme.


[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.







Disponibilidad


WindowBorderStyleDescripción

Especifica el tipo de borde para la ventana de impresión.


[form.]CrystalReport.WindowBorderStyle[= BorderStyle%]

Por ejemplo:

CrystalReport1.WindowBorderStyle = 2

«establece un estilo de borde de tamaño ajustable (Style #2) para la ventana deimpresión »

Comentarios

Seleccione uno de los siguientes estilos de borde para la ventana de impresión:0 0 - NoBorder (crea una ventana sin

borde).crptNoBorder

1 1 - FixedSingle (crea una ventana detamaño fijo con un borde de líneasimple).

crptFixedSingle

2 2 - Siazable (crea una ventana que elusuario puede cambiar de tamaño).

crptSizeable

3 FixedDouble (crea una ventana detamaño fijo con un borde de línea doble).

crptFixedDouble

Disponibilidad


WindowControlBoxDescripción

Especifica si la ventana de impresión tendrá o no un cuadro de control (menú desistema) en la esquina superior izquierda cuando el informe se dirija a unaventana.


[form.]CrystalReport.WindowControlBox[= {True|False}]

Por ejemplo:

CrystalReport1.WindowControlBox = True

«especifica que aparezca un cuadro de control (menú del sistema) en la ventanade impresión.»







Comentarios

• Seleccione True si quiere que la ventana contenga un cuadro de control. De locontrario, seleccione False.

• Seleccione un valor aquí sólo si está imprimiendo hacia una ventana (siDestination = 0).

Disponibilidad


WindowControlsDescripción

Especifica si aparecerán o no controles de impresión en la ventana Vista previacuando la impresión se dirija a una ventana.


[form.]CrystalReport.WindowControls[=TrueFalse%]Por ejemplo:

CrystalReport1.WindowControls = 1

«Especifica qué controles de impresión aparecerán en la ventana Vista previa.»

Comentarios

Para TrueFalse% use uno de los siguientes: False = 0, True = 1.

Disponibilidad


WindowHeightDescripción

Establece el alto de la ventana de impresión cuando el informe se dirija a unaventana.


[form.]CrystalReport.WindowHeight[= Height%]

Por ejemplo:

CrystalReport1.WindowHeight = 300

«establece el alto de la ventana de impresión a 300 píxeles.»

Comentarios

• Si no le satisfacen los valores predeterminados, escriba el alto externo quedesee para la ventana de impresión en píxeles.

• Seleccione un valor aquí sólo si está imprimiendo en una ventana (si

Destination = 0).







Disponibilidad


WindowLeftDescripción

Establece la distancia, en píxeles, desde el borde izquierdo de la ventana principala la ventana de impresión. Si la ventana de impresión es de nivel superior, ladistancia se mide desde la izquierda de la pantalla.


[form.]CrystalReport.WindowLeft[= Distance%]

Por ejemplo:

CrystalReport1.WindowLeft = 100

«establece el borde izquierdo de la ventana de impresión a 100 píxeles desde el borde izquierdo de la pantalla.»

Comentarios

• Si no le satisface el valor predeterminado, escriba el número de píxeles quedesee que haya entre el borde izquierdo de la pantalla y el de la ventana.

• Seleccione un valor aquí sólo si está imprimiendo en una ventana (siDestination = 0).

Disponibilidad


WindowMaxButtonDescripción

Especifica si la ventana de impresión tendrá o no un botón de maximizar cuando

el informe se imprima en una ventana.Uso en tiempo de ejecución

[form.]CrystalReport.WindowMaxButton[= {True|False}]

Por ejemplo:

CrystalReport1.WindowMaxButton = False

«especifica que no aparezca el botón de Maximizar en la ventana de impresión.»

Comentarios

• Seleccione True si quiere que la ventana contenga un botón de maximizar. Delo contrario seleccione False.

• Seleccione un valor aquí sólo si está imprimiendo en una ventana (si

Destination = 0).Disponibilidad








WindowMinButtonDescripción

Especifica si la ventana de impresión tendrá o no un botón de minimizar cuandoel informe se imprima en una ventana.


[form.]CrystalReport.WindowMinButton[= {True|False}]

Por ejemplo:

CrystalReport1.WindowMinButton = True

«especifica que aparezca un botón de Minimizar en la ventana de impresión.»

Comentarios

• Seleccione True si quiere que la ventana de impresión contenga un botón deminimizar. De lo contrario, seleccione False.


Disponibilidad


WindowParentHandleDescripción

Especifica el controlador de la ventana principal si la ventana de impresión va aser secundaria de otra ventana.


[form.]CrystalReport.WindowParentHandle[= ParentHandle%]

Comentarios

Esta propiedad es sólo de tiempo de ejecución.

Por ejemplo:

CrystalReport1.WindowParentHandle = Form1.hWnd

«establece WindowParentHandle al controlador de Form1. Esto indica que laventana de impresión es secundaria de Form1»

Disponibilidad


WindowStateDescripción

Establece el estado de la ventana Vista prevista, normal, minimizada, o

maximizada, cuando el informe se dirija a una ventana Vista previa.








[form.]CrystalReport.WindowState[= State%]

Por ejemplo:CrystalReport1.WindowState= 2

«Cuando el informe se imprime en una ventana Vista previa, esta ventana aparecemaximizada cuando se abre.»

Comentarios

Use los siguientes valores para establecer la propiedad WindowState:

0 = Normal La ventana Vista previa noaparece minimizada nimaximizada. Aparece con untamaño y posición

predeterminados definidos previamente por la aplicación o por Windows.

crptNormal

1 = Minimized La ventana Vista previa apareceminimizada como un icono

junto a la esquina inferior izquierda de la pantalla. Elicono puede restaurarse paramostrar la ventana en estadonormal.

crptMinimized

2 = Maximized La ventana Vista previa semaximiza cuando se abre paraocupar toda la pantalla.

crptMaximized

Disponibilidad


WindowTitleDescripción

Especifica el título que quiera que aparezca en la barra de título de la ventana deimpresión cuando el informe se dirija a una ventana.


[form.]CrystalReport.WindowTitle[= Title$]

Por ejemplo:

CrystalReport1.WindowTitle = "Ingresos trimestrales"

«establece el título de la ventana de impresión (la cadena que aparece en la barrade título) como "Ingresos trimestrales"»







Comentarios

• Asegúrese de que el título se encierra entre comillas.

• Seleccione un valor aquí solo si está imprimiendo en una ventana (siDestination = 0).

Disponibilidad


WindowTopDescripción

Establece la distancia, en píxeles, desde el borde superior de la ventana primaria ala ventana de impresión. Si la ventana de impresión es de nivel superior, ladistancia se mide desde el borde superior de la pantalla.


[form.]CrystalReport.WindowTop[= Distance%]Por ejemplo:

CrystalReport1.WindowTop = 100

«establece el borde superior de la ventana de impresión a 100 píxeles desde la parte superior de la pantalla.»

Comentarios

• Si no está satisfecho con el valor predeterminado, escriba el número de píxelesque quiera que haya entre el borde superior de la pantalla y el de la ventana.


DisponibilidadTiempo de diseño; tiempo de ejecución

WindowWidthDescripción

Especifica el ancho de la ventana de impresión en píxeles.


[form.]CrystalReport.WindowWidth[= Width%]

Por ejemplo:

CrystalReport1.WindowWidth = 480

«especifica un ancho de ventana de impresión de 480 píxeles.»






Comentarios

• Si no está satisfecho con el valor predeterminado, escriba el ancho externo dela ventana, en píxeles.


Disponibilidad


Métodos del control ActiveX CrystalPrintReport

Descripción

PrintReport inicia la impresión del informe.


[form.]CrystalReport.PrintReport

Por ejemplo:

Result% = CrystalReport1.PrintReport

«imprime el informe especificado.»

Comentarios

• PrintReport retorna un código de resultado, 0 si la llamada es satisfactoria, uncódigo de error en el intervalo 20XXX si falla.

• También puede imprimir un informe mediante la propiedad Action. Sinembargo, si algo va mal, se obtiene un error de ejecución que finalizará la

aplicación. Por esta razón, necesitará instalar un controlador de error.

Disponibilidad


Documents

Leccion 11.6-ActiveX