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)|*.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

<- NextSelectedFileName() - Requester Index - PathRequester() ->