Functions > FileDirDisk >

FileSelectFolder

Ouvre une bo�te de dialogue de s�lection de dossier.

FileSelectFolder ( "dialog text", "root dir" [, flag = 0 [, "initial dir" [, hwnd]]] )

Param�tres

dialog text Texte du message d'accueil de la bo�te de dialogue.
root dir R�pertoire racine de l'arborescence des fichiers propos�s. Utilisez "" pour que le bureau soit le r�pertoire racine.
flag [optionnel]
    $FSF_CREATEBUTTON (1) = Affiche un bouton de cr�ation de dossier (XP seulement)
    $FSF_NEWDIALOG (2)= Utilise un style de dialogue nouveau (XP seulement)
    $FSF_EDITCONTROL (4) = Affiche un contr�le Edit (XP seulement)

Les constantes sont d�finies dans FileConstants.au3.
initial dir [optionnel] Le chemin complet du dossier s�lectionn� (mis en surbrillance) lors de l'affichage de la bo�te de dialoque (s'il existe dans le dossier racine). Par d�faut, vide ("").
hwnd [optionnel] Le handle de la fen�tre � utiliser comme parent pour cette boite de dialogue.

Valeur de retour

Succ�s: Retourne le chemin complet du dossier choisi.
�chec: Renvoie "" (cha�ne vide) et @error = 1 si l'utilisateur annule/ferme le dialogue.

Remarque

Le r�pertoire racine sera choisi si le dossier initial (si donn�e en param�tre) n'existe pas.
Un r�pertoire racine inexistant entra�nera �galement que le dossier Bureau soit le r�pertoire racine.
Les dossiers Windows sp�ciaux (tels que "Mes Documents") peuvent �tre d�finis en tant que root en utilisant le bon CLSID d�taill�e dans l'Appendice.
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.

Le nouveau style de dialogue de Vista+ est utilis� si possible, suivant le flag Use New Dialog Style. Avec le style de dialogue de Vista le contr�le edit et les boutons de cr�ation de dossier sont toujours affich�s, ignorant les param�tres flag, et le param�tre texte du dialogue d�finit le titre de la fen�tre.

En relation

FileOpenDialog, FileSaveDialog

Exemple

#include <MsgBoxConstants.au3>

Example()

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

    ; Ouvre une bo�te de dialogue pour s�lectionner un dossier.
    Local $sFileSelectFolder = FileSelectFolder($sMessage, "")
    If @error Then
        ; Affiche le message d'erreur.
        MsgBox($MB_SYSTEMMODAL, "", "Aucun dossier n'a �t� s�lectionn�.")
    Else
        ; Affiche le dossier s�lectionn�.
        MsgBox($MB_SYSTEMMODAL, "", "Vous avez choisi le dossier suivant:" & @CRLF & $sFileSelectFolder)
    EndIf
EndFunc   ;==>Example