DESCRIPTION.

La fonction PROC_setdlgitemtext() modifie la valeur de texte d'un controle d'une boite de dialogue.

SYNTAXE.

PROC_setdlgitemtex ( boite , controle , texte )

REMARQUES.

boite doit être l'identifiant de la boite de dialogue contenant le controle. 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.

controle doit être l'identifiant du controle.

texte doit être une chaine de caractères quelconque mais valide. texte remplacera le contenu du controle.

La fonction PROC_setdlgitemtext() permet de modifie : 

- l'intitulé ou l'image d'un bouton cliquable ;

- l'étiquette de la case à option, d'une case à choix, ou d'un groupe de controle ;

- le contenu d'un champs de saisie ou d'une étiquette ;

- la sélection d'une liste déroulante de sélections.

La modification de valeurs des listes fixes de sélections et des échelles de valeurs ne sont normalement pas accessibles avec l'appel de la fonction PROC_setdlgitemtext().

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

Voir la procédure FN_getdlgitemtext() qui retourne le contenu d'un controle.

Voir la procédure PROC_settrackbarpos() qui permet de modifier la valeur d'une échelle de valeurs.

Voir la procédure PROC_setlistboxarray() qui permet la gestion des items d'une liste fixe de sélections.

La procédure PROC_setdlgitemtext() 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 --- Creation d'une boite de dialogue nommee DLG_Test de 160 x 60 unites intitulee Test ---

DLG_Test = FN_newdialog( "Test ..." , 200 , 100 )

PROC_registerdlgcallback( DLG_Test, FN_Calcul() ) 

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

PROC_button( DLG_Test , "Quitter" , 1 , 80 , 70 , 40 , 20 , 0 )

PROC_static( DLG_Test , "" , 201 , 10 , 5 , 180 , 15 , 1 )

PROC_static( DLG_Test , "" , 202 , 10 , 50 , 180 , 15 , 1 )

PROC_trackbar( DLG_Test , "" , 301 , 10 , 25 , 180 , 20 , 0 )

PROC_settrackbarpos( DLG_Test , 301 , 0 , -100 , 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

REM --- DEFINITION DES METHODES PERSONNALISEES ---

REM --- Fonction de rappel de la boite de dialogue DLG_Test ---

DEF FN_Calcul( Qboite , Qtouche )

kracine = FN_gettrackbarpos( DLG_Test , 301 )

kmessage$ = "Racine : " + STR$( kracine )

PROC_setdlgitemtext( DLG_Test , 201 , kmessage$ )

kcarre = kracine ^ 2

kmessage$ = "Le carre de " + STR$( kracine ) + " est " + STR$( kcarre )

PROC_setdlgitemtext( DLG_Test , 202 , kmessage$ )

PROC_refreshdialog( DLG_Test )

= 0