PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

  • 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
  • Répertoire "Mes documents"
  • Fonctionnement différent en mode GO et en utilisation réelle
  • 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/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Autres
Procédures stockées
Ouvre le sélecteur de fichiers du système en cours.
Versions 16 et supérieures
WINDEVLinux Cette fonction est désormais disponible pour les applications WINDEV sous Linux.
Nouveauté 16
WINDEVLinux Cette fonction est désormais disponible pour les applications WINDEV sous Linux.
WINDEVLinux Cette fonction est désormais disponible pour les applications WINDEV sous Linux.
WINDEVEtats et RequêtesJavaCode Utilisateur (MCU)
// 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")
Windows Mobile
// Sélection d'un fichier dans le répertoire "\Mes Documents\Répertoires"
FichierSélectionné est une chaîne
FichierSélectionné = fSélecteur("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 (avec guillemets)
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.
Versions 15 et supérieures
Windows Ce paramètre peut être au format Ansi ou Unicode.
Nouveauté 15
Windows Ce paramètre peut être au format Ansi ou Unicode.
Windows Ce paramètre peut être au format Ansi ou Unicode.
Windows Mobile Chemin complet du répertoire initial (260 caractères maximum). Ce répertoire doit correspondre :
  • soit à un des sous-répertoires immédiats du répertoire "\Mes Documents". Ce répertoire ne doit pas commencer par "\".
  • soit à un répertoire situé à la racine d'une carte de stockage.
    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 "\Mes Documents".
<Fichier sélectionné par défaut> : Chaîne de caractères (avec guillemets)
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.
Versions 15 et supérieures
Windows Ce paramètre peut être au format Ansi ou Unicode.
Nouveauté 15
Windows Ce paramètre peut être au format Ansi ou Unicode.
Windows Ce paramètre peut être au format Ansi ou Unicode.
<Titre du sélecteur> : Chaîne de caractères (avec guillemets)
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é.
Versions 15 et supérieures
Windows Ce paramètre peut être au format Ansi ou Unicode.
Nouveauté 15
Windows Ce paramètre peut être au format Ansi ou Unicode.
Windows Ce paramètre peut être au format Ansi ou Unicode.
<Types de fichiers> : Chaîne de caractères (avec guillemets)
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 (avec guillemets)
Extension attribuée par défaut au fichier sélectionné (voir Notes).
Versions 15 et supérieures
Windows Ce paramètre peut être au format Ansi ou Unicode.
Nouveauté 15
Windows Ce paramètre peut être au format Ansi ou Unicode.
Windows Ce paramètre peut être au format Ansi ou Unicode.
Versions 16 et supérieures
Linux Ce paramètre n'est pas pris en compte.
Nouveauté 16
Linux Ce paramètre n'est pas pris en compte.
Linux Ce paramètre n'est pas pris en compte.
<Mode de sélection> : Constante (ou combinaison de constantes) optionnelle
Permet de définir le mode de sélection du sélecteur :
fCheminUNICODE
Versions 15 et supérieures
<Résultat> sera une chaîne de caractères au format Unicode.
Windows Mobile Cette constante n'est pas prise prise en compte. <Résultat> est toujours au format Unicode.
Nouveauté 15
<Résultat> sera une chaîne de caractères au format Unicode.
Windows Mobile Cette constante n'est pas prise prise en compte. <Résultat> est toujours au format Unicode.
<Résultat> sera une chaîne de caractères au format Unicode.
Windows Mobile Cette constante n'est pas prise prise en compte. <Résultat> est toujours au format Unicode.
Versions 16 et supérieures
Linux Cette constante n'est pas prise en compte.
Nouveauté 16
Linux Cette constante n'est pas prise en compte.
Linux Cette constante n'est pas prise en compte.
fselCréeOuvre le sélecteur de fichiers en création de fichier (bouton "Enregistrer").
fselOuvreOuvre le sélecteur de fichiers en ouverture de fichier (bouton "Ouvrir").
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 multi-sélections. L'utilisateur peut ainsi sélectionner plusieurs fichiers à l'aide des touches "Ctrl" et "Shift".
Windows Mobile Cette constante n'est pas disponible.
fselChangeEnvoie le message MessageSélecteur à la fenêtre WINDEV appelante à chaque clic sur un fichier présent dans le sélecteur de fichiers.
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 (avec guillemets)
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.
Versions 15 et supérieures
Windows Ce paramètre peut être au format Ansi ou Unicode.
Nouveauté 15
Windows Ce paramètre peut être au format Ansi ou Unicode.
Windows Ce paramètre peut être au format Ansi ou Unicode.
Windows Mobile Chemin complet du fichier sélectionné par défaut (avec le nom du fichier et son extension). Ce fichier doit être présent :
  • soit dans un des sous-répertoires immédiats du répertoire "\Mes Documents". Ce répertoire ne doit pas commencer par "\".
  • soit dans un répertoire situé à la racine d'une carte de stockage.
    Si ce paramètre est une chaîne vide (""), le répertoire initial correspondra au répertoire "\Mes Documents" et aucun fichier ne sera sélectionné par défaut.
<Titre du sélecteur> : Chaîne de caractères (avec guillemets)
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é.
Versions 15 et supérieures
Windows Ce paramètre peut être au format Ansi ou Unicode.
Nouveauté 15
Windows Ce paramètre peut être au format Ansi ou Unicode.
Windows Ce paramètre peut être au format Ansi ou Unicode.
<Types de fichiers> : Chaîne de caractères (avec guillemets)
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"
Versions 15 et supérieures
Windows Ce paramètre peut être au format Ansi ou Unicode.
Nouveauté 15
Windows Ce paramètre peut être au format Ansi ou Unicode.
Windows Ce paramètre peut être au format Ansi ou Unicode.
<Extension par défaut> : Chaîne de caractères (avec guillemets)
Extension attribuée par défaut au fichier sélectionné (voir Notes).
Versions 15 et supérieures
Windows Ce paramètre peut être au format Ansi ou Unicode.
Nouveauté 15
Windows Ce paramètre peut être au format Ansi ou Unicode.
Windows Ce paramètre peut être au format Ansi ou Unicode.
Versions 16 et supérieures
Linux Ce paramètre n'est pas pris en compte.
Nouveauté 16
Linux Ce paramètre n'est pas pris en compte.
Linux Ce paramètre n'est pas pris en compte.
<Mode de sélection> : Constante (ou combinaison de constantes) optionnelle
Permet de définir le mode de sélection du sélecteur :
fCheminUNICODE
Versions 15 et supérieures
<Résultat> sera une chaîne de caractères au format Unicode.
Windows Mobile Cette constante n'est pas prise prise en compte. <Résultat> est toujours au format Unicode.
Nouveauté 15
<Résultat> sera une chaîne de caractères au format Unicode.
Windows Mobile Cette constante n'est pas prise prise en compte. <Résultat> est toujours au format Unicode.
<Résultat> sera une chaîne de caractères au format Unicode.
Windows Mobile Cette constante n'est pas prise prise en compte. <Résultat> est toujours au format Unicode.
Versions 16 et supérieures
Linux Cette constante n'est pas prise en compte.
Nouveauté 16
Linux Cette constante n'est pas prise en compte.
Linux Cette constante n'est pas prise en compte.
fselCréeOuvre le sélecteur de fichiers en création de fichier (bouton "Enregistrer").
fselOuvreOuvre le sélecteur de fichiers en ouverture de fichier (bouton "Ouvrir").
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 multi-sélections. L'utilisateur peut ainsi sélectionner plusieurs fichiers à l'aide des touches "Ctrl" et "Shift".
Windows Mobile Cette constante n'est pas disponible.
fselChangeEnvoie le message MessageSélecteur à la fenêtre WINDEV appelante à chaque clic sur un fichier présent dans le sélecteur de fichiers.
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).
WINDEVEtats et RequêtesJavaCode Utilisateur (MCU)

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 Mobile

