DESCRIPTION.

La fonction FN_filedlg() affiche une boite de dialogue permettant la sélection d'un fichier.

SYNTAXE.

kfichier$ = FN_filedlg( titre , ouvrir , repertoire , description , extension , option )

REMARQUES.

titre doit être une chaine de caractères quelconque mais valide. titre sera affiché tel quel dans la barre de titre de la boite de dialogue contenant l'explorateur de fichiers.

ouvrir doit être une chaine de caractères quelconque mais valide. ouvrir sera affiché tel quel comme intitulé sur le bouton de sélection. En général on choisira une valeur explicite comme, par exemple : "ok", "ouvrir", "selectionner".

repertoire doit être une chaine de caractères désignant le répertoire, ou dossier, initial de recherche de l'explorateur de fichiers. repertoire doit être valide pour le système d'exploitation de la machine hote. Si repertoire est une chaine vide ("") l'explorateur de fichiers s'ouvrira en affichant le contenu du dernier emplacement sélectionné.

description doit être une chaine de caractères quelconque mais valide, indiquant à l'utilisateur quels types de fichier il doit sélectionner. description doit être assez court pour s'insérer dans l'espace qui lui est réservé dans la boite de dialogue de l'explorateur de fichiers.

extension doit être une, ou une suite de chaines de caractères listant les types de fichiers qui doivent être affichés, et donc sélectionnables, dans l'explorateur de fichier. Chaque extension doit être précédé d'un point. Si plusieurs extensions de fichier sont imposées, elles doivent être séparées par des points-virgules, par exemple ".bbc;.bas;.txt".Si extension vaut ".", seuls les répertoires seront affichés dans l'explorateur de fichier, l'utilisateur devra, ou pourra, alors sélectionner un répertoire.

option peut valoir : 

- 0, pour désactiver toutes les options ;

- 1, pour afficher l'option : tous les fichiers, quelque soit la valeur de extension ;

- 256 (&100) pour omettre l'indication du répertoire parent (..) de la liste ;

- 512 (&200) pour omettre l'indication @lib$ de la liste ;

- 1024 (&400) pour omettre l'indication @usr$ de la liste.

Il est possible de combiner plusieurs option en additionnant les valeurs des options respectifs. Par exemple : 1537 (&601), combine les valeurs &1, &200 et &400, ce qui active l'option tous fichers et cache les indications  @lib$ et @usr$.

La fonction FN_filedlg() retourne une chaine de caractères avec le nom absolu du fichier sélectionné ou une chaine vide si l'utilisateur a cliqué sur le bouton Cancel pour annuler la demande.

Rappel : les explorateurs de fichiers, créer avec le module filedlg.bbc, devant être accueillis dans une boite de dialogue, il faut impérativement installer le module dlglib.bbc avant le module filedlg.bbc, ainsi que les modules sortlib.bbc et stringlib.bbc.

Voir la fonction FN_filedlgex() qui permet de positionner librement un explorateur de fichiers dans la fenêtre de sortie.

La fonction FN_filedlg() est importée depuis le module filedlg.bbc. 

EXEMPLE.

REM --- Importation des modules ---

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

INSTALL @lib$ + "dlglib.bbc"

INSTALL @lib$ + "sortlib.bbc"

INSTALL @lib$ + "stringlib.bbc"

INSTALL @lib$ + "filedlg.bbc"

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

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

REM --- affichage d'un explorateur de fichier ---

kfichier$ = FN_filedlg( "Selectionnez un fichier" , "OK" , "" , "Selection parmi" , ".bbc;.bas;.exe;.txt" , 1 )

IF kfichier$ <> "" THEN PRINT "Vous avez selectionne " kfichier$ ELSE PRINT "Vous avez rien selectionne"

REM --- Fin du programme ---

PRINT : PRINT "Au revoir."

END