PDF de programación - Manual de programación en Basic - StarOffice 7

StarOfficeTM 7 Office Suite
A SunTM ONE Software Offering

Manual de programación en Basic

Sun Microsystems, Inc.
4150 Network Circle
Santa Clara, CA 95054
EE.UU. 650-960-1300

Ref. 817-3923-10
2003, Revisión A

Copyrights y marcas comerciales

Copyright © 2003 Sun Microsystems, Inc., 4150 Network Circle, Santa Clara, California 95054, U.S.A. All rights reserved.

Sun Microsystems, Inc. tiene los derechos de propiedad intelectual relacionados con la tecnología incluida en este producto. En particular, y sin limitaciones, los derechos de propiedad
intelectual pueden incluir una o más de las patentes de los EE.UU. enumeradas en http://www.sun.com/patents y una o más patentes adicionales o solicitudes de patentes pendientes en los
EE.UU. y otros países.

Este documento y el producto al que pertenece se distribuyen bajo licencias que restringen su uso, copia, distribución y descompilación. No se puede reproducir parte alguna de este producto
de este documento en ninguna forma ni por cualquier medio sin la autorización previa por escrito de Sun y sus licenciadores, si los hubiera.

El software de otras empresas, incluida la tecnología de fuentes, está protegido por copyright y posee licencia exclusiva de los proveedores de Sun.

Este producto se basa en parte en el trabajo de Independent JPEG Group, The FreeType Project y Catharon Typography 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. Todos los derechos reservados.

El código fuente de algunas partes de este producto está disponible bajo la licencia de Mozilla Public License en las siguientes sedes: http://www.mozilla.org/, http://www.jclark.com/, and
http://www.gingerall.com.

Sun, Sun Microsystems, el logotipo de Sun, Java, Solaris, StarOffice, el logotipo de Solaris y el logotipo de StarOffice son marcas comerciales o marcas comerciales registradas Sun
Microsystems, Inc. en EE.UU. y otros países.

UNIX es una marca registrada en los Estados Unidos y en otros países, bajo licencia exclusiva de X/Open Company, Ltd. Screen Beans y Screen Beans son marcas comerciales registradas de A
Bit Better Corporation. International CorrectSpell es una marca comercial de Lernout & Hauspie Speech Products N.V.

Los sistemas de corrección sueco, ruso, noruego, inglés, holandés y danés son de International CorrectSpell. Copyright © 1995 by Lernout & Hauspie Speech Products N.V. Todos los derechos
reservados. La reproducción y el desensamblaje de los algoritmos incluidos y las bases de datos están prohibidos.

Los sistemas de corrección español y francés son de International CorrectSpell. Copyright © 1995 by Lernout & Hauspie Speech Products N.V. Todos los derechos reservados. Adaptados de
una lista de palabras suministrada por Librairie Larousse. La reproducción y el desensamblaje de los algoritmos incluidos y las bases de datos están prohibidos.

El sistema de corrección inglés australiano es de International CorrectSpell. Copyright © 1995 by Lernout & Hauspie Speech Products N.V. Todos los derechos reservados. Basado en The
Macquarie Dictionary, Second Revised Edition Copyright © Macquarie University NSW. La reproducción y el desensamblaje de los algoritmos incluidos y las bases de datos están prohibidos.

El sistema de corrección catalán es de International CorrectSpell. Copyright © 1995 by Lernout & Hauspie Speech Products N.V. Todos los derechos reservados. Adaptado de una lista de
palabras en catalán: Copyright © 1992 Universitat de Barcelona. La reproducción y el desensamblaje de los algoritmos incluidos y las bases de datos están prohibidos.

El sistema de corrección checo es de International CorrectSpell. Copyright © 1995 by Lernout & Hauspie Speech Products N.V. Todos los derechos reservados. Adaptado de una lista de
palabras suministrada por by Jan Hajic. La reproducción y el desensamblaje de los algoritmos incluidos y las bases de datos están prohibidos.

El sistema de corrección finlandés es de International CorrectSpell. Copyright © 1995 by Lernout & Hauspie Speech Products N.V. Todos los derechos reservados. Adaptado de una lista de
palabras suministrada por la University of Helsinki Institute for Finnish Language y el Dr. Kolbjorn Heggstad. La reproducción y el desensamblaje de los algoritmos incluidos y las bases de
datos están prohibidos.

El sistema de corrección alemán es de International CorrectSpell. Copyright © 1995 by Lernout & Hauspie Speech Products N.V. Todos los derechos reservados. Adaptado de una lista de
palabras suministrada por Langenscheidt K.G. La reproducción y el desensamblaje de los algoritmos incluidos y las bases de datos están prohibidos.

El sistema de corrección italiano es de International CorrectSpell. Copyright © 1995 by Lernout & Hauspie Speech Products N.V. Todos los derechos reservados. Adaptado de una lista de
palabras suministrada por Zanichelli S.p.A. La reproducción y el desensamblaje de los algoritmos incluidos y las bases de datos están prohibidos.

