====== 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 - ([[en:code:core:point|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|AcceptMode]]) le mode d'acceptation de fichier
* fileMode - ([[#filemode|FileMode]]) le mode de fichier
* viewMode - ([[#viewmode|ViewMode]]) le mode de vue
* 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
* filter - ([[#filter|Filter]]) le filtre
* 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|OnClosed]] évènement appelé quand la fenêtre est fermée
* onCurrentChanged - ([[#oncurrentchanged|OnCurrentChanged]] évènement appelé quand l'actuelle sélection est changée
* onDirectoryEntered - ([[#ondirectoryentered|OnDirectoryEntered]] évènement appelé quand le répertoire actuel est changé
* onFileSelected - ([[#onfileselected|OnFileSelected]] évènement appelé quand la fenêtre est fermée
* onFileSelected - ([[#onfilesselected|OnFilesSelected]] évènement appelé quand la fenêtre est fermée
* onFilterSelected - ([[#onfilterselected|OnFilterSelected]] évènement appelé quand un filtre est sélectionné
=== Exceptions ===
* (ParameterTypeError) type de paramètre incorrect
* (ParameterCountError) compte de paramètre incorrect
=== 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 ===
* (FileDialog) ce "FileDialog"
==== setPosition ====
Définit la position de la fenêtre.
=== Syntaxe ===
myObject.setPosition(point);
=== Arguments ===
- point - ([[en:code:core:point|Point]]) la position de la fenêtre
=== Renvoi ===
* (FileDialog) ce "FileDialog"
==== setOpacity ====
Définit l'opacité de la fenêtre.
=== Syntaxe ===
myObject.setOpacity(opacity);
=== Arguments ===
- opacity - (float) l'opacité de la fenêtre
=== Renvoi ===
* (FileDialog) ce "FileDialog"
==== 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 ===
* (FileDialog) ce "FileDialog"
==== 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 ===
* (FileDialog) ce "FileDialog"
==== close ====
Ferme al fenêtre.
=== Syntaxe ===
myObject.close();
=== Renvoi ===
* (FileDialog) ce "FileDialog"
==== title ====
Renvoi le titre de la fenêtre.
=== Syntaxe ===
myObject.title();
=== Renvoi ===
* (string) le titre de la fenêtre
==== position ====
Renvoi la position de la fenêtre.
=== Syntaxe ===
myObject.position();
=== Renvoi ===
* ([[en:code:core:point|Point]]) la position de la fenêtre
==== opacity ====
Renvoi l'opacité de la fenêtre.
=== Syntaxe ===
myObject.opacity();
=== Renvoi ===
* (float) l'opacité de la fenêtre
==== enabled ====
Renvoi le statut d’activité de la fenêtre.
=== Syntaxe ===
myObject.enabled();
=== Renvoi ===
* (boolean) the window's enabled status
==== visible ====
Renvoi le statut de visibilité de la fenêtre.
=== Syntaxe ===
myObject.visible();
=== Renvoi ===
* (boolean) le statut de visibilité de la fenêtre
==== setAcceptMode ====
Définit le mode d'acceptation.
=== Syntaxe ===
myObject.setAcceptMode(acceptMode);
=== Arguments ===
- acceptMode - ([[#acceptmode|AcceptMode]]) le mode d'acceptation
=== Renvoi ===
* (FileDialog) ce "FileDialog"
==== setFileMode ====
Définit le mode de fichier.
=== Syntaxe ===
myObject.setFileMode(fileMode);
=== Arguments ===
- fileMode - ([[#filemode|FileMode]]) le mode de fichier
=== Renvoi ===
* (FileDialog) ce "FileDialog"
==== setViewMode ====
Définit le mode de vue.
=== Syntaxe ===
myObject.setViewMode(viewMode);
=== Arguments ===
- viewMode - ([[#viewmode|ViewMode]]) le mode de vue
=== Renvoi ===
* (FileDialog) ce "FileDialog"
==== setLabelText ====
Définit un label de texte.
=== Syntaxe ===
myObject.setLabelText(dialogLabel, text);
=== Arguments ===
- dialogLabel - ([[#dialoglabel|DialogLabel]]) le label de texte
- text - (string) le label de texte
=== Renvoi ===
* (FileDialog) ce "FileDialog"
==== selectFile ====
Sélectionne un fichier.
=== Syntaxe ===
myObject.selectFile(filename);
=== Arguments ===
- filename - (string) le fichier sélectionné
=== Renvoi ===
* (FileDialog) ce "FileDialog"
==== selectNameFilter ====
Sélectionne le nom de filtre.
=== Syntaxe ===
myObject.selectNameFilter(filter);
=== Arguments ===
- filter - (string) le nom de filtre
=== Renvoi ===
* (FileDialog) ce "FileDialog"
==== setDefaultSuffix ====
Sélectionne le suffixe par défaut.
=== Syntaxe ===
myObject.setDefaultSuffix(defaultSuffix);
=== Arguments ===
- defaultSuffix - (string) le suffixe par défaut
=== Renvoi ===
* (FileDialog) ce "FileDialog"
==== setDirectory ====
Sélectionne le répertoire actuel.
=== Syntaxe ===
myObject.setDirectory(directory);
=== Arguments ===
- directory - (string) l'actuel répertoire
=== Renvoi ===
* (FileDialog) ce "FileDialog"
==== setFilter ====
Définit les filtres.
=== Syntaxe ===
myObject.setFilter(filters);
=== Arguments ===
- filters - ([[#filters|Filters]]) le filtres à utiliser
=== Renvoi ===
* (FileDialog) ce "FileDialog"
==== setNameFilter ====
Définit le nom du filtre.
=== Syntaxe ===
myObject.setNameFilter(nameFilter);
=== Arguments ===
- nameFilter - (string) le nom du filtre
=== Renvoi ===
* (FileDialog) this FileDialog
==== 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 ===
* (FileDialog) ce "FileDialog"
==== setShowDirectoriesOnly ====
La fenêtre doit-elle afficher les répertoires.
=== Syntaxe ===
myObject.setShowDirectoriesOnly(showDirectoriesOnly);
=== Arguments ===
- showDirectoriesOnly - (boolean) montre seulement les répertoires
=== Renvoi ===
* (FileDialog) ce "FileDialog"
==== setDontResolveSymlinks ====
La fenêtre doit-elle résoudre les liens symboliques.
=== Syntaxe ===
myObject.setDontResolveSymlinks(dontResolveSymlinks);
=== Arguments ===
- dontResolveSymlinks - (boolean) résout les liens symboliques
=== Renvoi ===
* (FileDialog) ce "FileDialog"
==== 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 ===
* (FileDialog) ce "FileDialog"
==== setDontUseNativeDialog ====
La fenêtre doit-elle utiliser le "dialog" natif.
=== Syntaxe ===
myObject.setDontUseNativeDialog(dontUseNativeDialog);
=== Arguments ===
- dontUseNativeDialog - (boolean) utilise le "dialog" natif
=== Renvoi ===
* (FileDialog) ce "FileDialog"
==== 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 ===
* (FileDialog) ce "FileDialog"
==== 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 ===
* (FileDialog) ce "FileDialog"
==== setSidebarUrls ====
Définit les urls des barres de côté.
=== Syntaxe ===
myObject.setSidebarUrls(sidebarUrls);
=== Arguments ===
- sidebarUrls - (array) les urls des barres de côté
=== Renvoi ===
* (FileDialog) ce "FileDialog"
==== selectedFile ====
Renvoi le fichier sélectionné.
=== Syntaxe ===
myObject.selectedFile();
=== Renvoi ===
* (string) le fichier sélectionné
==== selectedFiles ====
Renvoi les fichiers sélectionnés.
=== Syntaxe ===
myObject.selectedFiles();
=== Renvoi ===
* (array) les fichiers sélectionnés
==== selectedNameFilter ====
Renvoi le nom du filtre.
=== Syntaxe ===
myObject.selectedNameFilter();
=== Renvoi ===
* (string) le nom du filtre sélectionné
==== selectedNameFilter ====
Renvoi le nom du filtre.
=== Syntaxe ===
myObject.selectedNameFilter();
=== Renvoi ===
* (string) le nom de filtre sélectionné
==== show ====
Affiche la fenêtre. (non-bloquant)
Utilise l'évènement [[#onclosed|OnClosed]] pour savoir si la fenêtre a été fermé.
=== Syntaxe ===
myObject.show();
=== Renvoi ===
* (FileDialog) ce "FileDialog"
==== showModal ====
Affiche la fenêtre. (bloquant)
=== Syntaxe ===
myObject.showModal();
=== Renvoi ===
* (integer) le résultat de la fenêtre (0 signifie que cela a été annulé)
===== 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. ([[en:code:core:point|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 ====
Les filtres à utiliser.
=== 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.