Functions > FileDirDisk >

FileSaveDialog

Ouvre une bo�te de dialogue d'enregistrement de fichier.

FileSaveDialog ( "title", "init dir", "filter" [, options = 0 [, "default name" [, hwnd]]] )

Param�tres

title Titre de la bo�te de dialogue.
init dir R�pertoire initial propos� � l'utilisateur.
filter Un seul filtre de type de fichier tel que "All (*.*)" ou "Text files (*.txt)" ou plusieurs groupes de filtres tels que "All (*.*)|Text files (*.txt)" (Consultez les Remarques).
options [optionnel] Options de dialogue: Pour utiliser plusieurs options, rassemblez-les avec BitOr.
    $FD_PATHMUSTEXIST (2) = Le chemin doit exister (si l'utilisateur tape un chemin, se terminant par un contre-slash)
    $FD_PROMPTOVERWRITE (16) = Invite � �craser le fichier

Les constantes sont d�finies dans FileConstants.au3
default name [optionnel] Nom de fichier � sugg�rer � l'utilisateur pour l'enregistrement. Par d�faut, cha�ne vide ("").
hwnd [optionnel] Le handle de la fen�tre � utiliser comme parent pour ce dialogue.

Valeur de retour

Succ�s: Retourne le nom complet du fichier choisi. Le r�sultat pour les s�lections multiples est au format "R�pertoire|fichier1|fichier2|..."
�chec: D�finit @error <> 0
@error: 1 - La s�lection de fichier a �chou�.
2 - Le filtre de fichier est incorrect.

Remarques

S�parez les filtres de fichiers avec un point-virgule comme le montre l'exemple.
Plusieurs groupes de filtres doivent �tre s�par�s par une barre verticale "|".

Si le nom par d�faut est donn�, les options doivent �galement �tre donn�es. Si une option n'est pas d�sir�e, utilisez 0 pour cette option.

Les dossiers sp�ciaux Windows (tel que "Mes Documents") peuvent parfois �tre d�fini comme le r�pertoire d'initialisation, Consultez l'Appendice.

@WorkingDir est modifi� apr�s un succ�s.

En relation

FileOpenDialog, FileSelectFolder

Exemple

#include <FileConstants.au3>
#include <MsgBoxConstants.au3>
#include <StringConstants.au3>

Example()

Func Example()
    ; Cr�e une constante locale avec le message � afficher dans FileSaveDialog.
    Local Const $sMessage = "Choisir un fichier."

    ; Affiche une bo�te de dialogue Enregistrer pour s�lectionner un fichier.
    Local $sFileSaveDialog = FileSaveDialog($sMessage, "::{450D8FBA-AD25-11D0-98A8-0800361B1103}", "Scripts (*.au3)", $FD_PATHMUSTEXIST)
    If @error Then
        ; Affiche le message d'erreur.
        MsgBox($MB_SYSTEMMODAL, "", "Aucun fichier n'a �t� sauvegard�.")
    Else
        ; R�cup�re le nom du fichier � partir du chemin complet, par exemple Example.au3.
        Local $sFileName = StringTrimLeft($sFileSaveDialog, StringInStr($sFileSaveDialog, "\", $STR_NOCASESENSE, -1))

        ;V�rifiez si l'extension .au3 est ajout�e � la fin du nom de fichier.
        Local $iExtension = StringInStr($sFileName, ".", $STR_NOCASESENSE)

        ; Si un point est trouv� alors v�rifie si l'extension est �gale � .au3
        If $iExtension Then
            ; Si l'extension n'est pas �gale � .au3 alors l'ajoute � la fin du chemin du fichier.
            If Not (StringTrimLeft($sFileName, $iExtension - 1) = ".au3") Then $sFileSaveDialog &= ".au3"
        Else
            ; Si aucun point n'a �t� trouv� alors l'ajoute � la fin du fichier.
            $sFileSaveDialog &= ".au3"
        EndIf

        ; Affiche le fichier enregistr�.
        MsgBox($MB_SYSTEMMODAL, "", "Le fichier suivant a �t� enregistr�:" & @CRLF & $sFileSaveDialog)
    EndIf
EndFunc   ;==>Example