Aide:FileSelectFolder.txt

Document original V3.3.6.1 :

###Function###
FileSelectFolder

###Description###
Initiates a Browse For Folder dialog.

###Syntax###
FileSelectFolder ( "dialog text", "root dir" [, flag [, "initial dir" [, hwnd]]] )


###Parameters###
@@ParamTable@@
dialog text
	Text greeting in dialog.
root dir
	Root directory of GUI file tree.  Use "" for Desktop to be root.
flag
	[optional] 1 = Show Create Folder Button (requires IE6.0 or later)
	 2 = Use New Dialog Style (requires IE5.0 or later)
	 4 = Show Edit Control (to type a foldername)
initial dir
	[optional] Initial/start directory that will be selected if exist.  Default is blank ("").
hwnd
	[optional] The window handle to use as the parent for this dialog.
@@End@@

###ReturnValue###
@@ReturnTable@@
Success:	Returns full path of the folder chosen.
Failure:	Returns "" (blank string) and sets @error to 1 if user cancels/closes the window.
@@End@@


###Remarks###
The root dir will be chosen if the initial dir (if given) does not exist.
A nonexistent root dir will also cause the Desktop folder to be root.
The "Create Folder Button" option may require Windows XP with IE6 in order to work.
Special Windows folders (such as "My Documents") can be set as root by using the right CLSID detailed in the Appendix.
UNC paths are not supported.  If you think that user's may choose files on a UNC path then the path needs to be mapped as a drive first.

###Related###
FileSaveDialog, FileOpenDialog


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

Document traduit V3.3.6.1 :

###Function###
FileSelectFolder

###Description###
Lance une boîte de dialogue pour choisir un dossier.

###Syntax###
FileSelectFolder ( "dialog text", "root dir" [, flag [, "initial dir" [, hwnd]]] )


###Parameters###
@@ParamTable@@
dialog text
	Texte du message d'accueil de la boîte de dialogue.
root dir
	Répertoire racine de l'arborescence de fichiers. Utilisez "" pour que le bureau soit le répertoire racine.
flag
	[optionnel] 1 = Affiche un bouton créer un dossier (nécessite IE6.0 ou supérieur)
	 2 = Utiliser un style de boîte de dialogue nouveau (nécessite IE5.0 ou supérieur)
	 4 = Afficher un contrôle Edit (pour taper un nom de dossier)
initial dir
	[optionnel] Répertoire initial/de départ qui sera choisi s'il existe. Par défaut est vide ("").
hwnd
	[optionnel] Le handle de fenêtre à utiliser comme parent pour cette la boite de dialogue.
@@End@@

###ReturnValue###
@@ReturnTable@@
Succès:	Retourne le chemin complet du dossier choisi.
Échec:	Renvoie "" (chaîne vide) et met @error à 1 si l'utilisateur annule/ferme la fenêtre.
@@End@@


###Remarks###
Le répertoire racine sera choisi si le dossier initial (si donnée) n'existe pas.
Un répertoire racine inexistant entraînera également que le dossier Bureau soit le répertoire racine.
Le bouton "créer un Dossier" (en option) peut nécessiter Windows XP avec IE6 pour fonctionner.
Les dossiers Windows spéciaux (tels que "Mes Documents") peuvent être définis en tant que root en utilisant le droit CLSID détaillée dans l'Annexe.
Les chemins UNC ne sont pas pris en charge. Si vous pensez que l'utilisateur peut avoir besoin de choisir les fichiers sur un chemin UNC, le chemin doit être mappé comme un premier disque.

###Related###
FileSaveDialog, FileOpenDialog


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

Traducteur :TT22