Méthode IShellDispatch.BrowseForFolder

Crée une boîte de dialogue qui permet à l’utilisateur de sélectionner un dossier, puis retourne l’objet Folder du dossier sélectionné.

Syntaxe

retVal = IShellDispatch.BrowseForFolder(
  Hwnd,
  sTitle,
  iOptions,
  [ vRootFolder ]
)

IShellDispatch.BrowseForFolder( _
  ByVal Hwnd As Integer, _
  ByVal sTitle As BSTR, _
  ByVal iOptions As Integer, _
  [ ByVal vRootFolder As Variant ] _
) As FOLDER

Paramètres

Hwnd [in]

Type : Integer

Handle de la fenêtre parente de la boîte de dialogue. Cette valeur peut être zéro.

sTitle [in]

Type : BSTR

Valeur string qui représente le titre affiché à l’intérieur de la boîte de dialogue Parcourir.

iOptions [in]

Type : Integer

Valeur Integer qui contient les options de la méthode . Il peut s’agir de zéro ou d’une combinaison des valeurs répertoriées sous le membre ulFlags de la structure BROWSEINFO .

vRootFolder [in, facultatif]

Type : Variant

Dossier racine à utiliser dans la boîte de dialogue. L’utilisateur ne peut pas parcourir plus haut dans l’arborescence que ce dossier. Si cette valeur n’est pas spécifiée, le dossier racine utilisé dans la boîte de dialogue est le bureau. Cette valeur peut être une chaîne qui spécifie le chemin du dossier ou l’une des valeurs ShellSpecialFolderConstants . Notez que les noms de constantes trouvés dans ShellSpecialFolderConstants sont disponibles en Visual Basic, mais pas en VBScript ou JScript. Dans ce cas, les valeurs numériques doivent être utilisées à leur place.

Valeur retournée

JScript

Type : DOSSIER**

Référence d’objet à l’objet Folder du dossier sélectionné.

VB

Type : DOSSIER**

Référence d’objet à l’objet Folder du dossier sélectionné.

Notes

Cette méthode est implémentée et accessible via la méthode Shell.BrowseForFolder .

Exemples

Les exemples suivants utilisent BrowseForFolder pour afficher une fenêtre de navigation intitulée « Exemple » enracinée dans le dossier Windows. L’utilisation s’affiche pour JScript, VBScript et Visual Basic.

Jscript:

<script language="JScript">
    function fnShellBrowseForFolderJ()
    {
        var objShell = new ActiveXObject("shell.application");
        var ssfWINDOWS = 36;
        var objFolder;
        
        objFolder = objshell.BrowseForFolder(0, "Example", 0, ssfWINDOWS);
        if (objFolder != null)
        {
            // Add code here.
        }
    }
</script>

Vbscript:

<script language="VBScript">
    function fnShellBrowseForFolderVB()
        dim objShell
        dim ssfWINDOWS
        dim objFolder
        
        ssfWINDOWS = 36
        set objShell = CreateObject("shell.application")
            set objFolder = objshell.BrowseForFolder(0, "Example", 0, ssfWINDOWS)
                if (not objFolder is nothing) then
                    'Add code here.
                end if
            set objFolder = nothing
        set objShell = nothing
    end function
 </script>

Visual Basic :

Private Sub fnShellBrowseForFolderVB()
    Dim objShell   As Shell
    Dim ssfWINDOWS As Long
    Dim objFolder  As Folder
    
    ssfWINDOWS = 36
    Set objShell = New Shell
        Set objFolder = objshell.BrowseForFolder(0, "Example", 0, ssfWINDOWS)
            If (Not objFolder Is Nothing) Then
                'Add code here
            End If
        Set objFolder = Nothing
    Set objShell = Nothing
End Sub

Spécifications

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel, Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
En-tête	Shldisp.h
IDL	Shldisp.idl
DLL	Shell32.dll (version 4.71 ou ultérieure)