OpenOffice.org Guía básica del programador

Transcripción

1 OpenOffice.org Guía básica del programador Traducción Arturo Garro de Basic Programmer's Guide del StarOffice 6.0 Revisión de Julio 2003 Escrita en OpenOffice.org 643c (Windows) y (Linux) Se terminó de escribir en OpenOffice.org RC4 (Linux y Windows)

2

3 Copyrights y marcas registradas. Sun Microsystems, Inc. has intellectual property rights relating to technology embodied in the product that is described in this document. In particular, and without limitation, these intellectual property rights may include one or more of the U.S. patents listed at and one or more additional patents or pending patent applications in the U.S. and in other countries. This document and the product to which it pertains are distributed under licenses restricting their use, copying, distribution, and decompilation. No part of the product or of this document may be reproduced in any form by any means without prior written authorization of Sun and its licensors, if any. Third-party software, including font technology, is copyrighted and licensed from Sun suppliers. This product is based in part on the work of the Independent JPEG Group and The FreeType Project. Portions Copyright 2000 SuSE, Inc. Word for Word Copyright 1996 Inso Corp. International CorrectSpell spelling correction system Copyright 1995 by Lernout & Hauspie Speech Products N.V. All rights reserved. Sun, Sun Microsystems, the Sun logo, Java, Solaris, StarOffice, the Butterfly logo, the Solaris logo, and the StarOffice logo are trademarks or registered trademarks of Sun Microsystems, Inc. in the U.S. and other countries. UNIX is a registered trademark in the U.S. and in other countries, exclusively licensed through X/Open Company, Ltd. Screen Beans and Screen Beans clipart characters are registered trademarks of A Bit Better Corporation. Federal Acquisitions: Commercial Software - Government Users Subject to Standard License Terms and Conditions. DOCUMENTATION IS PROVIDED "AS IS" AND ALL EXPRESS OR IMPLIED CONDITIONS, REPRESENTATIONS AND WARRANTIES, INCLUDING ANY IMPLIED WARRANTY OF MERCHANTABILITY, FITNESS FOR FOR A PARTICULAR PURPOSE OR NON-INFRINGEMENT, ARE DISCLAIMED, EXCEPT TO THE EXTENT THAT SUCH DISCLAIMERS ARE HELD TO BE LEGALLY INVALID. Sun Microsystems, Inc. a les droits de propriété intellectuels relatants à la technologie incorporée dans ce produit. En particulier, et sans la limitation, ces droits de propriété intellectuels peuvent inclure un ou plus des brevets américains énumérés à et un ou les brevets plus supplémentaires ou les applications de brevet en attente dans les Etats - Unis et les autres pays. Ce produit ou document est protégé par un copyright et distribué avec des licences qui en restreignent l'utilisation, la copie, la distribution, et la décompilation. Aucune partie de ce produit ou document ne peut être reproduite sous aucune forme, par quelque moyen que ce soit, sans l'autorisation préalable et écrite de Sun et de ses bailleurs de licence, s'il y ena. Le logiciel détenu par des tiers, et qui comprend la technologie relative aux polices de caractères, est protégé par un copyright et licencié par des fournisseurs de Sun. Ce produit repose en partie sur le travail de l Independent JPEG Group et de The FreeType Project. Portions Copyright 2000 SuSE, Inc. Word for Word Copyright 1996 Inso Corp. Système de correction orthographique International CorrectSpell Copyright 1995 de Lernout & Hauspie Speech Products N.V. Tous droits réservés. Sun, Sun Microsystems, le logo Sun, Java, Solaris, StarOffice, le logo Butterfly, le logo Solaris et le logo StarOffice sont des marques de fabrique ou des marques déposées de Sun Microsystems, Inc. aux Etats-Unis et dans d'autres pays. UNIX est une marque déposée aux Etats-Unis et dans d'autres pays et licenciée exlusivement par X/Open Company, Ltd. Les Screen Beans et les objets graphiques prédessinés Screen Beans sont des marques déposées de A Bit Better Corporation. Acquisitions fédérales : logiciel commercial ; les utilisateurs gouvernementaux sont soumis aux conditions générales standard de la licence. LA DOCUMENTATION est fournie «TELLE QUELLE» et TOUTES LES CONDITIONS, REPRÉSENTATIONS ET GARANTIES EXPRESSES OU TACITES, Y COMPRIS TOUTE GARANTIE TACITE CONCERNANT LA QUALITÉ MARCHANDE, L'APTITUDE À UN USAGE PARTICULIER OU LA NON-VIOLATION DE DROITS DE TIERS SERONT REJETÉES, EXCEPTÉ DANS LE CAS OÙ L'EXCLUSION OU LA LIMITATION DE TELLES GARANTIES NE SERAIT PAS AUTORISÉE PAR LA LÉGISLATION EN VIGUEUR. Traducción Arturo Garro. Realizado especialmente para la comunidad en español de OpenOffce.org. arturog@costarricense.cr Dedico esta traducción a mi esposa y mis hijos. Porque me comprendieron y me dieron el tiempo necesario para poder terminarla. Gracias Rebeca por llevarme comida mientras trabajaba en esto. A Jose Ricardo y Ariana, por dejar de jugar en la computadora y cedermela para poder trabajar. Y sobre todo por el tiempo que no les dediqué por este proyecto. i

4 Acerca de OpenOffice.org Basic 1 Posibles usos de OpenOffice.org Basic 2 Uso de OpenOffice.org Basic 2 Estructura de esta guía 2 Más información 3 Un vistazo de la programación en OpenOffice.org Basic. 5 Líneas de programación 5 Comentarios 6 Marcadores 6 Trabajado con variables 7 Declaración implicita de variables 7 Declaración explícita de variables 7 Cadenas (string) 8 De un conjunto de caracteres ASCII a Unicode 9 Variables de cadenas 9 Especificación de cadenas específica. 10 Números 10 Variables de enteros 10 Variables de entero largo 11 Variables sencillas 11 Variables dobles 11 Variables de moneda 11 Especificación explícita de números 12 Falso y verdadero 13 Variables boleanas 13 Detalles sobre la hora y la fecha 14 Variables de fecha 14 Campos de datos 14 Matrices simples 14 Especificando un valor para el índice inicial 15 Campos de datos multi-dimensionales 15 Cambios dinámicos en las dimensiones de los campos de datos 16 Alcance y tiempo de vida de las variables 17 Variables locales 17 Variables públicas 17 Variables globales 18 Variables privadas 18 Constantes 19 Operadores 19 Operadores matemáticas 19 Operadores lógicos 20 ii

