FileDialog [En cours de Traduction Wismerheal][WSL]
Cet objet représente une fenêtre permettant à l'utilisateur de choisir un fichier.
Fonctions
FileDialog
Fonction de construction.
Syntaxe
var myObject = new FileDialog();
var myObject = new FileDialog(parameters);
Arguments
parameters - (object) paramètres de fenêtre
title - (string) e titre de la fenêtre
position - (
Point) la position de la fenêtre
opacity - (float) l'opacité de la fenêtre
enabled - (boolean) le statut d'activation de la fenêtre
visible - (boolean) le statut de la fenêtre visible
acceptMode - (
AcceptMode) le mode d'acceptation de fichier
fileMode - (
FileMode) le mode de fichier
-
selectedFile - (string) le fichier sélectionné par défaut
selectedNameFilter - (string) le nom du filtre sélectionné par défaut
defaultSuffix - (string) le suffixe de fichier par défaut
directory - (string) le répertoire par défaut
-
nameFilter - (string) le nom du filtre
nameFilters - (array) un tableau de noms de filtres à utiliser
showDirectoriesOnly - (boolean) montrer seulement les répertoires
dontResolveSymlinks - (boolean) ne solutionne pas les liens symboliques (Linux seulement)
dontConfirmOverwrite - (boolean) ne confirme pas l'écrasement en écriture
dontUseNativeDialog - (boolean) n'utilise pas un "dialog" natif
readOnly - (boolean) show read-only files (Windows seulement)
hideNameFilterDetails - (boolean) cache les détails de nom de filtre
sidebarUrls - (array) un tableau d'urls affiché sur la barre du côté
onClosed - (
OnClosed évènement appelé quand la fenêtre est fermée
onCurrentChanged - (
OnCurrentChanged évènement appelé quand l'actuelle sélection est changée
onDirectoryEntered - (
OnDirectoryEntered évènement appelé quand le répertoire actuel est changé
onFileSelected - (
OnFileSelected évènement appelé quand la fenêtre est fermée
onFileSelected - (
OnFilesSelected évènement appelé quand la fenêtre est fermée
onFilterSelected - (
OnFilterSelected évènement appelé quand un filtre est sélectionné
Exceptions
Example
var myObject = new FileDialog();
var myObject = new FileDialog({
title: "Select a file",
acceptMode: FileDialog.Open
});
Méthodes
setTitle
Définit le titre de la fenêtre.
Syntaxe
myObject.setTitle(title);
Arguments
title - (string) le titre de la fenêtre
Renvoi
setPosition
Définit la position de la fenêtre.
Syntaxe
myObject.setPosition(point);
Arguments
point - (
Point) la position de la fenêtre
Renvoi
setOpacity
Définit l'opacité de la fenêtre.
Syntaxe
myObject.setOpacity(opacity);
Arguments
opacity - (float) l'opacité de la fenêtre
Renvoi
setEnabled
Définit le statut d'activité de la fenêtre.
Syntaxe
myObject.setEnabled(enabled);
Arguments
enabled - (boolean) le statut d'activité de la fenêtre
Renvoi
setVisible
Définit le statut de visibilité de la fenêtre.
Syntaxe
myObject.setVisible(visible);
Arguments
visible - (boolean) le statut de visibilité de la fenêtre
Renvois
close
Syntaxe
Renvoi
title
Renvoi le titre de la fenêtre.
Syntaxe
Renvoi
position
Renvoi la position de la fenêtre.
Syntaxe
Renvoi
(
Point) la position de la fenêtre
opacity
Renvoi l'opacité de la fenêtre.
Syntaxe
Renvoi
enabled
Renvoi le statut d’activité de la fenêtre.
Syntaxe
Renvoi
visible
Renvoi le statut de visibilité de la fenêtre.
Syntaxe
Renvoi
setAcceptMode
Définit le mode d'acceptation.
Syntaxe
myObject.setAcceptMode(acceptMode);
Arguments
Renvoi
setFileMode
Définit le mode de fichier.
Syntaxe
myObject.setFileMode(fileMode);
Arguments
fileMode - (
FileMode) le mode de fichier
Renvoi
setViewMode
Syntaxe
myObject.setViewMode(viewMode);
Arguments
Renvoi
setLabelText
Définit un label de texte.
Syntaxe
myObject.setLabelText(dialogLabel, text);
Arguments
-
text - (string) le label de texte
Renvoi
selectFile
Syntaxe
myObject.selectFile(filename);
Arguments
filename - (string) le fichier sélectionné
Renvoi
selectNameFilter
Sélectionne le nom de filtre.
Syntaxe
myObject.selectNameFilter(filter);
Arguments
filter - (string) le nom de filtre
Renvoi
setDefaultSuffix
Sélectionne le suffixe par défaut.
Syntaxe
myObject.setDefaultSuffix(defaultSuffix);
Arguments
defaultSuffix - (string) le suffixe par défaut
Renvoi
setDirectory
Sélectionne le répertoire actuel.
Syntaxe
myObject.setDirectory(directory);
Arguments
directory - (string) l'actuel répertoire
Renvoi
setFilter
Syntaxe
myObject.setFilter(filters);
Arguments
filters - (
Filters) le filtres à utiliser
Renvoi
setNameFilter
Définit le nom du filtre.
Syntaxe
myObject.setNameFilter(nameFilter);
Arguments
nameFilter - (string) le nom du filtre
Renvoi
setNameFilters
Sets the name filters.
Définit le nom des filtres.
Syntaxe
myObject.setNameFilters(nameFilters);
Arguments
nameFilters - (array) un tableau avec le nom des filtres à utiliser.
Renvois
setShowDirectoriesOnly
La fenêtre doit-elle afficher les répertoires.
Syntaxe
myObject.setShowDirectoriesOnly(showDirectoriesOnly);
Arguments
showDirectoriesOnly - (boolean) montre seulement les répertoires
Renvoi
setDontResolveSymlinks
La fenêtre doit-elle résoudre les liens symboliques.
Syntaxe
myObject.setDontResolveSymlinks(dontResolveSymlinks);
Arguments
dontResolveSymlinks - (boolean) résout les liens symboliques
Renvoi
setDontConfirmOverwrite
La fenêtre doit-elle demander une confirmation pour écraser en écriture.
Syntaxe
myObject.setDontConfirmOverwrite(dontConfirmOverwrite);
Arguments
dontConfirmOverwrite - (boolean) demande une confirmation pour écraser un fichier en écriture
Renvoi
setDontUseNativeDialog
La fenêtre doit-elle utiliser le "dialog" natif.
Syntaxe
myObject.setDontUseNativeDialog(dontUseNativeDialog);
Arguments
dontUseNativeDialog - (boolean) utilise le "dialog" natif
Renvoi
setReadOnly
La fenêtre doit-elle montrer les fichiers en lectures seuls.
Syntaxe
myObject.setReadOnly(readOnly);
Arguments
readOnly - (boolean) montre les fichiers en lectures seuls.
Renvoi
setHideNameFilterDetails
Cache le détail des noms de filtres.
Syntaxe
myObject.setHideNameFilterDetails(hideNameFilterDetails);
Arguments
hideNameFilterDetails - (boolean) cache le détail des noms de filtres
Renvoi
Définit les urls des barres de côté.
Syntaxe
myObject.setSidebarUrls(sidebarUrls);
Arguments
sidebarUrls - (array) les urls des barres de côté
Renvoi
selectedFile
Renvoi le fichier sélectionné.
Syntaxe
Renvoi
selectedFiles
Renvoi les fichiers sélectionnés.
Syntaxe
myObject.selectedFiles();
Renvoi
selectedNameFilter
Syntaxe
myObject.selectedNameFilter();
Renvoi
selectedNameFilter
Syntaxe
myObject.selectedNameFilter();
Renvoi
show
Affiche la fenêtre. (non-bloquant)
Utilise l'évènement OnClosed pour savoir si la fenêtre a été fermé.
Syntaxe
Renvoi
showModal
Affiche la fenêtre. (bloquant)
Syntaxe
Renvoi
Evènements
onClosed
Appelé quand la fenêtre est fermée.
Syntaxe
myObject.onClosed = function(result) {};
Arguments
result - (integer) le résultat de la fenêtre (0 signifie que cela a été annulé)
Example
myObject.onClosed = function(result)
{
if(result)
{
//Event action
}
};
onCurrentChanged
Appelé quand le fichier est changé.
Syntaxe
myObject.onCurrentChanged = function(path) {};
Arguments
path - (string) le fichier actuel
Example
myObject.onCurrentChanged = function(path)
{
//Event action
};
onDirectoryEntered
Appelé quand le répertoire actuel est changé.
Syntaxe
myObject.onDirectoryEntered = function(directory) {};
Arguments
directory - (string) le fichier actuel
Example
myObject.onDirectoryEntered = function(directory)
{
//Event action
};
onFileSelected
Appelé quand le "dialog" est accepté.
Syntaxe
myObject.onFileSelected = function(file) {};
Arguments
file - (string) le fichier sélectionné
Example
myObject.onFileSelected = function(file)
{
//Event action
};
onFilesSelected
Appelé quand le "dialog" est accepté.
Syntaxe
myObject.onFilesSelected = function(files) {};
Arguments
files - (array) les fichiers sélectionnés, sous forme de tableau contenant les noms de fichiers
Example
myObject.onFilesSelected = function(files)
{
//Event action
};
onFilterSelected
Appelé quand le filtre est changé.
Syntaxe
myObject.onFilterSelected = function(filter) {};
Arguments
filter - (string) le nouveau filtre
Example
myObject.onFilterSelected = function(filter)
{
//Event action
};
Attributes
title
Le titre de la fenêtre. (string)
position
La position de la fenêtre. (Point)
opacity
L'opacité de la fenêtre. (float)
enabled
Le statut d'activité de la fenêtre. (boolean)
visible
Le statut de visibilité de la fenêtre. (boolean)
Enumerations
AcceptMode
Définit le mode d'acceptation de la fenêtre.
Valeurs
Open: le "dialog" est utilisé pour ouvrir un fichier
Save: le "dialog" est utilisé pour sauvegarder un fichier
FileMode
Définit le mode de fichier de la fenêtre.
Valeurs
AnyFile: le fichier n'a pas besoin de disposer d'un mode pour être sélectionné
ExistingFile: Il n'y a qu'un fichier qui peut être sélectionné et doit être existant
ExistingFiles: un ou plusieurs fichier existant peuvent être sélectionnés
Directory: un répertoire peut être sélectionné
ViewMode
Définit le mode de vue d'une fenêtre.
Valeurs
Detail: Montre les fichiers avec leurs détails
List: Montre seulement noms de fichier et icône
DialogLabel
Le label de la fenêtre à éditer.
Valeurs
LookIn: le label "look in" (à trouver)
FileName: le nom de fichier du label
FileType: le type du fichier du label
Accept: le label accepté
Reject: le label rejeté
Filters
Valeurs
Dirs: liste de répertoires
AllDirs: liste de tous les répertoires sans appliquer de filtres sur leur noms
Files: liste de fichiers
Drives: liste de lecteurs (Windows seulement)
NoSymLinks: ne liste pas les liens symboliques (Linux seulement)
NoDotAndDotDot: ne liste pas les entrées spéciales . et ..
NoDot: ne liste pas l'entrée spéciale .
NoDotDot: ne liste pas l'entrée spéciale ..
AllEntries: liste de répertoires, fichiers et lecteurs (pareil à Dirs | Files | Drives)
Readable: liste de fichiers lisibles
Writable: lsite de fichiers inscriptibles
Executable: liste de fichiers exécutables
Modified: liste de fichiers modifiés (Windows seulement)
Hidden: liste des fichiers cachés (sur Linux, les fichier commençant par un point)
System: liste des fichiers système
CaseSensitive: la chaîne de caractères du filtre doit prendre en compte les majuscules/minuscules (case sensitive)
Notes
Ceci est une énumération d'indicateurs, ce la signifie que vous pouvez utiliser de multiples valeurs en usant de l'opérateur | .
Example :
myObject.setFilter(FileDialog.Files | FileDialog.Executable); //Liste seulement les fichiers qui sont exécutables.