Aide:FileSaveDialog.txt

Document original V3.3.6.1 :

###Function###
FileSaveDialog

###Description###
Initiates a Save File Dialog.

###Syntax###
FileSaveDialog ( "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] 2 = Path Must Exist (if user types a path, ending with a backslash)
	 16 = Prompt to OverWrite File
default name
	[optional] File name to suggest to the user to save the file with.  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 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###
FileOpenDialog, FileSelectFolder


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

Document traduit V3.3.6.1 :

###Function###
FileSaveDialog

###Description###
Lance une boîte de dialogue "Enregistrer le fichier".

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


###Parameters###
@@ParamTable@@
title
	Titre de l'interface de dialogue.
init dir
	Répertoire initial affiché dans l'arborescence de fichier.
filter
	Filtre de type de fichier unique tel que "Tous les fichiers (*.*)" ou "Fichiers texte (*.txt)" ou plusieurs groupes de filtres tels que "Tous les fichiers (*.*)|Fichiers texte (*.txt)" (voir remarques).
options
	[optionnel] 2 = Le chemin doit exister (si l'utilisateur tape un chemin, se terminant par un contre-slash)
	 16 = Invite à écraser le fichier
default name
	[optionnel] Nom de fichier à suggérer à l'utilisateur pour l'enregistrement. Par défaut est vide ("").
hwnd
	[optionnel] Le handle de fenêtre à utiliser comme parent pour ce dialogue.
@@End@@

###ReturnValue###
@@ReturnTable@@
Succès:	Retourne le chemin complet du fichier choisi. Le résultat pour les sélections multiples est "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 un point-virgule comme le montre 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ée. Si une option n'est pas désirée, utilisez 0 pour cette option.

Les dossiers spéciaux Windows (tels que "Mes Documents") peut parfois être défini comme le répertoire d'initialisation, voir l'annexe.

@WorkingDir est modifié sur le retour.


###Related###
FileOpenDialog, FileSelectFolder


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

Traducteur : TT22