SaveFileRequester()

Syntaxe

Resultat$ = SaveFileRequester(Titre$, FichierParDefaut$, Filtre$, FiltrePosition)
Description
Ouvre une boîte de dialogue standard pour enregistrer 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).

Valeur de retour

Renvoie le nom du fichier entré 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

  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$ = SaveFileRequester("Choisissez un fichier à sauvegarder", FichierParDefaut$, Filtre$, Filtre)
  If Fichier$
    MessageRequester("Information", "Vous avez choisi ce fichier :"+Chr(10)+Fichier$, 0)
  Else
    MessageRequester("Information", "La sélection a été annulée.", 0)
  EndIf

OS Supportés

Tous

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