• Source

La fenêtre MapBasic est présente dans MapInfo depuis la version 3 (la première version Windows). Elle est ouverte par un item du menu « Options » ou par l’icône ‘clé plate’ de la barre « Outils »; ces deux éléments opèrent en bascule et peuvent être utilisés pour fermer la FMB quand elle est ouverte.

Il ne peut y avoir qu’une FMB ouverte en même temps, tout comme il n’y a qu’une fenêtre message, légende, … (souvent nommées fenêtres système en opposition aux cartes,
tableaux, … qui sont des fenêtres document)) mais cette fenêtre peut servir pour entrer des données ce qui n’est pas le cas des fenêtres système.

La FMB fut documentée pour la première fois dans MI Pro MapFAQ’s (1996 après la sortie de la version 4) , et est toujours décrite dans le chapitre 24 « Using the MapBasic Window » dans le MI User’s Guide, chapitre 23 dans le Guide de l’Usager de MI. Dans la version anglaise, le chapitre 24 a été réduit de 50 pages (version 5.0, mode d’emploi et un bon nombre de fonctions détaillées et directement utilisables) à 18 (version 6.5, mode d’emploi seulement), l’idée étant que le « MapBasic Reference » en format PDF est inclus maintenant dans le CD d’installation de MI, sans aucune aide cependant pour convertir les constantes littérales en numériques. La version française n’a pas suivi une réduction aussi dramatique, mais elle ne contient que 5 des 25 fonctions avec arguments.

La mission initiale de la FMB est d’afficher les équivalents en MapBasic des commandes passées par le menu, mais avec certaines limitations et variations. Ainsi, pas toutes les
commandes sont « transcrites »

(CODE)

Connaître quelles sont les commandes qui sont ainsi affichées va permettre de savoir celles qui pourront être réutilisées par la suite. Une fois la FMB ouverte, l’affichage se fait de façon continue, même si la fenêtre est miniaturisée. La seule façon de l’interrompre est de fermer la fenêtre, ce qui la vide par la même occasion de tout son contenu.

Cette fenêtre est l’équivalent d’un très simple éditeur de texte combiné à un lanceur de commandes.

Les fonctions d’édition sont des plus simples : copier, coller (de la FMB ou d’une autre source), effacer, déplacer. Les flèches permettent de se déplacer dans l’espace défini par le texte présent. L’ajout d’une nouvelle ligne se fait par <CTRL>+<ENTRER>. Le lanceur de commande est la touche <ENTRER> qui peut lancer une seule ligne ou plusieurs.

• Position du curseur (une ligne à la fois) n’importe où dans la ligne puis <entrer>
• Sur-lignage d’un groupe de lignes puis <entrer>

Si une commande est écrite sur plusieurs lignes, il faut toutes les sélectionner. Si une partie seulement d’une ligne est sous-lignée, seulement la partie sous-lignée sera lancée, ce qui généralement va résulter en une erreur.

Si l’on veut répéter le lancement de la même commande, ou du même groupe de lignes, l’action à prendre dépend de la nature des commandes. Si la FMB perd le focus suite aux
commandes, il faut le lui redonner en cliquant dans la barre de titre;. La sélection n’est pas alors perdue et on tape <ENTRER>.
L’exemple type est une commande insertion dans une table. Si le focus n’est pas perdu, il suffit de retaper <ENTER> ; c’est le cas par exemple avec un print (qui affiche le résultat dans la fenêtre message).

Les commandes de menu principal ou de menu flottant (clic du bouton droit alors que sur la fenêtre) sont assez limitées.

En plus du chapitre du « Guide de l’utilisateur de MapInfo » mentionné pour les versions anglaise et française, il existe plusieurs fichiers MI et des documents complémentaires.

• Le fichier d’aide de MapBasic qui est maintenant disponible comme fichier PDF sur le disque d’installation de MapInfo à compter de la v6.50, auparavant venait avec MapBasic

uniquement.

• Des fichiers auxiliaires de MI comme MapInfoW.MNU et de MapBasic (fichiers de définition comme mapbasic.def, menu.def et icons.def)
• Des listes adhoc de conversion/équivalence comme :
  • les annexes du « Mini-Guide to the MBW »
  • les documents du « projet ABC » (Application Backwards Compatibility) de Jacques Paris