5 Operadores de comparación 20 Control de flujo 20 If... Then... Else 20 Select... Case 21 Ciclos 22 For... Next 22 Do... Loop 23 Ejemplo de programación: Ordenando con ciclos anidados. 24 Procedimientos y funciones 25 Procedimientos 25 Funciones 25 Terminando procedimientos y funciones prematuramente 26 Pasando parámetros 26 Parámetros opcionales 27 Manejo de errores 28 La Instrucción On Error 28 El comando Resume 28 Consultas referentes a la información de errores 29 Consejos para el manejo de errores estructurado 29 Funciones de conversión 31 Conversiones de tipo implícito y explícito 31 Verificando el contenido de las variables 33 Cadenas 34 Trabajando con conjuntos de caracteres 34 Accesando partes de una cadena 35 Búsqueda y reemplazo 35 Formateando cadenas 36 Fecha y hora 37 Especicación de los detalles de fecha y hora dentro del código del programa 37 Extrayéndo detalles de fecha y hora. 38 Accesando la fecha y la hora del sistema 39 Archivos y directorios 40 Administrando archivos 40 Escribiendo y leyéndo archivos de texto 43 Otras funciones 47 Beep 47 Shell 47 Wait 47 Environ 48 Red de Objetos Universal (UNO) 49 Propiedades y métodos 50 Propiedades 50 Métodos 50 iii

6 Módulos, servicios e interfaces 51 Herramientas para el trabajo con UNO 51 El método supportsservice 52 Propiedades de depuración 52 Referencia API 52 Un vistazo de algunas interfaces centrales. 52 Creando objetos dependientes del contexto 53 Acceso por nombre a objetos subordinados 53 Acceso basado en índices a objetos subordinados 55 Acceso iteractivo a objetos subordinados 55 El StarDesktop 57 Información básica acerca de los documentos en OpenOffice.org 58 Crear, abrir e importar documentos 59 Objetos de documentos 61 Pantillas 65 Detalles sobre varias opciones de formato 66 La estructura de los documentos de texto 67 Párrafos y porciones de párrafos 68 Editando documentos de texto 74 El TextCursor 75 Búscando porciones de texto 79 Reemplazando porciones de texto 81 Documentos de texto: más que sólo texto 82 Tablas 83 Marcos de texto 87 Campos de texto 89 Marcadores 92 La estructura de documentos basados en tablas (Hojas de cálculo) 95 Hojas de cálculo 95 Filas y columnas 96 Celdas 98 Formateado 103 Editando las hojas de cálculo de manera eficiente 113 Rangos de celdas 113 Buscando y reemplazando contenidos de las celdas 115 La estructura de los dibujos 116 Páginas 116 Propiedades elementales de los objetos de dibujo 118 Un vistazo a varios objetos de dibujo 126 Agrupando objetos 132 iv

7 Rotando y recorte de objetos de dibujo 133 Búsqueda y reemplazo 133 Presentaciones 134 Trabajando con presentaciones 134 Usando diagramas en hojas de cálculo. 137 La estructura de los diagramas 138 Los elementos individuales de un diagrama 138 Ejemplo 144 Tipos de diagramas 145 Diagramas de líneas 145 Diagramas de área 145 Diagramas de barras 145 Diagramas de pastel 146 SQL: un lenguaje de consultas 147 Tipos de acceso a bases de datos 148 Fuentes de datos 148 Consultas 150 Vínculos y formularios de bases de datos 151 Acceso a bases de datos 151 Interacción de las tablas 152 Métodos específicos-al-tipo para obtener datos 153 Las variantes a ResultSet 154 Métodos de navegación en ResultSets 155 Modificando registro de datos 155 Tabajando con diálogos 157 Creando diálogos 157 Cerrando diálogos 157 Accesando elementos de control individuales 158 Trabajando con el modelo de diálgos y los controles de elementos 158 Propiedades 159 Nombre y título 159 Posición y tamaño 159 Foco y secuencia del tabulador 160 Diálogos de multi-página 160 Eventos 163 Parámetros 165 Eventos del Mouse 166 Eventos del teclado 167 Eventos de foco 168 Eventos específicos de los elementos de control 168 v

8 Elementos de control de los diálogos en detalle 169 Botones (buttom) 170 Botones de opciones (Option button) 170 Cajas de verficación (Checkboxes) 171 Campos de texto (text fields) 172 Cajas de listas (List Boxes) 173 Trabajar con formularios 175 Determinando los objetos de formularios 175 Tres aspectos de los elementos de control de un formulario 176 Accesando el Modelo de los elementos de contro de los formularios 176 Accesando la vista de los elementos de control de los formularios 177 Accesando el objeto formas de los formularios de elementos de control 178 Elementos de control de formularios en detalle 179 Botones 179 Botones de opción 180 Cajas de chequeo (Checkboxes) 181 Campos de texto 182 Cajas de listas 183 Formularios de bases de datos 184 Tablas 185 vi

9 OpenOffice.org Guía del programador BASIC Esta guía provee una introducción a la programación con OpenOffice.org Basic e indica las posibles aplicaciones provistas al usar OpenOffice.org Basic en OpenOffice.org. Para obtener lo mejor de este libro, debería estar familiarizado con otros lenguajes de programación. Varios ejemplos son provistos para ayudarle a desarrollar sus propios programas en StarBasic. Un número de consejos de migración para los programadores de Microsoft Visual Basic o para aquellos que han trabajado con versiones menores de StarOffice, son provistos atraves de esta guía. Están indicados por un pequeño símbolo en el borde de la página. El apéndice de esta guía contiene un índice de consejos de migración de manera que pueda navegar fácilmente al consejo que desea leer. Acerca de OpenOffice.org Basic El lenguaje de programación OpenOffice.org Basic ha sido desarrollado especialmente para OpenOffice.org (OpenOffice.org) y está firmemente integrado en el paquete de oficina. Como el nombre lo sugiere, OpenOffice.org Basic es un lenguaje de programación de la familia Basic. Cualquiera que haya trabajado previamente con otros lenguajes de Basic en particular con Visual Basic o Visual Basic para Aplicaciones (VBA) de Microsoft puede acostumbrarse fácilmente a OpenOffice.org Basic. Grandes secciones de las construcciones básicas de OpenOffice.org Basic son compatibles con Visual Basic. El lenguaje de programación OpenOffice.org Basic puede ser dividido en cuatro secciones: : Define las construcciones lingüisticas elementales, or ejemplo, declaraciones de variables, ciclos, y funciones. : Provee funciones estandares que no tienen referencia con OpenOffice.org, por ejemplo, funciones para edición de números, cadenas, valores de fecha, y archivos. : Permite el acceso a documentos de OpenOffice.org y permite que sean creados, salvados, modificados e impresos. : Crea ventanas de diálogo presonalizadas y provee un entorno para agregar elementos de control y manejadores de eventos. Capítulo 1 Introducción