El sistema de corrección portugués es de International CorrectSpell. Copyright © 1995 by Lernout & Hauspie Speech Products N.V. Todos los derechos reservados. Partes adaptadas del
Dicionario Academico da Lingua Portuguesa Copyright © 1992 by Porto Editora. La reproducción y el desensamblaje de los algoritmos incluidos y las bases de datos están prohibidos.

Adquisiciones federales: El software comercial y los usuarios del gobierno están sujetos a los términos y condiciones de licencia estándar.

ESTA DOCUMENTACIÖN SE ENTREGA "TAL CUAL" SIN GARANTÍA DE NINGUNA CLASE, YA SEA EXPRESA O IMPLÍCITA, INCLUYENDO PERO NO LIMITÁNDOSE A LAS
GARANTÍAS IMPLÍCITAS DE COMERCIALIZACIÓN, ADECUACIÓN A UN PROPÓSITO PARTICULAR, O NO INFRINGIMIENTO, SALVO QUE AMBAS RENUNCIAS SE
CONSIDEREN NO VÁLIDAS LEGALMENTE.

Tabla de contenido

1 Introducción 11

Acerca de StarOffice Basic 11
Usuarios previstos de StarOffice Basic 12
Uso de StarOffice Basic 12
Estructura de este manual 12
Información adicional 13

2 El lenguaje de StarOffice Basic 15

Visión general de un programa de StarOffice Basic 15

Líneas de programa 15

Comentarios 16

Marcador 17

Trabajo con variables 17

Declaración de variables implícita 17

Declaración de variables explícita 18

Cadenas 19

De un juego de caracteres ASCII a Unicode 19

Variables de cadena 20

Especificación de cadenas explícitas 20

Números 21
Integer 21

Long Integer 21

Single 21

Double 22

Variables Currency 22

Especificación de números explícitos 22

Variables booleanas 24

3

Detalles de fecha y hora 25

Variables Date 25

Campos de datos 25

Matrices simples 25

Valor especificado para el índice inicial 26

Campos de datos multidimensionales 26

Cambios dinámicos en las dimensiones de los campos de datos 27

Ámbito y vida de las variables 28

Variables locales 28

Variables de dominio público 29

Variables globales 29

Variables privadas 30

Constantes 31
Operadores 31

Operadores matemáticos 31

Operadores lógicos 31

Operadores de comparación 32

Bifurcación 32

If...Then...Else 32

Select...Case 33

Bucles 34

For...Next 34

Do...Loop 35

Ejemplo de programación: Ordenación mediante bucles anidados 36

Procedimientos y funciones 37

Procedimientos 37

Funciones 37

Terminación prematura de procedimientos y funciones 38

Paso de parámetros 39

Parámetros opcionales 40

Recursión 40

Gestión de errores 41

La instrucción On Error 41

La orden Resume 42

4 StarOffice™ 7 Manual de programación en Basic

Consultas acerca de la información de errores 42

Consejos para el manejo estructurado de errores 43

3 La biblioteca de ejecución de StarOffice Basic 45

Funciones de conversión 45

Conversiones de tipos implícitas y explícitas 45

Comprobación del contenido de variables 47

Cadenas 49

Trabajo con juegos de caracteres 49

Acceso a partes de una cadena 49

Buscar y reemplazar 50

Formato de cadenas 51

Fechas y horas 52

Especificación de detalles de fecha y hora dentro del código de programa 52

Extracción de detalles de fecha y hora 53

Recuperación de la fecha y hora del sistema 54

Archivos y directorios 54

Administración de archivos 55

Escritura y lectura de archivos de texto 58

Cuadros de mensaje y de entrada 60

Presentación de mensajes 60

Cuadro de entrada para solicitar cadenas de texto sencillas 62

Otras funciones 62

Beep 62

Shell 63

Wait 63

Environ 63

4 Introducción a la API de StarOffice 65

Objetos de red universales (UNO) 65
Propiedades y métodos 66

Propiedades 66

Métodos 67

Módulo, servicios e interfaces 67
Herramientas para trabajar con UNO 68

Table of contents 5

El método supportsService 68

Propiedades de depuración 68

Guía de referencia de la API 69

Resumen de algunas de las principales interfaces 69
Creación de objetos dependientes del contexto 69

Acceso a objetos subordinados mediante el nombre 70

Acceso a objetos subordinados a través del índice 71

Acceso iterativo a objetos subordinados 72

5 Trabajo con documentos de StarOffice 73

El objeto StarDesktop 73

Información básica acerca de los documentos en StarOffice 74

Creación, apertura e importación de documentos 75

Objetos documento 77

Plantillas 81

Detalles acerca de diversas opciones de formato 82

6 Documentos de texto: 83

La estructura de los documentos de texto 83

Párrafos y fragmentos de párrafo 84

Edición de documentos de texto 91

El objeto TextCursor 91

Búsqueda de fragmentos de texto 95

Reemplazo de fragmentos de texto 98

Documentos de texto: no sólo texto 99

Tablas 100

Marcos de texto 104

Campos de texto 106

Marcadores 1