Il faut d’abord bien comprendre que les commandes soumises par la FMB sont simplement interprétées sans compilation, ce qui implique l’usage de scripts linéaires (exécutés
séquentiellement une ligne à la fois, l’une après l’autre). Ce sont exactement les mêmes contraintes que pour les documents WOR générés directement par MI et ce qui peut être dit au sujet d’un « milieu » est valable en général pour l’autre. Ceci nous entraîne à parler plutôt des commandes interdites que des permises.

Cette première contrainte élimine tous les éléments basés sur la notion de branchement dans la séquence des commandes (DO, IF, WHILE, FOR, GOTO …) ou le concept de routines ou
fonctions définies par l’utilisateur ou devant être définies (cas des fonctions API Windows).

D’autres éléments sont interdits par d’autres règles particulières pour des raisons parfois moins évidentes. Par exemple. « INCLURE xxx » implique d’ajouter au point indiqué des
commandes contenues dans un autre fichier au moment de la compilation. De même les boîtes de « DIALOG » ne sont remplies de façon dynamique qu’à la compilation.

Finalement, il ne peut y avoir aucune manipulation de fichiers, en opposition aux tables. On ne peut pas par exemple ouvrir un fichier et y écrire des résultats.

L’annexe A contient tous ces « interdits » et les raisons qui y sont attachées.

Les arguments de fonctions qui en comportent (un peu plus de deux douzaines) doivent être passés comme des codes numériques car le fichier « mapbasic.def » n’est pas accessible de la fenêtre. Ces diverses valeurs seront précisées dans chacune des fonctions au fur et à mesure de leur présentation.

Les variables sont définies comme dans MapBasic avec un énoncé DIM. Cependant dans la FMB, il ne peut y avoir qu’une seule variable par DIM.
Les variables dimensionnées (vecteurs) ne sont pas permises.
Tout variable reste définie pour la durée de la session de MapInfo. Afin d’éviter leur accumulation ou une mauvaise réutilisation, il faudrait lancer dès que l’utilisation d’une
variable est terminée un énoncé réservé à la FMB : UNDIM.

Ces variables FMB sont valables dans l’environnement MM/MI c’est-à-dire qu’elles ne sont pas contraintes par le cadre de la FMB. Elles peuvent être donc « passées » dans d’autres utilisations comme dans certains dialogues.

Il y a plusieurs formes de la commande RUN que nous allons passer en revue.

• RUN APPLICATION “<applicationr>.MBX “ : permet de lancer des applications MBX. Peut faire partie d’un script ou d’un WOR.
• RUN APPLICATION “<fichier>.WOR“ : permet de lancer des documents classiques mais surtout des « scripts » qui seraient exécutables dans la fenêtre MB.
• RUN COMMAND <cmd> : exécute la commande représentée par la chaîne de caractères <cmd>. Cette chaîne peut être spécifiée directement et doit alors être entre ““ ou comme une variable caractère. Run Command est une solution parfaite quand il s’agit de passer un élément d’un énoncé par une variable alors que MI s’attend à trouver le nom d’une table ou d’une colonne.
• RUN MENU COMMAND xxx : lance des opérations similaires à celles du menu en utilisant un code numérique (défini dans MENU.DEF) mais pas tous les codes définis sont opérationnels. Il est bien entendu que seuls ceux pour des commandes ayant une trace dans la FMB peuvent être considérés dans une première analyse, mais ce n’est pas forcément

toujours le cas, surtout quand la trace est composée de plusieurs commandes. Il y a donc dans certains cas des possibilités d’équivalences. L’annexe B donne une idée de ce à quoi on peut s’attendre.

• RUN PROGRAM “<programme_spécification> “ : lance le programme spécifié avec les arguments de la ligne de commande voulus (fichier à ouvrir, redirection des résultats, … )

En MapBasic, le texte entre une apostrophe et la fin de la ligne est ignoré, ce qui permet d’insérer des commentaires dans le texte. Dans la FMB, la présence d’une apostrophe va
interrompre le traitement de l’information à cet endroit, alors que dans un document WOR ce n’est pas le cas, les commentaires n’ayant aucun effet sur la poursuite des opérations.

Il faudra se souvenir de cette différence de comportement quand il s’agira de construire des scripts pour réutilisation.