Répertoire "Mes documents"

Si le répertoire initial correspond au répertoire "Mes documents" :
  • le sélecteur de fichiers affichera l'ensemble des fichiers présents dans le répertoire "Mes documents" et dans ses sous-répertoires immédiats.
  • l'option "Dossier" du sélecteur de fichiers correspondra à "Tous les dossiers".
Windows Mobile

Fonctionnement différent en mode GO et en utilisation réelle

En mode GO (simulation sur le poste de développement), lors de l'appel de la fonction fSélecteur :
  • le sélecteur de fichiers du poste de développement s'affiche.
  • <Répertoire initial> est ignoré. Le répertoire initial correspond alors au répertoire en cours.
  • <Résultat> contient un chemin au format du poste de développement (par exemple : "C:\MesRépertoire").
L'ensemble des différences entre le mode GO (simulateur) et l'utilisation réelle est détaillé dans Différences en mode GO et en utilisation réelle.
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.
WindowsLinuxWindows Mobile

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.
Windows Mobile Le sélecteur de fichiers du Pocket PC est le suivant :
Sélecteur de fichiers Windows Mobile
Sous Pocket PC, le sélecteur de fichiers permet de sélectionner les fichiers présents :
  • dans le répertoire "\Mes Documents" ou dans un de ses sous-répertoires immédiats.
  • dans un répertoire situé à la racine d'une carte de stockage.
La fonction fSélecteur permet donc uniquement de sélectionner un fichier présent dans un des ces répertoires.
Versions 16 et supérieures
Linux Le sélecteur de fichiers de Linux est le suivant :
Sélecteur de fichier Linux
Nouveauté 16
Linux Le sélecteur de fichiers de Linux est le suivant :
Sélecteur de fichier Linux
Linux Le sélecteur de fichiers de Linux est le suivant :
Sélecteur de fichier Linux
Composantes
WINDEVEtats et Requêtes wd220std.dll
Windows Mobile wp220std.dll
Java wd220java.jar
Linux wd220std.so
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire