Guide de programmation deStarOffice 8 pour BASIC

Sun Microsystems, Inc.4150 Network CircleSanta Clara, CA 95054U.S.A.

Rfrence : 819132810Juin 2005

Copyright 2005 Sun Microsystems, Inc. 4150 Network Circle, Santa Clara, CA 95054 U.S.A. Tous droits rservs.

Copyright 2005 Sun Microsystems, Inc. 4150 Network Circle, Santa Clara, CA 95054 U.S.A. Tous droits rservs.

Ce produit ou document est protg par un copyright et distribu avec des licences qui en restreignent lutilisation, la copie, la distribution, et ladcompilation. Aucune partie de ce produit ou document ne peut tre reproduite sous aucune forme, par quelque moyen que ce soit, sanslautorisation pralable et crite de Sun et de ses bailleurs de licence, sil y en a. Le logiciel dtenu par des tiers, et qui comprend la technologie relativeaux polices de caractres, est protg par un copyright et licenci par des fournisseurs de Sun.

Des parties de ce produit pourront tre drives du systme Berkeley BSD licencis par lUniversit de Californie. UNIX est une marque dpose auxEtats-Unis et dans dautres pays et licencie exclusivement par X/Open Company, Ltd.

Sun, Sun Microsystems, le logo Sun, docs.sun.com, AnswerBook, AnswerBook2, et Solaris sont des marques de fabrique ou des marques dposes, deSun Microsystems, Inc. aux Etats-Unis et dans dautres pays. Toutes les marques SPARC sont utilises sous licence et sont des marques de fabrique oudes marques dposes de SPARC International, Inc. aux Etats-Unis et dans dautres pays. Les produits portant les marques SPARC sont bass sur unearchitecture dveloppe par Sun Microsystems, Inc.

Linterface dutilisation graphique OPEN LOOK et Sun a t dveloppe par Sun Microsystems, Inc. pour ses utilisateurs et licencis. Sun reconnatles efforts de pionniers de Xerox pour la recherche et le dveloppement du concept des interfaces dutilisation visuelle ou graphique pour lindustriede linformatique. Sun dtient une licence non exclusive de Xerox sur linterface dutilisation graphique Xerox, cette licence couvrant galement leslicencis de Sun qui mettent en place linterface dutilisation graphique OPEN LOOK et qui en outre se conforment aux licences crites de Sun.

CETTE PUBLICATION EST FOURNIE EN LETAT ET AUCUNE GARANTIE, EXPRESSE OU IMPLICITE, NEST ACCORDEE, Y COMPRIS DESGARANTIES CONCERNANT LA VALEUR MARCHANDE, LAPTITUDE DE LA PUBLICATION A REPONDRE A UNE UTILISATIONPARTICULIERE, OU LE FAIT QUELLE NE SOIT PAS CONTREFAISANTE DE PRODUIT DE TIERS. CE DENI DE GARANTIE NESAPPLIQUERAIT PAS, DANS LA MESURE OU IL SERAIT TENU JURIDIQUEMENT NUL ET NON AVENU.

050323@11223

Table des matires

1 Introduction 11

Organisation du manuel 11 propos de StarOffice Basic 12Utilisateurs cibles de StarOffice Basic 12Utilisation de StarOffice Basic 13Informations complmentaires 13

2 Langage de StarOffice Basic 15

Prsentation du programme StarOffice Basic 15Lignes de programme 16Commentaires 16Marqueurs 17

Utilisation des variables 18Dclaration implicite de variables 18Dclaration explicite de variables 18

Chanes de caractres 19Dun ensemble de caractres ASCII Unicode 20

Variables de chane de caractres 21

Spcification de chanes explicites 21

Nombres 22

Variables entires (Integer) 22

Variables entires longues (Long) 22

Variables simples (Single) 22

Variables doubles (Double) 23

Variables montaires (Currency) 23

Spcification de nombres explicites 23

3

True (vrai) et False (faux) 26

Variables boolennes 26

Date et heure 26

Variables de date 26

Champ de donnes 27

Matrices simples 27

Valeur spcifique pour lindex de dbut 28

Champs de donnes multidimensionnels 28

Modifications dynamiques des dimensions des champs de donnes 29

Porte et dure de vie des variables 30

Variables locales 30

Variables du domaine public 31

Variables globales 32

Variables prives 32

Constantes 33

Oprateurs 33

Oprateurs mathmatiques 33

Oprateurs logiques 34

Oprateurs de comparaison 34

Instructions conditionnelles 34

If...Then...Else 35

Select...Case 35

Boucles 36

For...Next 37

Do...Loop 38

Exemple de programme : tri laide de boucles imbriques 39

Procdures et fonctions 40

Procdures 40

Fonctions 40

Interruption prmature dune procdure ou dune fonction 42

Passage de paramtres 42

Paramtres facultatifs 43

Rcursivit 44

Traitement des erreurs 45

Instruction On Error 45

Commande Resume 46

Requtes portant sur les erreurs 46

Astuces pour le traitement derreur structur 47

4 Guide de programmation de StarOffice 8 pour BASIC Juin 2005

3 Bibliothque dexcution de StarOffice Basic 49

Fonctions de conversion 49Conversions de type implicites et explicites 49Vrification du contenu des variables 51

Chanes de caractres 53Utilisation de jeux de caractres 53Accs une partie de la chane 53Recherche et remplacement 54Formatage des chanes 55

Date et heure 57Spcification de la date et de lheure dans le code de programme 57Extraction de la date et de lheure 58Obtention de lheure et de la date systme 59

Fichiers et rpertoires 59Administration des fichiers 60criture et lecture de fichiers texte 64

Botes de message et zones de saisie 66Affichage des messages 66Zone de saisie pour demander des chanes simples 68

Autres fonctions 68Beep 68Shell 68Wait 69Environ 69

4 Introduction lAPI StarOffice 71

Universal Network Objects (UNO) 71Proprits et mthodes 72

Proprits 72Mthodes 73

Modules, services et interfaces 73Outils pour lutilisation dUNO 74

Mthode supportsService 74Proprits de dbogage 75Rfrence de lAPI 75

Prsentation de quelques interfaces centrales 75Cration dobjets contextuels 76Accs nomm aux objets subordonns 76

5

Accs par index aux objets subordonns 78Accs itratif aux objets subordonns 79

5 Utilisation de documents StarOffice 81StarDesktop 81

Informations lmentaires sur les documents StarOffice 82Cration, ouverture et import de documents 83Objets Document 86

Modles 90Informations relatives diverses options de formatage 91

6 Documents texte 93Structure des documents texte 94

Paragraphes et portions de paragraphe 94dition de documents texte 102

Objet TextCursor 102Recherche de portions de texte 106Remplacement de portions de texte 109

Documents texte : plus quun simple mot 110Tableaux 111Cadres texte 116Champs de texte 118Repres de texte 122

7 Classeurs 123Structure des documents bass sur des tables (classeurs) 123

Classeurs 124Lignes et colonnes 125Cellules 127Formatage 132

dition efficace des classeurs 142Plages de cellules 142Recherche et remplacement du contenu des cellules 145

8 Dessins et prsentations 147Structure des dessins 147

Pages 147

6 Guide de programmation de StarOffice 8 pour BASIC Juin 2005

Proprits lmentaires des objets de dessin 149Prsentation de diffrents objets de dessin 158

dition des objets de dessin 164Groupement dobjets 164Rotation et cisaillement des objets de dessin 166Recherche et remplacement 167

Prsentations 167Utilisation des prsentations 168

9 Diagrammes 169

Utilisation de diagrammes dans les classeurs 169Structure des diagrammes 171

lments individuels dun diagramme 171Exemple 176Diagrammes 3D 177Diagrammes empils 177

Types de diagrammes 178Diagrammes linaires 178Diagrammes de surface 178Diagrammes barres 179Diagrammes secteurs 179

10 Accs aux bases de donnes 181

SQL : un langage ddi aux requtes 182Types daccs aux bases de donnes 182Sources de donnes 183

Requtes 184Liaisons avec des formulaires de base de donnes 185

Accs la base de donnes 186Itration de tables 187Mthodes de rcupration des valeurs en fonction du type 188Variantes de lobjet ResultSet 189Mthodes de navigation dans les objets ResultSets 190Modification des enregistrements de donnes 190

11 Botes de dialogue 193

Utilisation des botes de dialogue 193

7

Cration de botes de dialogue 193

Fermeture des botes de dialogue 196

Accs des lments de contrle individuels 196

Utilisation du modle des botes de dialogue et des lments de contrle 197

Proprits 197

Nom et titre 197

Position et taille 198

Focus et squence de tabulation 198

Botes de dialogue plusieurs onglets 199

vnements 201

Paramtres 203

vnements de la souris 204

vnements du clavier 205

vnements du focus 206

vnements propres llment de contrle 206

Dtails des lments de contrle des botes de dialogue 207

Boutons 208

Boutons radio 209

Cases cocher 209

Champs de texte 210

Zones de liste 211

12 Formulaires 215

Utilisation des formulaires 216

Dtermination de formulaires dobjet 216

Les trois aspects dun formulaire dlments de contrle 217

Accs au modle des formulaires dlments de contrle 217

Accs la vue des formulaires dlments de contrle 218

Accs lobjet Shape des formulaires dlments de contrle 219

Dtails des formulaires dlments de contrle 220

Boutons 220

Boutons radio 221

Cases cocher 222

Champs de texte 223

Zones de liste 224

Formulaires de base de donnes 225

Tables 226

8 Guide de programmation de StarOffice 8 pour BASIC Juin 2005

Index 227

9

10 Guide de programmation de StarOffice 8 pour BASIC Juin 2005

CHAPITRE 1

Introduction

Ce guide est une introduction la programmation avec StarOffice 8 Basic et dcritles applications fournies par StarOffice Basic dans StarOffice. Pour tirer le meilleurparti de cet ouvrage, vous devez