Outils pour utilisateurs

Outils du site


fr:code:windows:filedialog

Ceci est une ancienne révision du document !


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

  1. 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
    • 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) 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 é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

  • (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

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

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

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

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

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

  • (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

  1. acceptMode - (AcceptMode) le mode d'acceptation

Renvoi

  • (FileDialog) ce "FileDialog"

setFileMode

Définit le mode de fichier.

Syntaxe

myObject.setFileMode(fileMode);

Arguments

  1. fileMode - (FileMode) le mode de fichier

Renvoi

  • (FileDialog) ce "FileDialog"

setViewMode

Définit le mode de vue.

Syntaxe

myObject.setViewMode(viewMode);

Arguments

  1. viewMode - (ViewMode) le mode de vue

Renvoi

  • (FileDialog) ce "FileDialog"

setLabelText

Définit un label de texte.

Syntaxe

myObject.setLabelText(dialogLabel, text);

Arguments

  1. dialogLabel - (DialogLabel) le label de texte
  2. text - (string) le label de texte

Renvoi

  • (FileDialog) ce "FileDialog"

selectFile

Sélectionne un fichier.

Syntaxe

myObject.selectFile(filename);

Arguments

  1. filename - (string) le fichier sélectionné

Renvoi

  • (FileDialog) ce "FileDialog"

selectNameFilter

Sélectionne le nom de filtre.

Syntaxe

myObject.selectNameFilter(filter);

Arguments

  1. filter - (string) le nom de filtre

Renvoi

  • (FileDialog) ce "FileDialog"

setDefaultSuffix

Sélectionne le suffixe par défaut.

Syntaxe

myObject.setDefaultSuffix(defaultSuffix);

Arguments

  1. defaultSuffix - (string) le suffixe par défaut

Renvoi

  • (FileDialog) ce "FileDialog"

setDirectory

Sélectionne le répertoire actuel.

Syntaxe

myObject.setDirectory(directory);

Arguments

  1. directory - (string) l'actuel répertoire

Renvoi

  • (FileDialog) ce "FileDialog"

setFilter

Définit les filtres.

Syntaxe

myObject.setFilter(filters);

Arguments

  1. filters - (Filters) le filtres à utiliser

Renvoi

  • (FileDialog) ce "FileDialog"

setNameFilter

Définit le nom du filtre.

Syntaxe

myObject.setNameFilter(nameFilter);

Arguments

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

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

  1. showDirectoriesOnly - (boolean) montre seulement les répertoires

Renvoi

  • (FileDialog) ce "FileDialog"

La fenêtre doit-elle résoudre les liens symboliques.

Syntaxe

myObject.setDontResolveSymlinks(dontResolveSymlinks);

Arguments

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

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

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

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

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

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

Show the window. (non-blocking) Use the OnClosed event to know when the window has been closed.

Syntaxe

myObject.show();

Returns

  • (FileDialog) this FileDialog

showModal

Show the window. (blocking)

Syntax

myObject.showModal();

Returns

  • (integer) the window result (0 means that it has been canceled)

Events

onClosed

Called when the window is closed.

Syntax

myObject.onClosed = function(result) {};

Arguments

  1. result - (integer) the window result (0 means that it has been canceled)

Example

myObject.onClosed = function(result)
{
	if(result)
	{
		//Event action
	}
};

onCurrentChanged

Called when the current file has changed.

Syntax

myObject.onCurrentChanged = function(path) {};

Arguments

  1. path - (string) the current file

Example

myObject.onCurrentChanged = function(path)
{
	//Event action
};

onDirectoryEntered

Called when the current directory has changed.

Syntax

myObject.onDirectoryEntered = function(directory) {};

Arguments

  1. directory - (string) the current file

Example

myObject.onDirectoryEntered = function(directory)
{
	//Event action
};

onFileSelected

Called when the dialog is accepted.

Syntax

myObject.onFileSelected = function(file) {};

Arguments

  1. file - (string) the selected file

Example

myObject.onFileSelected = function(file)
{
	//Event action
};

onFilesSelected

Called when the dialog is accepted.

Syntax

myObject.onFilesSelected = function(files) {};

Arguments

  1. files - (array) the selected files, as an array containing filenames

Example

myObject.onFilesSelected = function(files)
{
	//Event action
};

onFilterSelected

Called when the filter is changed.

Syntax

myObject.onFilterSelected = function(filter) {};

Arguments

  1. filter - (string) the new filter

Example

myObject.onFilterSelected = function(filter)
{
	//Event action
};

Attributes

title

The window's title. (string)

position

The window's position. (Point)

opacity

The window's opacity. (float)

enabled

The window's enabled status. (boolean)

visible

The window's visible status. (boolean)

Enumerations

AcceptMode

Sets the accept mode of the window.

Values

  1. Open: the dialog is used to open a file
  2. Save: the dialog is used to save to a file

FileMode

Sets the file mode of the window.

Values

  1. AnyFile: the selected file has not to exist to be selected
  2. ExistingFile: there is only one file that can be selected and it has to exist
  3. ExistingFiles: zero or more existing file can be selected
  4. Directory: a directory can be selected

ViewMode

Sets the view mode of the window.

Values

  1. Detail: show files with details
  2. List: show only the file name and icon

DialogLabel

The label of the window to edit.

Values

  1. LookIn: the "look in" label
  2. FileName: the filename label
  3. FileType: the filetype label
  4. Accept: the accept label
  5. Reject: the reject label

Filters

The filters to use.

Values

  1. Dirs: list directories
  2. AllDirs: list all directories without applying filters to directory names
  3. Files: list files
  4. Drives: list drives (Windows only)
  5. NoSymLinks: do not list symbolic links (Linux only)
  6. NoDotAndDotDot: do not list the special entries . and ..
  7. NoDot: do not list the special entry .
  8. NoDotDot: do not list the special entry ..
  9. AllEntries: list directories, files and drives (same as Dirs | Files | Drives)
  10. Readable: list readable files
  11. Writable: list writable files
  12. Executable: list executable files
  13. Modified: list modified files (Windows only)
  14. Hidden: list hidden files (on Linux, files starting with a dot)
  15. System: list system files
  16. CaseSensitive: the filter string should be case sensitive

Notes

This is a flag enumeration, this means that you can use multiple values using the | operator. Example :

myObject.setFilter(FileDialog.Files | FileDialog.Executable); //List only files that are executable
fr/code/windows/filedialog.1335450312.txt.gz · Dernière modification : 2021/02/13 11:23 (modification externe)