Aide:FileOpenDialog.txt

Document original V3.3.6.1 :

###Function###
FileOpenDialog

###Description###
Initiates a Open File Dialog.

###Syntax###
FileOpenDialog ( "title", "init dir", "filter" [, options [, "default name" [, hwnd]]] )


###Parameters###
@@ParamTable@@
title
	Title text of the Dialog GUI.
init dir
	Initial directory selected in the GUI file tree.
filter
	File type single filter such as "All (*.*)" or "Text files (*.txt)" or multiple filter groups such as "All (*.*)|Text files (*.txt)" (See Remarks).
options
	[optional] Dialog Options:  To use more than one option, add the required values together.
	  1 = File Must Exist (if user types a filename)
	  2 = Path Must Exist (if user types a path, ending with a backslash)
	  4 = Allow MultiSelect
	  8 = Prompt to Create New File (if does not exist)
default name
	[optional] Suggested file name for the user to open.  Default is blank ("").
hwnd
	[optional] The window handle to use as the parent for this dialog.
@@End@@

###ReturnValue###
@@ReturnTable@@
Success:	Returns the full path of the file(s) chosen.  Results for multiple selections are "Directory|file1|file2|..."
Failure:	Sets @error
@error:	1 - File selection failed.
	2 - Bad file filter
@@End@@


###Remarks###
Separate the file filters with a semicolon as shown in the example.
Multiple groups of filters are separated by a pipe "|".

If default name is given, options must also be given.  If none of the options are wanted, use 0 for options.

Special Windows folders (such as "My Documents") can sometimes be set as the init dir; see Appendix.

@WorkingDir is changed on successful return.


###Related###
FileSaveDialog, FileSelectFolder, StringSplit


###Example###
@@IncludeExample@@

Document traduit V3.3.6.1 :

###Function###
FileOpenDialog

###Description###
Affiche une boîte de dialogue d'ouverture de fichier.


###Syntax###
FileOpenDialog ( "title", "init dir", "filter" [, options [, "default name" [, hwnd]]] )


###Parameters###
@@ParamTable@@
title
	Texte du titre de la boite de dialogue.
init dir
	Répertoire initial sélectionné dans l'arborescence graphique des fichiers.
filter
	Filtre unique du type de fichier tel que "Tous les fichiers (*.*)" ou "Fichiers texte (*.txt)" ou groupes de filtres multiples tels que "Tous les fichiers (*.*)|Fichiers texte (*.txt)" (voir remarques).
options
	[optionnel] Options de la boîte de dialogue: Pour utiliser plus d'une option, additionnez les valeurs requises ensemble.
	  1 = Le fichier doit exister (si l'utilisateur tape un nom de fichier)
	  2 = Le chemin doit exister (si l'utilisateur tape un chemin, se terminant par un antislash)
	  4 = Permettre la sélection multiple
	  8 = Demande la création d'un nouveau fichier (s'il n'existe pas)
default name
	[optionnel] Nom de fichier suggéré à l'ouverture. Vide par défaut ("").
hwnd
	[optionnel] Le handle de fenêtre à utiliser comme parent pour cette boîte de dialogue.
@@End@@


###ReturnValue###
@@ReturnTable@@
Succès:	Retourne le chemin complet du(des) fichier(s) choisi. Les résultats pour les sélections multiples sont "Répertoire|fichier1|fichier2|..."
Échec:	Définit @error
@error:	1 - La sélection de fichier a échoué.
	2 - Filtre de fichier incorrect
@@End@@


###Remarks###
Séparez les filtres de fichiers avec une point-virgule comme montré dans l'exemple.
Plusieurs groupes de filtres sont séparés par une barre verticale "|".

Si le nom par défaut est donné, les options doivent également être données. Si aucune des options n'est désirées, utilisez 0 pour <i>options<\i>.

Les dossiers spéciaux de Windows (tels que "Mes Documents") peuvent parfois être définis comme répertoire initial, voir l'appendice.

@WorkingDir est modifié sur un retour réussi.


###Related###
<a href="FileSaveDialog.htm">FileSaveDialog</a>, <a href="FileSelectFolder.htm">FileSelectFolder</a>, <a href="StringSplit.htm">StringSplit</a>


###Example###
@@IncludeExample@@

Traducteur :TT22