| WRNBOX |
Wrnboxdéclare une boîte d'avertissement.
Syntaxe
[ Local] Wrnbox
Paramètres
Elément | Description | Restrictions |
Liste d'expressions_généraliséesséparées par le caractère ','. | Les expressions doivent êtrealphanumériques et leur nombre limité à 255 | |
Expression alphanumérique du titre de laboîte. | longueur <= 50 | |
nom_de_variable de type numériquecomportant la valeur de retour de la saisie dans la boîte. | La variable doit exister. | |
expression entière exprimant un délai. | délai >=0 |
Exemples
# Affichage d'un message avertissantque l'on va remettre à zéro un fichier.
# Cette opération est réalisée s'il y aconfirmation de l'opération
Local Libelle REP
Case [L]REP
When 1 : Lock [CLI]
If fstat = 0 : Delete [CLI]CODCLE >= "" : Endif
Endcase
Description et commentaires
Wrnboxpermet de déclarer une boîte pour afficher un message d'avertissement avecsaisie d'un bouton demandant la confirmation ou l'abandon d'une opération (lestextes des boutons sont "Ok" et "Annuler").
L'instruction Wrnboxcomporte comme premier argument le texte du message à afficher. Il est donnésous la forme d'une liste d'expressions alphanumériques, chaque élément de laliste constituant une ligne du texte. Si l'une des expressions est une variable
dimensionnée sans précision d'indice ou d'intervalle d'indices, tous leséléments de la variable sont utilisés. La précision d'un indice ou d'unintervalle d'indices détermine les éléments à prendre en compte. Si l'on donneun intervalle d'indices tel qu'il n'existe aucun élément correspondant, parexemple TEXTE(1..0), la boîte ne sera pas affichée.
Un texte donné avec un nombre de lignes trop grand pour la taille de l'écransera tronqué.
On peut donner ensuite un ensemble de clauses optionnelles :
La clause Titled permet de donner un titre à la boîte d'avertissement,différent du titre standard.
La clause Using permet d'affecter la variable dont le nom suit avec lavaleur du bouton saisi.La clause Sleep permet d'exprimer un temps d'attentemaximum pour la saisie de la réponse. C'est un temps exprimé en nombre desecondes. En time-out, le système sort de la fenêtre avec activation dubouton n°1, ou bien du bouton défini par défaut ( c'est à dire celui définiavant l'ouverture de cette boite.
Remarques
Les boîtes d'avertissement sont refermées dès que l'on fait le choix"Ok" ou "Annuler" ou en time-out. Les boîtes desélection sont refermées dès que l'on a fait un choix. L'instructionClose n'existe pas pour une Wrnbox.
Erreurs associées
ERMODE(10) | -La variable de la clause Using n'est pas numérique. |
ERINDI( 8) | Erreurde bornes pour des indices. |
ERDIM(55) | Tropde dimensions données. |
PLUMEM(31) | Plusde mémoire disponible. |
Mots-clés associés
Adonix X3(r) L4G |