QSTBOX

Sommaire


Qstboxdéclare une boîte de question en permettant de gérer cet OBJet de façonautomatique ou non.

 

Syntaxe

   [ Local] Qstboxliste_exprg   [ Titledexp_titre] UsingvariableSleepdélai

 

Paramètres

Elément

Description

Restrictions

liste_exprg

Liste d'expressions-généraliséesséparées par le caractère ','.

Les expressions doivent êtrealphanumériques et leur  nombre limité à 255

exp_titre

Expression alphanumérique du titre de laboîte.

longueur <= 50

variable

nom_de_variable numérique comportant lenuméro du bouton choisi.

La variable doit exister.

délai

expression entière exprimant un délai.

délai >=0

 

Exemples

   # Boite affichant la question définiedans le fichier message applicatif
   # cette boite disparaît au bout de 10secondes 
   # dans ce cas, le bouton 2 est pris pardéfaut.
    Local Libelle REP
    REP=2
   Qstbox mess(2, 5,1) - nomap Using [L]REP Sleep 10
    Case [L]REP
       When 1 : Call SORTIE
       When 2 : Call SUITE
    Endcase

 

Description et commentaires

Qstboxpermet de déclarer une boîte pour afficher une question avec saisie d'un boutonpour la réponse et comme choix possibles "Oui" et "Non".

L'instruction Qstboxcomporte comme premier argument le texte de la question à afficher. Il estdonné sous la forme d'une liste d'expressions alphanumériques, chaque élémentde la liste constituant une ligne du texte. Si l'une des expressions est unevariable dimensionnée sans précision d'indice ou d'intervalle d'indices, tousles é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 de question, différentdu titre standard.

La clause Using permet d'affecter la variable qui contiendra le numéro dubouton choisi. Les valeurs possibles sont 1 pour "Oui" et 2 pour"Non".

La clause Sleep permet d'exprimer un temps d'attente maximum pour la saisiede la réponse. C'est un temps exprimé en nombre de secondes. En time-out, lesystème sort  de la fenêtre avec activation du bouton n°1, ou bien dubouton défini par défaut ( c'est à dire celui défini avant l'ouverture de cetteboite. ( voir l'exemple ).

 

Remarques

Les boîtes de question sont refermées dès que l'on appuie sur l'un des deuxboutons ou en time-out. L'instruction Close n'existe pas pour une Qstbox.

 

Erreurs associées

Erreur

Description

ERMODE(10)

-La variable de la clause Using n'est pas numérique.
- Les expressions ne sont pas alphanumériques.
- les indices donnés ne sont pas numériques.

ERINDI( 8)

Erreurde bornes pour des indices.

ERDIM(55)

Tropde dimensions données.

PLUMEM(31)

Plusde mémoire disponible.

ERTRWD(79)

Tropd'OBJets-écran ouverts.

 

Mots-clés associés

INPBOX - DLGBOX - MESBOX - ERRBOX - INFBOX - WRNBOX - SELBOXSTATUS - ENDBOX


SOMMAIRE

Adonix X3(r) L4G
Copyright (c) Adonix 1999 - All rights reserved