10 Capítulo 1 Introducción La compatibilidad entre OpenOffice.org Basic y VBA está relacionada con el lenguaje del OpenOffice.org Basic y con las librerías en tiempo de ejecución. La API de OpenOffice.org y el editor de diálogos no son compatibles con VBA (estandarizar estas interfaces haría que muchos de los conceptos provistos por OpenOffice.org sean imposibles) Posibles usos de OpenOffice.org Basic El fuerte de las aplicaciones de OpenOffice.org Basic inicia cuando las funciones estadard de OpenOffice.org terminan. Tareas rutinarias pueden ser automatizadas en OpenOffice.org Basic, vínculos a otros programas por ejemplo, servidores de bases de datos y actividades más complejas pueden ser realizadas el presionar un botón usando scripts predefinidos. OpenOffice.org Basic ofrece acceso completo a todas las funciones de OpenOffice.org, soporta todas las funciones, modifica tipos de documentos, y provee opciones para crear ventanas de diálogo personalizadas. Uso de OpenOffice.org Basic El OpenOffice.org Basic puede ser usado por cualquier OpenOffice.org u OpenOffice.org sin necesidad de programas adicionales o ayudas especiales. En la instalación standar, OpenOffice.org Basic tiene los componentes necesarios para crear sus propias macros de Basic, incluyéndo: que provee un editor para crear y probar las macros. el cual es necesario para ejecutar las macros. a varias aplicaciones de OpenOffice.org, que permite el acceso directo a los documentos de Office. Estructura de esta guía Los primeros tres capítulos introducen al lector al OpenOffice.org Basic: Capítulo 2: El lenguaje de OpenOffice.org Basic. Capítulo 3: La librería de tiempo de ejecución de OpenOffice.org Basic. Capítulo 4: Introducción a la API de OpenOffice.org. Estos tres capítulos ofrecen un vistaso del OpenOffice.org Basic y puede ser leído por cualquiera que intente escribir programas en OpenOffice.org Basic. Los capítulos restantes describen componentes individuales de la API de OpenOffice.org con más detalle y pueden ser leídos selectivamente según lo requiera. Capítulo 5: Trabajando con documentos de OpenOffice.org Capítulo 6: Documentos de texto. OpenOffice.orgOpenOffice.org Guía del programador BASIC

11 Capítulo 7: Documentos de hoja de cálculo. Capítulo 7: Dibujos y Presentaciones. Capítulo 8: Diagramas (Gráficos) Capítulo 9: Acceso a base de datos. Capítulo 10: Diálogos. Capítulo 11: Formularios. Más información OpenOffice.org Guía del programador BASIC Los componentes de OpenOffice.org API que están discutidos en esta guía fueron seleccionados basados en el beneficio práctico para el programador de OpenOffice.org Basic. En general, sólo las partes referentes a las interfaces son discutidas. Para más detalle, vea la referencia a las API que está disponible en Internet en: La Guía del Desarrollador describe las API de OpenOffice.org con más detalle que esta guía, pero está principalmente orientada a los programadores de Java o C++. Cualquiera que esté realmente familiarizado con la programación en OpenOffice.org Basic puede encontrar información adicional en la Guía del Desarrollador en OpenOffice.org Basic y programación de OpenOffice.org. Puede descargar la Guía del Desarrollador desde Internet desde: Los programadores que deseen trabajar directamente en Java y C++ en lugar de OpenOffice.org Basic deben consultar la Guía del Desarrollador de OpenOffice.org en lugar de esta guía. La programación de OpenOffice.org con Java o C++ es considerablemente más compleja que la programación con OpenOffice.org Basic. Capítulo 1 Introducción

12

13 OpenOffice.org Guía del programador BASIC El OpenOffice.org Basic pertenece a la familia de lenguajes de Basic. Muchas partes son idénticas a Microsoft Visual Basic para Aplicaciones y a Microsoft Visual Basic. Cualquiera que haya trabajado con estos lenguajes puede rápidamente acostumbrarse a OpenOffice.org Basic. Programadores de otros lenguajes como Java, C++, o Delphi pueden encontrar fácil familiarizarse por sí mismos con OpenOffice.org Basic. OpenOffice.org Basic es un lenguaje de programación totalmente desarrollado a procedimientos y no usa estructuras de control rudimentarias como GoTo y GoSub. También puede beneficiarse de las ventajas de un lenguaje orientado a objetos desde que la interface en OpenOffice.org Basic permite el uso de librerias de objetos externos. La API de OpenOffice.org Basic está enteramente basada en estas interfaces, que están descritas con más detalle en los siguientes capítulos de este documento. Este capítulo provee un vistazo en los elementos primarios y constructores del lenguaje OpenOffice.org Basic, también el ambiente en el que estas aplicaciones y librerías están orientadas al OpenOffice.org Basic. Un vistazo de la programación en OpenOffice.org Basic. OpenOffice.org Basic es un lenguaje interpretado. A diferencia de C++ o TurboPascal, el compilador de OpenOffice.org Basic no crea un ejecutable o archivos autoextraibles capaces de ejecutarse automáticamente. En cambio, puede ejecutar un programa en OpenOffice.org Basic al presional un botón. El código es primero verificado de errores obvios y ejecutado línea por línea. Líneas de programación El Interprete de Basic está orientado a la ejecución de líneas y esto es una diferencia primaria entre Basic y otros lenguajes de programación. Mientras la posición de puntos de interrupción en el código fuente de Java, C++ o Delphi es irrelevante, cada línea de código en un programa Basic es una unidad auto-contenida. Las llamadas a funciones, expresiones matemáticas, u otros elementos lingüisticos, como las funciones y encabezados de ciclos, pueden ser completados en la misma línea en la que empezaron. Si no hay suficiente espacio, o resulta en líneas muy largas, entonces varias líneas pueden ser unidas al agregar rayabajos _ (underscore). El siguiente ejemplo muestra cómo cuatro líneas de una expresión matemática pueden ser unidas: Capítulo 2 El lenguaje de OpenOffice.org Basic

