DESCRIPTION.

La procédure PROC_setcomboboxarray() modifie le contenu d'une liste déroulante de sélections.

SYNTAXE.

PROC_setcomboboxarray( boite , controle , donnees , elements )

REMARQUES.

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

controle doit être l'identifiant de la liste déroulante de sélections dont le contenu doit être modifié.

donnees doit être l'identifiant d'un tableau de données, de portée globale, ne contenant que des chaines de caractères (type $) les valeurs numériques donnant des comportements indésirables, contenant les nouvelles valeurs des lignes de texte de editeur. donnees ne doit pas forcément être toujours le même tableau de données, une liste fixe ou déroulante de sélections n'étant pas liée définitivement au premier tableau de données qui lui est associé.

elements doit être un nombre entier indiquant le nombre d'éléments, ou items, provenant de données qui doivent être insérés dans la liste fixe ou déroulante de sélections. Si elements est supérieur à l'index du dernier élément de données. des sélections vide, non sélectionnables, seront placées dans la liste fixe ou déroulante de sélection. 

La création d'un nouvel éditeur de texte multiligne nécessite une association avec un tableau de données, de type $, déclaré au préalable avec l'instruction DIM(), pour son bon fonctionnement. En effet, c'est la dimension de ce tableau de données qui définira le nombre maximum de lignes qui pourront être inclusses dans l'éditeur de texte multiligne. Il faudra donc :

- déclarer un tableau de données avec l'instruction DIM() ;

- affecter les valeurs aux éléments du tableau de données, si l'on souhaite afficher du texte dès l'affichage de boite ;

- appeler la procédure PROC_seteditboxarray() pour placer les éléments du tableau de données dans l'éditeur de texte.

Note : Si aucun tableau de données valide n'est associé à un éditeur de texte multiligne lors l'affichage de sa boite de dialogue, une erreur Bad use of array sera retournée.

Rappel : Les éditeurs de texte multiligne, créer avec le module editbox.bbc, devant être accueillis dans une boite de dialogue, il faut impérativement installer le module dlglib.bbc avant le module module editbox.bbc.

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

Voir la procédure procédure PROC_editbox() qui crée un éditeur de texte multilignes.

La procédure PROC_setcomboboxarray() est importée depuis le module editbox.bbc. 

EXEMPLE.

REM --- Importation des modules ---

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

INSTALL @lib$ + "dlglib.bbc"

INSTALL @lib$ + "editbox.bbc"

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

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

REM --- Initialisation des elements de la liste ---

DIM LST_Editeur$( 100 )

LST_Editeur$( 0 ) = "Vous pouvez entrer du texte a partir d'ici ..."

LST_Editeur$( 50 ) = "Vous etes maintenant a la ligne 50."

LST_Editeur$( 100 ) = "C'est ici que ce termine l'editeur de texte."

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

DLG_Test = FN_newdialog( "Test ..." , 170 , 150 )

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

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

PROC_editbox( DLG_Test , "" , 101 , 5 , 5 , 160 , 120 , &300000 ) 

PROC_seteditboxarray( DLG_Test , 101 , LST_Editeur$() , 100 )

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