OpenFileRequester()
Syntaxe
Resultat$ = OpenFileRequester(Titre$, FichierParDefaut$, Filtre$, FiltrePosition [, Options])Description
Ouvre une boîte de dialogue standard pour choisir un fichier.
Arguments
Titre$ Texte de titre de la boîte de dialogue, il remplace le titre par défaut. FichierParDefaut$ Permet d'initialiser la boîte de dialogue avec un répertoire et un fichier par défaut. Filtre$ Permet de n'afficher que les fichiers dont le nom et/ou l'extension de fin correspond au filtre.
Il doit avoir la forme des exemples suivants : '*.txt' pour des fichiers texte, '*.mus;*.mod' pour des fichiers musique ayant l'extension '.mus' ou '.mod'. Chaque filtre est en fait une paire composée du label qui sera visible dans le requester et du filtre proprement dit. Le séparateur est le caractère '|' (Pipe).
Note: Les paramètres 'Filtre$' et 'FiltrePosition' n'ont aucun effet sur Mac OSX (tous les fichiers seront toujours affichés).FiltrePosition Nombre qui précise le filtre utilisé par défaut.
Valeur entre 0 et le nombre total de filtres moins 1.
Une fois la boîte fermée, SelectedFilePattern() permet de récupérer la position du filtre choisi.
Note: Les paramètres 'Filtre$' et 'FiltrePosition' n'ont aucun effet sur Mac OSX (tous les fichiers seront toujours affichés).Options (optionnel) Peut être une combinaison des valeurs suivantes: #PB_Requester_MultiSelection : Active la multi-sélection. (voir NextSelectedFileName())
Valeur de retour
Renvoie le chemin et le nom du ou des fichiers sélectionnés ou une chaîne de caractères vide si l'utilisateur a annulé la boîte.
Remarques
Le 'NomFichier$' renvoyé peut être découpé facilement en chemin, nom ou extension à l'aide des commandes suivantes: GetFilePart(), GetPathPart() et GetExtensionPart().
Exemple
"Fichiers Textes|*.txt" ; Un seul filtre avec comme label 'Fichiers Textes' "Fichiers Textes|*.txt;*.doc" ; Un seul filtre avec *.txt et *.doc accepté "Musiques|*.mp3|Video|*.avi;*.asf" ; 2 filtres (Musique et video)
Exemple
FichierParDefaut$ = "C:\autoexec.bat" ; Répertoire et fichier par défaut qui seront affichés ; Avec la chaîne suivante nous allons définir les filtres ("|" comme séparateur) pour l'affichage de fichier : ; 1er : "Texte (*.txt)" comme nom, ".txt" et ".bat" comme extension autorisée ; 2ème : "PureBasic (*.pb)" comme nom, ".pb" comme extension autorisée ; 3ème : "Tous les fichiers (*.*)" comme nom, "*.*" comme extension autorisée, valide pour tous les fichiers Filtre$ = "Texte (*.txt;*.bat)|*.txt;*.bat|PureBasic (*.pb)|*.pb|Tous les fichiers (*.*)|*.*" Filtre = 0 ; utiliser par défaut le premier des trois filtres possibles Fichier$ = OpenFileRequester("Choisissez un fichier à charger", FichierParDefaut$, Filtre$, Filtre) If Fichier$ MessageRequester("Information", "Vous avez choisi le fichier suivant :"+Chr(10)+Fichier$, 0) Else MessageRequester("Information", "La sélection a été annulée.", 0) EndIf
Voir aussi
NextSelectedFileName()
OS Supportés
Tous