14 Capítulo 2 El lenguaje de OpenOffice.org Basic LongExpressión = (expresion1 + expresion2 ) + _ (expresion3 + expresion4 ) + _ (expresion5 + expresion5 ) + _ (expresion6 + expresion7 ) La rayabajo debe ser siempre el último carácter de la línea unida y no debe ir seguida de un espacio o tabulación, de lo contrario el código generará un error. Adicionalmente a unir líneas individuales, OpenOffice.org Basic, puede usar dos puntos (:) para dividir una línea en cada sección si hay espacio suficiente para cada expresión. Las asignaciones: a = 1 a = a + 1 a = a + 1 Puede ser escrita como sigue: a = 1 : a = a + 1 : a = a + 1 Comentarios Adicionalmente al código del programa que puede ser ejecutado, la programación en OpenOffice.org Basic puede contener comentarios que expliquen partes individuales del programa y proveer más información que puede ser de ayuda para puntos posteriores. OpenOffice.org Basic provee dos métodos para insertar comentarios en el código del programa: Todas las letras que sigan a un apóstrofe (') son tratadas como comentarios: Dim A 'Este es un comentarios para la variable A La palabra clave rem, seguida por el comentario: Rem Este comentario está dentro de la palabra clave Rem Un comentario usualmente incluye todos los caracteres desde el inicio hasta el final de la línea. OpenOffice.org Basic interpreta la siguiente línea como una instrucción normal de nuevo. Si un comentario cubre varias líneas, cada línea debe ser identificada como un comentario: Dim B ' Este comentario para la variable B es algo ' largo y comprende varias líneas. El ' carácter de comentario deberá ser repetido ' en cada línea. Marcadores Un programa de OpenOffice.org Basic puede contener, docenas, cientos y hasta algunos miles de marcadores, los cuales son nombres de variables, constantes, funciones y demás. Cuando seleccione un nombre para un marcador, se aplicarán las siguientes reglas: Los marcadores sólo pueden contener letras latinas, números y rayabajo (_). La primera letra del marcador puede ser una letra latina o una rayabajo. OpenOffice.orgOpenOffice.org Guía del programador BASIC

15 OpenOffice.org Guía del programador BASIC Los marcadores no pueden contener caracteres especiales como ä, â, í ß. El tamaño máximo de un marcador es de 255 caracteres. No hay distinción entre mayúsculas y minúsculas. El marcador OneTestVariable, por ejemplo, define la misma variable para onetestvariable y ONETESTVARIABLE. Sin embargo hay una excepción a esta regla: hay una distición hecha entre mayúsculas y minúsculas para las constantes UNO-API. Más información acerca de UNO es presentada en el capítulo 4. Las reglas de marcadores son diferentes para OpenOffice.org Basic y VBA. Por ejemplo, OpenOffice.org Basic no permiten caracteres especiales en los marcadores, porque pueden presentar problemas en proyectos internaciones. Algunos ejemplos de marcadores correctos e incorrectos: Surname ' Correcto Surname5 ' Correcto. (el número 5 no es el primer carácter Primer Nombre ' Incorrecto. Se permiten espacios. DéjàVu ' Incorrecto. Letras como é, à no están permitidas. 5Surname ' Incorrecto. El primer carácter no puede ser un número. Primer,Nombre ' Incorrecto. Las comas no están permitidas. Trabajado con variables Declaración implicita de variables Los lenguajes Basic están diseñados para que sean fáciles de usar. Como resultado, OpenOffice.org Basic permite la creación de variables por medio del simple uso sin una declaración explícita. En otras palabras, una variable empieza a exisitir desde que es incluida en su código. Dependiendo de las variables que estén presentes, el siguiente ejemplo declara tres nuevas variables: a = b + c Declarar variables implícitamente no es una buena práctica de programación porque puede resultar en la introducción de una nueva variable como resultado de un error tipográfico. En lugar de generar un error, el intérprete inicializa el error tipográfico como una nueva variable con un valor de 0. Puede ser bastante dificil encontrar errores de esta naturaleza en su código. Declaración explícita de variables Para prevenir errores causadas por la declaración implícita de variables, OpenOffice.org Basic provee una instrucción llamada: Option Explicit Esto debe ser la primera línea de programa de cada módulo y asegura que un mensaje de error será desplegado si una de las variables usadas no está declarada. La instrucción Option Explicit debe ser incluida en todos los módulos de Basic. En su forma más simple, el comando para una declaración explícita de una variable es: Capítulo 2 El lenguaje de OpenOffice.org Basic

16 Capítulo 2 El lenguaje de OpenOffice.org Basic Dim MiVariable Este ejemplo declara una variable con el nombre de MiVariable y del tipo Variant. Un tipo Variant en una variable universal que puede grabar todos los valores posibles, incluyéndo cadenas (string), números, figuras de punto flotante, y valores boleanos (boolean). Aquí hay algunos ejemplos de variables Variant: MiVar = "Hola Mundo!" ' Asigna una cadena. MiVar = 1 ' Asigna un número. MiVar = 1.0 ' Asigna un número de punto flotante. MiVar = True ' Asigna un valor boleano. Las variables declaradas en el ejemplo anterior pueden ser usadas para diferentes tipos de variables en el mismo programa. Aunque esto provee una flexibilidad considerable, es mejor restringir una variable a un solo tipo de variable. Cuando OpenOffice.org Basic encuentra una variable de un tipo incorrectamente definido en un contexto particular, un mensaje de error es generado. Use el siguiente estilo cuando desee hacer una declaración de una variable de un tipo específico: Dim MiVar As Integer ' Declara una variable del tipo entero. La variable es declarada como un entero y no puede registrar cualquier tipo de números. También puede usar el siguiente estilo para declarar una variable del tipo entero: Dim MiVar%' Declara una variable del tipo entero. La instrucción Dim puede tener varias declaraciones de variables: Dim MiVar1, MiVar2 Si desea asignar a las variables un tipo permanente, debe separar las definiciones para cada variable: Dim MiVar1 As Integer, MiVar2 As Integer Si no desea declarar el tipo para cada variable, OpenOffice.org Basic asigna el tipo Variant a cada variable. Por ejemplo, en la siguiente declaración de de variables, MiVar1 llegará a ser Variant y MiVar2 llegará a ser Integer (Entero). Dim MiVar1, MiVar2 As Integer Las siguientes secciones listan los tipos de variables que están disponibles en OpenOffice.org Basic y describe como pueden ser usadas y declaradas. Cadenas (string) Cadenas, junto con los números, forma uno de los tipos más importantes y básicos de OpenOffice.org Basic. Una cadena consiste en una secuencia consecutiva de caracteres individuales. La computadora salva internamente como una secuencia de números donde cada número representa un carácter especifico. OpenOffice.orgOpenOffice.org Guía del programador BASIC

17 OpenOffice.org Guía del programador BASIC De un conjunto de caracteres ASCII a Unicode Los conjuntos de caracteres en una cadena concuerdan con el código correspondiente (números y caracteres) en una tabla que describe como la computadora desplegará la cadena. Conjunto de caracteres ASCII El conjunto de caracteres ASCII es un juego de caracteres que representan números, caracteres, y símbolos especiales en un byte. Los códigos ASCII 0 a 127 corresponden al alfabeto y los símbolos comunes (como puntos, paréntesis y comas), también y algunos códigos especiales de pantalla e impresora. El conjunto de caracteres ASCII es el más comúnmente usado para transferir datos entre computadoras. Sin embargo, este conjunto de caracteres no incluye un rango de caracteres especiales usados en Europa, como â, ä y î, asi como otros formatos de caracteres, como el alfabeto Cirílico. Conjunto de caracteres ANSI Microsoft baso sus productos Windows en el conjunto de caracteres del Instituto Americano Nacional de Standares (ANSI 1 ), el cual fue gradualmente extendido para incluir los caracteres que fueron omitidos por el conjunto de caracteres ASCII. Códigos de página El conjunto de caracteres ISO8859 provee un standar internacional. Los primeros 128 caracteres del conjunto ISO corresponden al conjunto de caracteres ASCII. El standar ISO introduce nuevos conjuntos de caracteres (Códigos de página) de esta manera más lenguajes pueden ser correctamente desplegados. Sin embargo, como un resultado, el mismo valor del carácter puede representar diferentes caracteres en diferentes lenguajes. Unicode Unicode incrementa el tamaño de un carácter a cuatro bytes y combina diferentes conjuntos de caracteres para crear un standar que se ajuste al mayor número de lenguajes del mundo. La versión 2.0 de Unicode está soportada por muchos programas incluyéndo OpenOffice.org y OpenOffice.org Basic. Variables de cadenas OpenOffice.org Basic salva las cadenas como cadenas de variables en Unicode. Una variable de cadena puede guardar más de caracteres. Internamente, OpenOffice.org Basic salva el valor Unicode asociado a cada carácter. La memoria de trabajo necesaria para cada variable de cadena depende del tamaño de la cadena. Ejemplo de una declaración de variable de cadena: Dim Variable As String También puede ser escrita la declaración de esta forma: 1 N.T: Por las siglas en inglés de American National Standars Institute. Capítulo 2 El lenguaje de OpenOffice.org Basic

18 Capítulo 2 El lenguaje de OpenOffice.org Basic Dim Variable$ Cuando porte aplicaciones VBA, asegurese que el máximo permitido en OpenOffice.org Basic sea observado (65535 caracteres). Especificación de cadenas específica. Para asignar una cadena específica a una variable de cadena, encierre la cadena en comillas dobles ("). Dim MiCadena As String MiCadena = "Esto es una prueba" Para dividir una cadena en dos líneas, agregue un signo de más al final de la primera línea: Dim MiCadena As String MiCadena = "Esta cadena es tan larga que " + _ "que se dividió en dos líneas." Para incluir una comilla doble ( ) dentro de una cadena, ingresela doble en el punto en que desea que aparezca: Dim MiCadena As String MiCadena = "una ""- comilla doble" ' produce una "- comilla doble Números OpenOffice.org Basic soporta cinco tipos básicos para procesar números. Enteros (Integer) Entero Largo (Long Integer) Flotante (Float) Doble (Double) Moneda (Currency) Variables de enteros Las variables de enteros pueden guardar cualquier número entre y Una variable de entero puede tomar dos bytes de memoria. El símbolo de tipo de declaración es %. Los cálculos para usar las variables de enteros son muy rápidas y son particularmente útiles para contadores de ciclos. Si asigna un número de punto flotante a una variable de entero, el número será redondeado hacia arriba o hacia abajo al entero más cercano. Ejemplo de declaración para variables de enteros: OpenOffice.orgOpenOffice.org Guía del programador BASIC

19 OpenOffice.org Guía del programador BASIC Dim MiVar As Integer Dim MiVar% Variables de entero largo Las variables de entero largo pueden guardar cualquier número entre y Una variable de entero largo puede tomar cuatro bytes de memoria. El símbolo del tipo de declaración es &. Los cálculos con variables de enteros largos son muy rápidos y son particularmente útiles para contadores de ciclos. Si asigna un número de punto flotante a una variable de entero largo, el número es redondeado hacia arriba o hacia abajo al entero más cercano. Ejemplos de declaraciones de enteros largos Dim Variable As Long Dim Variable& Variables sencillas Las variables sencillas pueden guardar cualquier número de punto flotante positivo o negativo entre x y x Una variable sencilla puede tener cuatro bytes de memoria. El símbolo del tipo de declaración es!. Originalmente, las variables sencillas fueron usadas para reducir el tiempo para calcular números más precisos de las variables dobles. Sin embargo, las consideraciones de velocidad ya no se aplican, reduciendo la necesidad de las variables sencillas. Ejemplos de declaraciones de variables sencillas. Dim Variable As Single Dim Variable! Variables dobles Las variables dobles pueden guardar cualquier número positivo o negativo de punto flotante entre x y x Una variable doble puede tener ocho bytes de memoria. Las variables dobles son usadas para cálculos más precisos. El símbolo para el tipo de declaración es #. Ejemplos de declaraciones de variables dobles: Dim Variable As Double Dim Variable# Variables de moneda Las variables de moneda difieren de las demás por la forma en que maneja los valores. El punto decimal es fijo y está limitado a cuatro posiciones decimales. La variable puede contener más de 15 números después del punto decimal. Puede guardar cualquier valor entre y tomando ocho bytes de memoria. El símbolo para el tipo de declaración Las variables de moneda son más usadas para cálculos de negocios que evitan redondeos no Capítulo 2 El lenguaje de OpenOffice.org Basic

20 Capítulo 2 El lenguaje de OpenOffice.org Basic deseados por el uso de números de punto flotante. Ejemplo de declaraciones de variables de moneda: Dim Variable As Currency Dim Variable@ Especificación explícita de números Los números pueden ser representados de muchas maneras, por ejemplo, en formato decimal o en notación científica, o en cualquier base diferente al sistema decimal. Las siguientes reglas aplican a los caracteres numéricos en OpenOffice.org Basic: Números enteros El método más simple es trabajar con cualquier número entero. Estos son listados en el texto fuente sin los separadores de miles: Dim A As Integer Dim B As Float A = 1210 B = 2438 Los números pueden estar precedidos por el signo positivo (+) y/o negativo (-) (con o sin espacios en medio): Dim A As Integer Dim B As Float A = B = Números decimales Cuando use un número decimal, use el punto (.) como separador de punto decimal. Esta regla asegura que los textos fuentes pueden ser transferidos de un país a otro sin necesidad de conversión. Dim A As Integer Dim B As Integer Dim C As Float A = ' Es redondeado B = ' Es redondeado C = También puede usar los signos positivos (+) o negativo (-) antes de los números decimales. (de nuevo, con o sin espacios). Si un número decimal es asignado a una variable entera, OpenOffice.org Basic redondea el número hacia arriba o hacia abajo. Estilo de escritura exponencial OpenOffice.org Basic permite que los números sean escritos en el estilo de escritura exponencial, por ejemplo, puede escribir 1.5e-10 para el número ( ). La letra e puede ser en mayúsculas o en minúsculas con o sin el signo positivo (+) como prefijo. OpenOffice.orgOpenOffice.org Guía del programador BASIC

21 OpenOffice.org Guía del programador BASIC Aquí hay unos cuantos ejemplos correctos o incorrectos del formato exponencial: Dim A As Double A = 1.43E2' Correcto A = E2 ' Correcto (espacio entre el positivo y el número) A = E2 ' Correcto (especio entre el negativo y el número) A = 1.43E-2 ' Correcto (exponente negativo) A = 1.43E -2 A = 1,43E-2 A = 1.43E2.2 'Incorrecto (No se permiten espacios en el número) 'Incorrecto (La coma no es separador decimal) 'Incorrecto (Exponente debe ser un número simple) Nótese que los ejemplos incorrectos primero y tercero no generarán mensaje de error, sino que las variables tendrán valores incorrectos. La expresión A = 1.43E -2 es interpretada como 1.43 menos 2, que corresponde al valor Sin embargo, el valor 1.43 * 10 2 (correspondiente a ) fue el valor que se buscaba. Con el valor: A = 1.43E2.2 OpenOffice.org Basic ignora la parte decimal del exponente y se interpreta la expresión como: A = 1.43E2 Valores hexadecimales En el sistema hexadecimal (sistema base 16), un número de dos dígitos corresponde precisamente a un byte. Esto permite que los números sean manejados de una manera que refleja de una forma más cercana la arquitectura de la computadora. En el sistema hexadecimal, los números del 0 al 9 y las letras de la A a la F son usadas como números. Una A es el standard para el número decimal 10, mientras la F representa el número decimal 15. OpenOffice.org Basic le permite usar los valores hexadecimales, si están precedidos por &H. Dim A As Long A = $HFF ' Valor hexadecimal para el número decimal 255 A = $H10 ' Valor hexadecimal para el número decimal 16 Valores octales OpenOffice.orgOpenOffice.org Basic también entiende el sistema octal (sistema base 8), el cual usa los números del 0 al 7. Puede representar estos números son el prefijo &O. Dim A As Long A = &O77 ' Valor octal para el número decimal 63 A = &O10 ' valor octal para el número decimal 8 Falso y verdadero Variables boleanas Las variables boleanas sólo pueden contener dos valores: Verdadero o Falso. Son útiles para especificaciones binarias que solamente pueden adoptar dos estados. Un valor boleano Capítulo 2 El lenguaje de OpenOffice.org Basic

22 Capítulo 2 El lenguaje de OpenOffice.org Basic en guardado internamente como un entero de dos bytes, donde 0 corresponde a Falso y cualquier otro valor corresponde a Verdadero. No hay simbolo de declaración para las variables boleanas. La declaración puede realizarse simplemente usando As Boolean. Ejemplo de una declaración de una variable boleana: Dim Variable As Boolean Detalles sobre la hora y la fecha Variables de fecha Las variables de fecha pueden contener valores de fecha y hora. Cuando se salvan los datos, OpenOffice.org Basic usa formato interno que permite las comparaciones y las operaciones matemáticas en los valores de hora y fecha. No hay símbolo de declaración para las variables de fecha. La declaración puede realizarse usando el suplemento As Date. Ejemplo de una declaración de variable de fecha: Dim Variable As Date Campos de datos Adicionalmente a las variables simples (scalars), OpenOffice.org Basic soporta también campos de datos (arrays 2 ). Un campo de datos contiene varias variables, las cuales pueden ser direccionadas atraves de un índice. Matrices simples La declaración de una matriz es similar a la declaración de una variable simple. Sin embargo, a diferencia de la declaración de la variable, el nombre de la matriz está seguido de paréntesis que contiene la especificación del número de elementos. La expresión: Dim MiMatriz(3) declara una matriz con cuatro variables del tipo Variant, llamadas MiMatriz(0), MiMatriz(1), MiMatriz(2), MiMatriz(3). También se pueden declarar variables de un tipo específico para una matriz. Por ejemplo, la siguiente línea declara una matriz con cuatro elementos enteros: Dim MiMatriz(3) As Integer En los ejemplos previos, el índice para la matriz siempre inicia con el valor standar de cero. Como una alternativa, un rango de validación con valores de inicio y final pueden ser especificados en la declaración deñ campo de datos. El siguiente ejemplo declara un campo de datos con seis valores enteros que pueden ser direccionados usando los índices del 5 al 10: 2 N.T. El término en español es arreglos o matrices. Arreglos es una traducción más literal y matrices es una traducción que corresponde más al concepto matemático. Usaremos matrices de ahora en adelante. OpenOffice.orgOpenOffice.org Guía del programador BASIC

23 OpenOffice.org Guía del programador BASIC Dim MiMatriz(5 to 10) Los índices no necesitan ser valores positivos. El siguiente ejemplo también muestra una forma correcta de declaración, pero con límites del campo de datos negativos: Dim MiMatriz(-10 to -5) Declara un campo de datos del tipo entero con seis valores que pueden ser direccionados usando los índices -10 al -5. Hay tres límites que debe observar cuando defina los índices de los campos de datos: El índice más pequeño posible es El índice más grande posible es El número máximo de elementos (dentro de una dimensión de campo de datos) es Otros valores de limites aplican para los índices de datos en VBA. Lo mismo aplica al máximo número de elementos posibles por dimensión. Los valores válidos pueden ser encontrados en la documentación relevante a VBA. Especificando un valor para el índice inicial El índice inicial usualmente inicia con el valor 0. Alternativamente, puede cambiar el índice inicial para todas las declaraciones de campos de datos al valor de 1 usando la siguiente llamada: Option Base 1 La llamada puede ser incluida en el encabezado de un módulo si desea que se aplique en todas las declaraciones de matrices en el módulo. Sin embargo, esto no afecta las secuencias UNO que estén definidas por medio del API de OpenOffice.org, cuyos índices siempre inician con 0. Para no afectar la claridad, debería evitar el uso del Option Base 1. El número de elementos en una matriz no es afectado si usa Option Base 1, solamente el índice inicial cambia. La declaración: Option Base 1 '... Dim MiMatriz(3) As Integer declara 4 variables del tipo entero que pueden ser llamadas con las siguientes direcciones: MiMatriz(1), MiMatriz(2), MiMatriz(3) y MiMatriz(4). En OpenOffice.org Basic, la expresión Option Base 1 no afecta el número de elementos en un arreglo, como si sucede en VBA. Es el índice inicial el que se mueve en OpenOffice.org Basic. Mientras que la declaración MiMatriz(3) crea tres valores enteros en VBA con los índices del 1 al 3, la misma declaración en OpenOffice.org Basic crea cuatro valores enteros con los índices del 1 al 4. Campos de datos multi-dimensionales Además de los campos de datos de una sola dimensión, OpenOffice.org Basic también soporta trabajar con campos de datos multi-dimensionales. Las dimensiones correspondientes están separadas unas de otras por medio de comas. El ejemplo: Capítulo 2 El lenguaje de OpenOffice.org Basic

24 Capítulo 2 El lenguaje de OpenOffice.org Basic Dim MiMatrizInt(5, 5) define una matriz del tipo entero con dos dimensiones, cada una con 6 índices (que pueden ser direccionados del 0 al 5). La matriz completa puede grabar un total de 6 x 6 = 36 valores enteros. Aunque puede definir cientos de dimensiones de matrices en OpenOffice.org Basic; sin embargo, la cantidad disponible de memoria limita el número de dimensiones que puede tener. Cambios dinámicos en las dimensiones de los campos de datos Los ejemplos previos están basados en los campos de datos de una dimensión específica. También se pueden definir matrices en las cuales las dimensiones del campo de datos puede cambiar dinámicamente. Por ejemplo, puede definir una matriz que para contener todas las palabras que inician con la letra A. Como el número de palabras inicialmente es desconocido, necesitará poder cambiar consecuentemente los límites de la matriz. Para hacer esto en OpenOffice.org Basic, use la siguiente instrucción: ReDim MiMatriz(10) A diferencia de VBA, donde puede solo dimensionar matrices dinámicas por el uso de Dim MiMatriz(), OpenOffice.org Basic le permite cambiar matrices dinámicas y estáticas con el uso de ReDim. El siguiente ejemplo cambia las dimensiones de la matriz inicial de manera que pueda guardar 11 o 21 valores: Dim MiMatriz(4) As Integer '... 'Declaración con cinco valores Redim MiMatriz(10) As Integer 'Incrementa a 11 elementos '... Redim MiMatriz(20) As Integer 'Incrementa a 21 elementos Cuando restaura las dimensiones de una matriz, puede usar cualquiera de las opciones presentadas en las secciones previas. Esto incluye campos de datos multi-dimensionales y especificar los valores de inicio y final. Cuando las dimensiones de un campo de datos son cambiados, todo su contenido se pierde. Si desea mantener los valores originales, use el comando Preserve: Dim MiMatriz(10) As Integer '... 'Define la dimensión inicial ReDim Preserve MiMatriz(20) As Integer ' Incrementa el campo ' de datos reteniendo ' los valores iniciales Cuando usa Preserve, asegúrese que el número de dimensiones y el tipo de la variable se mantenga igual. OpenOffice.orgOpenOffice.org Guía del programador BASIC

25 OpenOffice.org Guía del programador BASIC A diferencia de VBA, donde solamente el límite superior de la última dimensión puede ser cambiado por medio de Preserve, OpenOffice.org Basic le permite cambiar las otras dimensiones también. Si usa Redim con Preserve, debe usar el mismo tipo de datos que el especificado en la declaración original del campo de datos. Alcance y tiempo de vida de las variables Una variable en OpenOffice.org Basic tiene un alcance y un tiempo de vida limitado dentro del cual puede ser leido y usado en otros fragmentos de programa. La cantidad de tiempo que la variable es retenida, asi como la forma en que es accesada, depende de su localización específica y del tipo. Variables locales Las variables que son declaradas en una función o procedimiento son llamadas variables locales. Sub Prueba Dim MiVar As Integer '... End Sub Las variables locales solamente permanecen el tiempo en que se ejecuta la función o el procedimiento, y luego son puestas de nuevo en cero. Cada vez que la función es llamada, los valores que fueron generados anteriormente ya no están disponibles. Para mantener los valores previos, puede definir una variable como Static: Sub Prueba Static MiVar As Integer '... End Sub A diferencia de VBA, OpenOffice.org Basic se asegura que el nombre de una variable local no es usada simultáneamente como global y privada en el encabezado del módulo. Cuando porte aplicaciones VBA a OpenOffice.org Basic, debe cambiar los nombres de variables duplicados. Variables públicas Las variables públicas son definidas en la sección del encabezado de un módulo con la palabra clave Dim. Estas variables están disponibles para todos los módulos de su librería. Módulo A Capítulo 2 El lenguaje de OpenOffice.org Basic

26 Capítulo 2 El lenguaje de OpenOffice.org Basic Dim A As Integer Sub Prueba Flip Flop En Sub Sub Flip A = A + 1 En Sub Módulo B Sub Flop A = A 1 End Sub El valor de la variable A no es cambiado en la función Prueba, pero es incrementado en la función Flip y decrementado en la función Flop. Ambos cambios son hechos a la variable pública. También puede usar la palabra clave Public en lugar del Dim para declarar variables públicas: Public A As Integer Las variables públicas solamente están disponibles a la macro que están asociadas durante su ejecución y luego la variable es restaurada. Variables globales En cuanto a su función, las variables globales son similares a las variables públicas, excepto que sus valores son retenidos aún después de que la macro ha sido ejecutada. Las variables globales son definidas en el encabezado del módulo usando la palabra clave Global: Global A As Integer Variables privadas Las variables privadas están solo disponibles en el módulo en el cual está definida. Use la palabra clave Private para definir la variable: Private MiEntero As Integer Si varios módulos contienen variables privadas con el mismo nombre, OpenOffice.org Basic crea una variable diferente para cada ocurrencia del nombre. En el siguiente ejemplo, ambos módulos A y B tienen una variable privada llamada C. La función Prueba define una variable privada en el módulo A y una privada en el módulo B. Módulo A: OpenOffice.orgOpenOffice.org Guía del programador BASIC

27 OpenOffice.org Guía del programador BASIC Private C As Integer Sub Prueba AsigModuloA ' Asigna la variable C del módulo A AsigModuloB ' Asigna la variable C del módulo B MuestraVarA ' Muestra la variable C del módulo A MuestraVarB ' Muestra la variable C del módulo B End Sub Sub AsigModuloA C = 10 End Sub Sub MuestraVarA Msgbox C End Sub Módulo B: Private C As Integer Sub AsigModuloB C = 10 End Sub Sub MuestraVarB Msgbox C End Sub Constantes En OpenOffice.org Basic, use la palabra clave Const para declarar una constante: Const A = 10 También puede especificar el tipo de constante en la declaración: Const B As Double = 10 Operadores OpenOffice.org Basic comprende los operadores matemáticos, lógicos, y de comparación. Operadores matemáticas Los operadoras matemáticos pueden ser aplicados a todos los tipos numéricos, sin embargo, el operador + puede ser también usado para concatenar cadenas. + Suma de números y valores de fecha, concatenar cadenas. - Resta de números y valores de fecha. * Multiplicación de números. / División de números. \ División de números con números enteros (redondeo) ^ Elevación a exponente. Capítulo 2 El lenguaje de OpenOffice.org Basic

28 Capítulo 2 El lenguaje de OpenOffice.org Basic MOD Operación de cociente (calcula el resto o sobrante de una división) Operadores lógicos Los operadores lógicos permiten concatenar elementos de acuerdo al álbegra boleana. Si los operadores son aplicados sobre valores boleanos, el vínculo provee el resultado ruquerido directamente. Si lo usa en conjunto con valores enteros y entero largo, el vínculo será hecho a nivel de bits. AND vínculo AND OR vínculo OR XOR Vínculo OR exclusivo. NOT Negación EQV prueba equivalente (ambas partes Verdadero o Falso) IMP Implicación (Si la primera parte es verdadera, entonces la segunda parte también debe ser verdadera) Operadores de comparación Los operadores de comparación pueden ser aplicados a todos los tipos de variables elementales (números, fecha, cadenas, y valores boleanos) = Igualdad entre fechas, números y cadenas. <> Diferencia entre fechas, números y cadenas. > Mayor que para números, fechas y cadenas. >= Mayor que o igual para números, fechas y cadenas. < Menor que para números, fechas y cadenas. <= Menor que o igual para números, fechas y cadenas. OpenOffice.org Basic no soporta el operador Like de VBA Control de flujo Las instrucciones de control de flujo restringen la ejecución de bloques de código mientras una condición particular sea satisfecha. If... Then... Else La instrucción más común del control de flujo es la instrucción If, como se muestra en el siguiente ejemplo: OpenOffice.orgOpenOffice.org Guía del programador BASIC

29 OpenOffice.org Guía del programador BASIC If A > 3 Then B = 2 End If La asignación B = 2 solamente ocurre cuando el valor de la variable A es mayor que tres. Una variación de la instrucción If es la cláusula If/Else: If A > 3 Then B = 2 Else B = 0 End If En este ejemplo, la variable B es asignada al valor 2 cuando A es mayor que 3, de otra forma a B le es asignado el valor 0. Para instrucciones más complejas, puede hacer cascadas de la instrucción If, por ejemplo: If A = 0 Then B = 0 ElseIf A < 3 Then B = 1 Else B = 2 End If Si el valor de la variable A es igual a cero, a B le es asignado el valor 0. Si A es menor a 3 (pero no igual a cero), entonces a B es asignado el valor de 1. En todas las demás instancias (esto es, si A es mayor a 3), a B le es asignado el valor de 2. Select... Case La instrucción Select... Case es una alternativa a la instrucción If en cascada y es usada cuando necesita verificar un valor contra varias condiciones. Select Case DiaSemana Case 1: Nombre = "Domingo" Case 2: Nombre = "Lunes" Case 3: Nombre = "Martes" Case 4: Nombre = "Miércoles" Case 5: Nombre = "Jueves" Case 6: Nombre = "Viernes" Case 7: Nombre = "Sábado" End Select En este ejemplo, el nombre del día de la semana corresponde a un número, de manera que la variable Nombre se le asigna el valor de domingo para el valor de 1, Lunes para el valor de 2, y así consecutivamente. El comando Select no está restringido a asignaciones simples de 1:1 También puede especificar operadores de comparación o listas de expresiones en el control de flujo Case. El siguiente ejemplo muestra las variaciones de sintaxis más importantes. Capítulo 2 El lenguaje de OpenOffice.org Basic