DESCRIPTION.

La fonction FN_messageboxdpi() permet d'afficher une boite formatée de message en modifiant son style visuel ainsi que ses dimensions, et de gérer la réponse de l'utilisateur.

SYNTAXE.

kchoix = FN_messageboxdpi( titre , message , type , style , echelle )

REMARQUES.

titre doit être une chaine de caractères quelconque mais valide.titre  sera affiché dans la barre de titre de la boite de dialogue.

message doit être une chaine de caractères quelconque mais valide. message sera affiché comme intitulé au dessus du ou des boutons de la boite de dialogue.

type doit valoir : 

- 0, pour afficher uniquement le bouton OK dans la boite de dialogue ;

- 1, pour afficher les boutons OK et CANCEL (Annuler) ; 

- 2, pour afficher les boutons ABORT (Arrêter), RETRY (réésayer) et IGNORE (Ignorer) ; 

- 3, pour afficher les boutons YES (Oui), NO (Non) et CANCEL (Annuler) ; 

- 4, pour afficher les boutons YES (Oui) et NO (Non) ; 

- 5, pour afficher les boutons RETRY (réésayer) et CANCEL (Annuler) ; 

- plus grand que 5, pour afficher uniquement le bouton OK dans la boite de dialogue.

sytle indique dans quel style visuelle la boite de dialogue est ses controles doivent est affichées. style peut valoir : 

- FALSE, pour présenter la boite de dialogue dans le style visuel clair ou :

- TRUE, pour présenter la boite de dialogue dans le style visuel sombre.

echelle doit être une valeur numérique indiquant la valeur du zoom pour afficher la boite de dialogue. Par défaut, echelle vaut 2, toute valeur inférieure diminuera les dimension de la boite de dialogue, alors que les valeurs supérieures les agrandiront.

La fonction FN_messageboxdpi() va retourner une valeur numérique, identifiant le bouton sur lequel l'utilisateur a cliqué pour fermer la boite de dialogue formatée. Cette valeur peut affecter une variable pour une utilisateur ultérieure, ou on pourra placer l'appel de la fonction FN_messageboxdpi() comme expression à évaluer dans un test logique (IF ou ELSE IF), un bloc selon que (CASE ... OF), une boucle faire tant que (REPEAT / UNTIL) ou un boucle tant que (WHILE / ENDWHILE). La valeur retourné peut être :

- 1, si l'utilisateur a cliqué sur pour le bouton OK ;

- 2, si l'utilisateur a cliqué sur pour le bouton CANCEL (Annuler) ; 

- 3, si l'utilisateur a cliqué sur pour le bouton ABORT (Arrêter) ; 

- 4, si l'utilisateur a cliqué sur pour le bouton RETRY (réésayer)

- 5, si l'utilisateur a cliqué sur pour le bouton CANCEL (Annuler) ;

- 6, si l'utilisateur a cliqué sur pour le bouton YES (Oui) ;

- 7, si l'utilisateur a cliqué sur pour le bouton NO (Non).

Rappel : l'utilisation du module msgbox.bbc nécessite d'avoir chargé le module dlglib.bbc précédemment.

La procédure FN_messageboxdpi() est importée depuis le module msgbox.bbc. 

EXEMPLE.

INSTALL @lib$ + "dlglib.bbc"

INSTALL @lib$ + "msgbox.bbc"

FOR ktype = 0 TO 9

PRINT "Type de boite : "  ktype ;

kechelle = 1 + ( ktype * 0.3 )

PRINT "Valeur du Zoom : "  kechelle

kchoix = FN_messageboxdpi( "TEST" , "Pour un test ..." , ktype , FALSE , kechelle )

NEXT ktype

PRINT : PRINT "Test termine. Au revoir"

END