DESCRIPTION.

La procédure PROC_groupbox() dessine un rectangle dans une boite de dialogue.

SYNTAXE.

PROC_groupbox( boite , texte , identifiant , abscisse , ordonnee , largeur , hauteur , 0 )

REMARQUES.

boite doit être l'identifiant de la boite de dialogue qui accueillera le rectangle. Il s'agit du nom de la variable qui a reçu la valeur retournée par la fonction FN_newdialog() pour la création de boite.

texte doit être une chaine de caractères quelconque mais valide. texte est l'étiquette du rectangle de regroupement et sera affiché sur la bordure haute du rectangle.

identifiant doit être un nombre entier supérieur à 11.  Tous les controles d'une même boîte de dialogue doivent avoir un identifiant unique mais un identifiant peut être utilisé par plusieurs controles dans des boites de controle différentes.identifiant peut être la valeur retournée par la fonction FN_setproc(); en particulier si le programme doit utiliser identifiant pour connaitre le contenu du champs de saisie. Voir la procédure  PROC_button() pour les valeurs spéciales réservées aux boutons cliquables.

abscisse doit être des nombre entier, exprimé en unités de boite de dialogue, indiquant l'abscisse du bord gauche du rectangle de regroupement dans boite, c'est-à-dire par rapport au bord gauche de boite.

ordonnee doit être des nombre entier, exprimé en unités de boite de dialogue, indiquant l'ordonnée du bord haut rectangle de regroupement dans boite, c'est-à-dire par rapport au bord haut de boite.

largeur doit être un nombre entier, exprimé en unités de boite de dialogue, donnant la largeur rectangle de regroupement.

hauteur doit être un nombre entier, exprimé en unités de boite de dialogue, donnant la hauteur rectangle de regroupement.

Le dernier paramètre est obligatoire et doit être 0, bien qu'une autre valeur numérique ne semble pas retourner d'erreur.

La procédure PROC_groupbox() permet de dessiner rectangle autour de plusieurs controles, surtout des cases à choix ou des cases à option, pour noter visuellement leur appartenance à un même groupe.

Voir la fonction FN_newdialog() qui permet de déclarer et de créer une boite de dialogue. 

La procédure PROC_groupbox() est importée depuis le module dlglib.bbc. 

EXEMPLE.

REM --- Importation des modules ---

REM --- Module de la bibliothèque BBC BASIC ---

INSTALL @lib$ + "dlglib.bbc"

REM --- Chargement de la police de caracteres par defaut ---

OSCLI "FONT """ + @lib$ + "DejaVuSans"",12" 

REM --- Creation d'une boite de dialogue nommee DLG_Test de 160 x 60 unites intitulee Test ---

DLG_Test = FN_newdialog( "Test ..." , 160 , 80 )

REM --- Creation des controles de la boite de dialogue ---

PROC_button( DLG_Test , "Fermer." , 8 , 60 , 60 , 40 , 15 , 0 )

PROC_groupbox( DLG_Test , "Regroupement." , 9999 , 20 , 10 , 120 , 40 , 0 ) 

REM --- Affichage de la boite de dialogue et attende des choix de l'utilisateur ---

kcontrole = FN_showdialog( DLG_Test , &FFFFFFFF80000000 , &FFFFFFFF80000000 )  

REM --- Fermeture de la boite de dialogue ---

PROC_closedialog( DLG_Test ) 

REM --- Fin du programme ---

PRINT : PRINT "Au revoir."

END