====== 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.