Débuter en programmation sous OpenOffice.org

sub Programme1()

 thisComponent.Sheets.getByName("Feuille1").getCellRangeByName("A1").string="Bonjour"

end sub

Exécuter manuellement un programme

Depuis Calc, pour exécuter manuellement ce programme, il faut faire :

Exécuter le programme avec un bouton

Depuis Calc :

Créer une macro avec l’enregistreur de macros

Dans Calc :

Comparer la macro enregistrée avec la macro écrite à la main en allant dans l’éditeur :

L’enregistreur de macros se contente d’enregistrer les appels aux menus. Il n’utilise pas les objets, ce qui le rend particulièrement illisible et donc quasiment inutilisable dans la plupart des cas. Je conseille donc de ne pas l’utiliser.

Télécharger et installer la documentation de l’API

Télécharger le SDK (Software Development Kit) contenant la documentation de l’API (Application programming interface), à cette adresse :

Une fois le fichier téléchargé, il faut le rendre exécutable :

$ chmod +x OOo_2.0.3_LinuxIntel_sdk.sh

Ensuite, il faut l’exécuter pour décompresser le paquet RPM :

./ OOo_2.0.3_LinuxIntel_sdk.sh

Remarque  : Par défaut le RPM est décompressé dans « /var/tmp/unpack_openofficeorg »

Sous Debian, il faut convertir ce RPM en paquet Debian :

# alien /var/tmp/unpack_openofficeorg/RPMS/openoffice.org-sdk-2.0.3-5.i586.rpm

Et pour finir, il faut installer le paquet :

# dpkg -i openoffice.org-sdk_2.0.3-6_i386.deb

Ce paquet installe les fichiers dans le dossier suivant :

La documentation est donc disponible à cette adresse :

Télécharger et installer xRay

xRay est une macro permettant d’obtenir facilement la liste des méthodes et propriétés d’un objet.

Page de téléchargement de cet outil :

Pour installer xRay, il faut :

Tester xRay

Pour tester xRay, il faut utiliser dans un programme la commande «  xray  » suivi de l’objet à analyser.

Cette ligne analyse l’objet «  thisComponent  » et on pourra retrouver la propriété «  sheets  »

xray thisComponent  

Cette ligne analyse l’objet «  Sheets  » et on pourra retrouver la méthode «  getByName  »

xray thisComponent.Sheets

Cette ligne analyse l’objet «  getByName("Feuille1")  » et on pourra retrouver la méthode «  getCellRangeByName  »

xray thisComponent.Sheets.getByName("Feuille1")

Cette ligne analyse l’objet «  getCellRangeByName("A1")  » et on pourra retrouver la propriété «  string  »

xray thisComponent.Sheets.getByName("Feuille1").getCellRangeByName("A1")

Configurer xRay pour accéder directement à la documentation d’une propriété ou d’une méthode

Quand xRay est exécuté, il faut cliquer sur le bouton «  Configurer  » et indiquer le chemin du SDK

Ensuite, il faut lui indiquer le chemin du navigateur à exécuter. Dans mon cas, je mets simplement «  firefox  » sans chemin.

Une fois la configuration validée par « OK », il suffit de placer le curseur sur une méthode ou une propriété et de cliquer sur « Documentation du SDK » pour afficher la documentation dans le navigateur indiqué.

Autres sources d’informations

Historique des modifications