DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Fonctions standard / Fonctions de gestion des fichiers externes
  • Extension par défaut (lors de la création d'un fichier avec la constante fselCrée)
  • Extension par défaut lors de l'ouverture d'un fichier
  • Clic sur un fichier dans le sélecteur de fichiers
  • Sélection de répertoire
  • Lecteurs réseau, manifeste et UAC
  • Quelques exemples de sélecteurs de fichiers
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac CatalystUniversal Windows 10 App
Autres
Procédures stockées
Ouvre le sélecteur de fichiers du système en cours.
// Sélection d'un fichier
FichierSélectionné est une chaîne
FichierSélectionné = fSélecteur("C:\Répertoires", "Fichier.txt", ...
"Sélectionner un fichier", ...
"Fichier Texte (*.TXT)" + TAB + "*.txt" + RC + "Tous" + TAB + "*.*", "txt")
Syntaxe

Ouvrir un sélecteur en précisant le répertoire initial et le fichier sélectionné par défaut Masquer les détails

<Résultat> = fSélecteur(<Répertoire initial> , <Fichier sélectionné par défaut> , <Titre du sélecteur> , <Types de fichiers> , <Extension par défaut> [, <Mode de sélection>])
<Résultat> : Chaîne de caractères
  • Nom complet du ou des fichiers sélectionnés. Si plusieurs fichiers sont sélectionnés, les noms des fichiers sont séparés par des retour chariot (RC).
  • Nom complet du fichier à créer.
  • Chaîne vide ("") si aucun fichier n'a été sélectionné ou n'est à créer.
<Répertoire initial> : Chaîne de caractères
Chemin complet (ou relatif) du répertoire initial (260 caractères maximum). Ce nom de répertoire peut être terminé indifféremment par "\" ou non. Les fichiers contenus dans ce répertoire s'affichent dans le sélecteur de fichiers. Si ce paramètre est une chaîne vide (""), le répertoire initial correspondra au répertoire en cours.
Windows Ce paramètre peut être au format Ansi ou Unicode.
<Fichier sélectionné par défaut> : Chaîne de caractères
Nom et extension du fichier sélectionné par défaut. Si ce paramètre est une chaîne vide (""), aucun fichier ne sera sélectionné par défaut.
Windows Ce paramètre peut être au format Ansi ou Unicode.
<Titre du sélecteur> : Chaîne de caractères
Intitulé affiché dans la barre de titre du sélecteur de fichiers. Si ce paramètre est une chaîne vide (""), le titre de la fenêtre WINDEV en cours sera affiché.
Windows Ce paramètre peut être au format Ansi ou Unicode.
<Types de fichiers> : Chaîne de caractères
Description des types de fichiers pouvant être sélectionnés. Cette description est de la forme :
<Types Fichiers> + TAB + <Liste Extensions> [ + RC + ...
<Types Fichiers 2> + TAB + <Liste Extensions 2>]

Où :
  • <Types Fichiers> : chaîne de caractères décrivant le type de fichier ("BMP (*.BMP;*.RLE)" par exemple).
  • <Liste Extensions> : extensions correspondant au type décrit ("*.BMP;*.RLE" par exemple).
Par exemple :
"BMP (*.BMP;*.RLE)"+TAB+"*.BMP;*.RLE"+RC+"Icône (*.ICO)"+TAB+"*.ICO"+RC+"Autres"+TAB+"*.GIF;*.TIF;*.JPG"
<Extension par défaut> : Chaîne de caractères
Extension attribuée par défaut au fichier sélectionné (voir Notes).
Windows Ce paramètre peut être au format Ansi ou Unicode.
<Mode de sélection> : Constante (ou combinaison de constantes) optionnelle
Permet de définir le mode de sélection du sélecteur :
fCheminUNICODE<Résultat> sera une chaîne de caractères au format Unicode.
fselChangeEnvoie le message MessageSélecteur à la fenêtre WINDEV appelante à chaque clic sur un fichier présent dans le sélecteur de fichiers.
fselCréeOuvre le sélecteur de fichiers en création de fichier (bouton "Enregistrer").
fselExisteSi cette constante est combinée :
  • avec fselCrée : Renvoie le nom du fichier sélectionné. Si le fichier existe déjà, une boîte de dialogue propose à l'utilisateur d'écraser l'ancien fichier.
  • avec fselOuvre : Renvoie le nom du fichier sélectionné uniquement si ce fichier existe.
fselMultiOuvre le sélecteur en mode multisélections. L'utilisateur peut ainsi sélectionner plusieurs fichiers à l'aide des touches "Ctrl" et "Shift".
fselOuvreOuvre le sélecteur de fichiers en ouverture de fichier (bouton "Ouvrir").

Par défaut, le sélecteur est appelé avec la combinaison fSelOuvre + fSelExiste.

Ouvrir un sélecteur en précisant uniquement le fichier sélectionné par défaut Masquer les détails

<Résultat> = fSélecteur(<Chemin complet du fichier sélectionné par défaut> , <Titre du sélecteur> , <Types de fichiers> , <Extension par défaut> [, <Mode de sélection>])
<Résultat> : Chaîne de caractères
  • Nom complet du ou des fichiers sélectionnés. Si plusieurs fichiers sont sélectionnés, les noms des fichiers sont séparés par des retour chariot (RC).
  • Nom complet du fichier à créer.
  • Chaîne vide ("") si aucun fichier n'a été sélectionné ou n'est à créer.
<Chemin complet du fichier sélectionné par défaut> : Chaîne de caractères
Chemin complet (ou relatif) du fichier sélectionné par défaut (avec le nom du fichier et son extension. Si ce paramètre est une chaîne vide (""), le répertoire initial correspond au répertoire en cours et aucun fichier ne sera sélectionné par défaut.
Windows Ce paramètre peut être au format Ansi ou Unicode.
<Titre du sélecteur> : Chaîne de caractères
Intitulé affiché dans la barre de titre du sélecteur de fichiers. Si ce paramètre est une chaîne vide (""), le titre de la fenêtre WINDEV en cours sera affiché.
Windows Ce paramètre peut être au format Ansi ou Unicode.
<Types de fichiers> : Chaîne de caractères
Description des types de fichiers pouvant être sélectionnés. Cette description est de la forme :
<Types Fichiers> + TAB + <Liste Extensions> [ + RC + ...
<Types Fichiers 2> + TAB + <Liste Extensions 2>]

  • <Types Fichiers> : chaîne de caractères décrivant le type de fichier ("BMP (*.BMP;*.RLE)" par exemple).
  • <Liste Extensions> : extensions correspondant au type décrit ("*.BMP;*.RLE" par exemple).
Par exemple :
"BMP (*.BMP;*.RLE)"+TAB+"*.BMP;*.RLE"+RC+"Icône (*.ICO)"+TAB+"*.ICO"+RC+"Autres"+TAB+"*.GIF;*.TIF;*.JPG"
Windows Ce paramètre peut être au format Ansi ou Unicode.
<Extension par défaut> : Chaîne de caractères
Extension attribuée par défaut au fichier sélectionné (voir Notes).
Windows Ce paramètre peut être au format Ansi ou Unicode.
<Mode de sélection> : Constante (ou combinaison de constantes) optionnelle
Permet de définir le mode de sélection du sélecteur :
fCheminUNICODE<Résultat> sera une chaîne de caractères au format Unicode.
fselChangeEnvoie le message MessageSélecteur à la fenêtre WINDEV appelante à chaque clic sur un fichier présent dans le sélecteur de fichiers.
fselCréeOuvre le sélecteur de fichiers en création de fichier (bouton "Enregistrer").
fselExisteSi cette constante est combinée :
  • avec fselCrée : Renvoie le nom du fichier sélectionné. Si le fichier existe déjà, une boîte de dialogue propose à l'utilisateur d'écraser l'ancien fichier.
  • avec fselOuvre : Renvoie le nom du fichier sélectionné uniquement si ce fichier existe.
fselMultiOuvre le sélecteur en mode multisélections. L'utilisateur peut ainsi sélectionner plusieurs fichiers à l'aide des touches "Ctrl" et "Shift".
fselOuvreOuvre le sélecteur de fichiers en ouverture de fichier (bouton "Ouvrir").

Par défaut, le sélecteur est appelé avec la combinaison fselOuvre + fselExiste.
Remarques

Extension par défaut (lors de la création d'un fichier avec la constante fselCrée)

L'extension d'un fichier sélectionné (fichier à créer) est différente selon :
  • le paramètre <Extension par défaut>,
  • l'extension saisie par l'utilisateur.
Par exemple, le tableau ci-dessous présente l'extension prise en compte selon l'<Extension par défaut> et l'extension saisie par l'utilisateur :
Paramètre <Extension par défaut>Extension saisie par l'utilisateurExtension prise en compte lors de la création du fichier
".TXT""Fichier.BMP"
BMP est une extension valide et reconnue.
"Fichier.BMP"
".TXT""Fichier.PAF"
PAF est une extension invalide. Le nom du fichier sera complété par l'<Extension par défaut>.
"Fichier.PAF.TXT"
".TXT""Fichier"
Aucune extension n'est saisie. L'<Extension par défaut> est utilisée.
"Fichier.TXT"
"" (chaîne vide)"Fichier.BMP"
BMP est une extension valide et reconnue.
"Fichier.BMP"
"" (chaîne vide)"Fichier.PAF"
PAF est une extension invalide. Le nom du fichier sera complété par la première extension trouvée dans le "Type de fichier" affiché.
Type de fichier affiché : "Texte (*.TXT;*.DOC)"
"Fichier.PAF.TXT"
"" (chaîne vide)"Fichier.PAF"
PAF est une extension invalide. Le type de fichier étant "*.*", l'extension invalide est conservée.
Type de fichier affiché : "Tous fichiers (*.*)"
"Fichier.PAF"
"" (chaîne vide)"Fichier"
Aucune extension n'est saisie. L'extension utilisée est la première extension trouvée dans le "Type de fichier" affiché.
Type de fichier affiché : "Texte (*.TXT;*.DOC)"
"Fichier.TXT"
"" (chaîne vide)"Fichier"
Aucune extension n'est saisie. Le type de fichier étant "*.*", le nom du fichier est conservé sans extension.
Type de fichier affiché : "Tous fichiers (*.*)"
"Fichier"

Extension par défaut lors de l'ouverture d'un fichier

L'extension d'un fichier sélectionné (fichier à ouvrir) correspond à l'extension sélectionnée par défaut à l'ouverture du sélecteur de fichiers. Le paramètre <Extension par défaut> doit alors correspondre uniquement aux lettres correspondant à l'extension (par exemple "lst" pour sélectionner par défaut "*.lst").

Clic sur un fichier dans le sélecteur de fichiers

Pour exécuter un traitement spécifique lors d'un clic sur un fichier présent dans le sélecteur de fichiers, branchez un événement sur le message WM_USER + 600 (1624). A la réception de ce message :
  • la variable lParam contient l'adresse du fichier sélectionné,
  • la variable wParam contient la taille du fichier sélectionné.
Par exemple, il est possible de jouer le son sélectionné dans le sélecteur de fichiers (voir Exemple 2 disponible en cliquant sur le lien "Exemple" en haut de page d'aide).

Sélection de répertoire

La fonction fSélecteur permet de sélectionner des fichiers. Pour sélectionner un répertoire, utilisez la fonction fRepSélecteur.
Windows

Lecteurs réseau, manifeste et UAC

Sous Windows Vista et supérieur, si l'UAC est active et si l'exécutable est généré avec un manifeste demandant des privilèges (voir Génération de l'exécutable), le sélecteur de fichiers ouvert par la fonction fSélecteur n'aura pas accès aux lecteurs réseau associés à l'utilisateur qui a ouvert la session Windows. Pour plus de détails, consultez FAQ à propos de Windows Vista et supérieur.
Windows

Quelques exemples de sélecteurs de fichiers

Windows Le sélecteur de fichiers de Windows est le suivant :
Sélecteur de fichiers Windows
Remarque : Sous Windows Vista (et supérieur), le sélecteur de fichiers de Windows Vista est ouvert.
Classification Métier / UI : Code UI
Composante : wd290std.dll
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Bandeau de navigation du sélecteur de fichier invisible
Sur un certain nombre de postes clients le bandeau de navigation du sélecteur de fichiers n'apparaissait pas.
Après bien des recherches et par hasard j'ai trouvé qu'il fallait "Intégrer un manifeste pour Windows" lors de la création de l'exécutable.
Je pense que les postes où ça fonctionnait quand même sont des postes où l'application n'était pas installée dans le répertoire 'Programmes' de Windows.
Rémi
08 sep. 2023

Dernière modification : 25/08/2022

Signaler une erreur ou faire une suggestion | Aide en ligne locale