Boîtes de message et zones de saisie(bibliothèque d'exécution de Apache OpenOffice)

From Apache OpenOffice Wiki
Jump to: navigation, search
doc OOo
Book.png


                   Les fonctions MsgBox et InputBox de Apache OpenOffice Basic assurent les communications avec l'utilisateur.

Affichage des messages

MsgBox affiche une boîte d'informations de base, qui peut contenir un ou plusieurs boutons. La variante la plus simple de MsgBox ne contient que du texte et un bouton OK :

MsgBox "This is a piece of information!"

Vous pouvez modifier l'apparence de la boîte d'information à l'aide d'un paramètre. Le paramètre permet d'ajouter des boutons supplémentaires, de définir un bouton par défaut et d'ajouter un symbole informatif. Pour sélectionner les boutons, les valeurs sont :

  • 0 : bouton OK ;
  • 1 : boutons OK et Annuler ;
  • 2 : boutons Abandonner, Réessayer et Ignorer ;
  • 3 : boutons Oui, Non et Annuler ;
  • 4 : boutons Oui et Non ;
  • 5 : boutons Réessayer et Annuler.

Pour définir un bouton par défaut, ajoutez l'une des valeurs suivantes à la valeur du paramètre choisie dans la liste de sélection des boutons. Par exemple, pour créer trois boutons Oui, Non et Annuler (valeur 3), où Annuler est le bouton par défaut, le paramètre doit avoir la valeur de 3 + 512 = 515.

  • 0 : le premier bouton est sélectionné par défaut ;
  • 256 : le deuxième bouton est sélectionné par défaut ;
  • 512 : le troisième bouton est sélectionné par défaut.

Enfin, les symboles informatifs suivants sont disponibles et vous pouvez les afficher en ajoutant les valeurs appropriées au paramètre :

  • 16 : signe stop ;
  • 32 : point d'interrogation ;
  • 48 : point d'exclamation ;
  • 64 : icône Astuce.

L'appel suivant affiche une boîte d'information avec les boutons Oui et Non (valeur 4), dont le second (Non) est sélectionné par défaut (valeur 256), et contenant également un point d'interrogation (valeur 32), 4 + 256 + 32 = 292.

MsgBox "Do you want to continue?",  292

Si une boîte d'informations contient plusieurs boutons, il faut utiliser une valeur de retour pour déterminer le bouton sur lequel l'utilisateur a cliqué. Les valeurs de retour possibles dans ce cas sont les suivantes :

  • 1 : OK ;
  • 2 : Annuler ;
  • 3 : Abandonner ;
  • 4 : Réessayer ;
  • 5 : Ignorer ;
  • 6 : Oui ;
  • 7 : Non.

Pour l'exemple précédent, le contrôle de la valeur de retour peut se faire de la manière suivante :

If MsgBox ("Do you want to continue?",  292) = 6 Then
  ' Yes button pressed
Else
  ' No button pressed
End IF

Outre le texte d'information et le paramètre permettant de définir la disposition de la boîte d'information, MsgBox fournit un troisième paramètre définissant le titre de la boîte de message :

MsgBox "Do you want to continue?",  292, "Box Title"

Si aucun titre n'est indiqué pour la boîte de message, la valeur par défaut est "soffice".

Zone de saisie pour demander des chaînes simples

La fonction InputBox demande à l'utilisateur de saisir une chaîne simple. Elle constitue donc une alternative simple pour configurer des boîtes de dialogue. InputBox reçoit trois paramètres standard :

  • un texte d'information ;
  • un titre pour la boîte de message ;
  • une valeur par défaut pouvant être ajoutée dans la zone de saisie.
InputVal = InputBox("Please enter value:", "Test", "default value")

La fonction InputBox retourne la chaîne saisie par l'utilisateur.

Content on this page is licensed under the Public Documentation License (PDL).
Personal tools