PDF de programación - OpenOffice.org Guía básica del programador

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 1.0.1 (Linux)
Se terminó de escribir en OpenOffice.org 1.1.0 RC4 (Linux y Windows)

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 http://www.sun.com/patents 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 à http://www.sun.com/patents 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. e-mail: [email protected]
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





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

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

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

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 diagr