SELBOX

Selboxdéclare une boîte de sélection pour saisir un choix.

Syntaxe

[ Local] Selboxliste_exprg [ Titledexp_titre] Usingvariable

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 sont limitées à 255.
exp_titre	Expression alphanumérique du titre de laboîte.	longueur <= 50
variable	nom_de_variable numérique comportant lenuméro de choix fait dans la boîte (c'est-à-dire le numéro de ligne).	La variable doit exister.

Exemples

# variable résultat du choix
Libelle RESU
# affichage de la fenêtre de sélection
# avec une liste d'expressions
# avec positionnement du curseur sur le 5ème élément
$MENU
RESU=5
Selbox
& "élément 1",
& "élément 2",
& "élément 3",
& "élément 4",
& "élément 5"
& Titled "Sélection des éléments"
& Using RESU

# action en fonction du choix effectué
Case RESU
When 1 Gosub CHOIX1
When 2 Gosub CHOIX2
When 3 Gosub CHOIX3
When 4 Gosub CHOIX4
When 5 Gosub CHOIX5
When Default Goto MENU
Endcase
# variable résultat du choix
Integer RESU
# tableau de 1000 éléments
Char V (15) (1000)
#remplissage du tableau V
For I = 1 To 1000 Step 1
V (I-1) = "élément "+num$(I)
Next I

#affiche tous les éléments du tableau V
Selbox V Titled "Fenêtre de sélection" Using RESU

#affiche une tranche du tableau V
Selbox V(110..221) Titled "Fenêtre de sélection" Using RESU

Description et commentaires

Selboxpermet de déclarer une boîte de sélection pour saisir un choix parmi unensemble fini. Les opérations permettant de gérer la boîte (visualisation,sélection et effacement) seront automatiques.

L'instruction Selboxcomporte comme premier argument la liste des choix à afficher dans la boîte. Ilest donné sous la forme d'une liste d'expressions alphanumériques, chaqueélément de la liste constituant un choix. 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 CHOIX(1..0), la boîte ne sera pas affichée.

On peut donner ensuite des clauses optionnelles :

La clause Titled permet de donner un titre à la boîte de sélection.

La clause Using permet d'affecter la variable dont le nom suit, avec lenuméro de choix saisi. L'initialisation préalable de cette variable permet dedéfinir l'élément actif lorsque la boîte s'affiche. Les valeurs possibles sont1 pour le premier, 2 pour le second et ainsi de suite jusqu'au dernier. Lavariable status est mise à jour par la saisie d'un choix avec la valeur '28'.

Remarques

Une boîte de sélection est fermée dès que l'on a fait un choix.

L'instruction Close n'existe pas pour une Selbox.

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 coordonnées exprimant la position de la boîte ne sont pas numé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-écrans ouverts.

Mots-clés associés

Inpbox - Dlgbox - Mesbox - Choose - Errbox - Infbox - Wrnbox - Qstbox - Status - Endbox

SOMMAIRE