|
|
|
|
|
|
|
|
|
|
- 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
fSélecteur (Fonction) En anglais : fSelect Ouvre le sélecteur de fichiers du système en cours. Remarque : Sous Android et iOS, la boîte de dialogue de sélection d'un fichier n'est pas disponible. Utilisez la fonction AlbumSélecteur (pour sélectionner un fichier de type Image ou Vidéo) ou la fonction URISélecteur pour tout type de 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. <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. <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é. <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). <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. | | fselChange | Envoie le message MessageSélecteur à la fenêtre WINDEV appelante à chaque clic sur un fichier présent dans le sélecteur de fichiers. | | fselCrée | Ouvre le sélecteur de fichiers en création de fichier (bouton "Enregistrer"). | | fselExiste | Si 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.
| | fselMulti | Ouvre le sélecteur en mode multisélections. L'utilisateur peut ainsi sélectionner plusieurs fichiers à l'aide des touches "Ctrl" et "Shift". | | fselOuvre | Ouvre 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. <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é. <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" <Extension par défaut> : Chaîne de caractères Extension attribuée par défaut au fichier sélectionné (voir Notes). <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. | | fselChange | Envoie le message MessageSélecteur à la fenêtre WINDEV appelante à chaque clic sur un fichier présent dans le sélecteur de fichiers. | | fselCrée | Ouvre le sélecteur de fichiers en création de fichier (bouton "Enregistrer"). | | fselExiste | Si 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.
| | fselMulti | Ouvre le sélecteur en mode multisélections. L'utilisateur peut ainsi sélectionner plusieurs fichiers à l'aide des touches "Ctrl" et "Shift". | | fselOuvre | Ouvre 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'utilisateur | Extension 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. Classification Métier / UI : Code UI Composante : wd300std.dll
Documentation également disponible pour…
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|