Chapitre 1 Introduction

Ce guide est une introduction à la programmation avec StarOffice^TM 8 Basic et décrit les applications fournies par StarOffice Basic dans StarOffice. Pour tirer le meilleur parti de cet ouvrage, vous devez connaître d'autres langages de programmation.

Des exemples détaillés vous sont proposés pour vous aider à développer rapidement vos propres programmes StarOffice Basic.

Organisation du manuel

Les trois premiers chapitres présentent StarOffice Basic :

Ces chapitres proposent un aperçu de StarOffice Basic et leur lecture est conseillée à toute personne souhaitant écrire des programmes StarOffice Basic.

Les autres chapitres décrivent plus en détail les différents composants de l'API StarOffice et peuvent être lus séparément selon vos besoins :

À propos de StarOffice Basic

Le langage de programmation StarOffice Basic a été développé spécialement pour StarOffice et est étroitement intégré au package Office.

Comme son nom l'indique, StarOffice Basic est un langage de programmation appartenant à la famille Basic. Les utilisateurs ayant déjà travaillé avec d'autres langages Basic, en particulier Visual Basic ou Visual Basic pour Applications (VBA) de Microsoft, se familiariseront rapidement avec StarOffice Basic. Une grande partie des structures de base de StarOffice Basic sont compatibles avec Visual Basic.

Le langage de programmation StarOffice Basic peut être divisé en quatre composants :

Le langage de StarOffice Basic, qui définit les structures linguistiques élémentaires, par exemple, pour les déclarations de variables, les boucles et les fonctions.
La bibliothèque d'exécution, qui fournit des fonctions standard n'ayant pas de référence directe avec StarOffice, par exemple, des fonctions d'édition de nombres, de chaînes, de dates et de fichiers.
L'API (Application Programming Interface) StarOffice, qui permet d'accéder aux documents StarOffice afin de les créer, de les enregistrer, de les modifier et de les imprimer.
L'éditeur de boîte de dialogue, qui permet de créer des boîtes de dialogue personnelles et d'ajouter des éléments de contrôle ainsi que des gestionnaires d'événements.

Remarque –

La compatibilité entre StarOffice Basic et VBA concerne le langage StarOffice Basic, ainsi que la bibliothèque d'exécution. L'API et l'éditeur de boîte de dialogue StarOffice ne sont pas compatibles avec VBA : la standardisation de ces interfaces aurait rendu impossibles de nombreux aspects de StarOffice.

Utilisateurs cibles de StarOffice Basic

Le champ d'application de StarOffice Basic commence là où s'arrêtent les fonctions standard de StarOffice. StarOffice Basic permet en effet d'automatiser les tâches récurrentes, d'établir des liens vers d'autres programmes (vers un serveur de base de données, par exemple) et d'exécuter les activités complexes par simple clic de bouton grâce à des scripts prédéfinis.

StarOffice Basic offre un accès complet à toutes les fonctions StarOffice, qu'il prend en charge, modifie les types de document et fournit des options de création de boîtes de dialogue personnelles.

Utilisation de StarOffice Basic

Tous les utilisateurs de StarOffice peuvent utiliser StarOffice Basic sans aucun autre programme ni aucune autre aide. L'installation standard de StarOffice Basic comprend tous les composants nécessaires à la création de macros Basic, à savoir :

L'environnement de développement intégré (IDE, Integrated Development Environment) dispose d'un éditeur pour la création et le test des macros.
L'interpréteur sert à exécuter les macros de StarOffice Basic.
Les interfaces vers diverses applications StarOffice permettent d'accéder directement aux documents Office.

Informations complémentaires

Le choix des composants de l'API StarOffice qui sont traités dans ce manuel a été effectué en fonction des avantages pratiques qu'ils apportent au programmeur StarOffice Basic. En général, les interfaces ne sont que partiellement traitées. Pour une description plus détaillée, reportez-vous à la référence de l'API disponible sur Internet à l'adresse :

http://api.openoffice.org/docs/common/ref/com/sun/star/module-ix.html

Le Developer's Guide (Guide du développeur) décrit l'API StarOffice de manière plus détaillée que ce manuel, mais est avant tout destiné aux programmeurs Java et C++. Les personnes déjà familiarisées avec la programmation StarOffice Basic pourront trouver dans le Developer's Guide des informations complémentaires sur StarOffice Basic et la programmation dans StarOffice. Vous pouvez télécharger le Developer's Guide sur Internet à l'adresse :

http://api.openoffice.org/DevelopersGuide/DevelopersGuide.html

Nous conseillons aux programmeurs qui souhaitent utiliser Java or C++ plutôt que StarOffice Basic de consulter le Developer's Guide de StarOffice. La programmation de StarOffice avec Java ou C++ est une tâche beaucoup plus complexe que dans StarOffice Basic.