Partager via


CShellManager::BrowseForFolder

Affiche une boîte de dialogue qui permet à l'utilisateur de sélectionner un dossier de shell.

BOOL BrowseForFolder(
   CString& strOutFolder,
   CWnd* pWndParent = NULL,
   LPCTSTR lplszInitialFolder = NULL,
   LPCTSTR lpszTitle = NULL,
   UINT ulFlags = BIF_RETURNONLYFSDIRS,
   LPINT piFolderImage = NULL
);

Paramètres

  • [out] strOutFolder
    La chaîne utilisée par la méthode pour enregistrer le chemin d'accès du dossier sélectionné.

  • [in] pWndParent
    Pointeur vers la fenêtre parente.

  • [in] lplszInitialFolder
    Une chaîne qui contient le dossier sélectionné par défaut lorsque la boîte de dialogue s'affiche.

  • [in] lpszTitle
    Le titre de la boîte de dialogue.

  • [in] ulFlags
    Indicateurs spécifiant des options de la boîte de dialogue.Consultez BROWSEINFO pour une description détaillée.

  • [out] piFolderImage
    Un pointeur vers la valeur entière où la méthode écrit l'index d'image du dossier sélectionné.

Valeur de retour

Une valeur différente de zéro si l'utilisateur sélectionne un dossier de la boîte de dialogue ; sinon 0.

Notes

Lorsque vous appelez cette méthode, l'application crée et affiche une boîte de dialogue qui permet à l'utilisateur de sélectionner un répertoire.La méthode écrira le chemin d'accès du répertoire dans le paramètre d' strOutFolder .

Exemple

L'exemple suivant montre comment récupérer une référence à un objet d' CShellManager à l'aide de la méthode d' CWinAppEx::GetShellManager et comment utiliser la méthode d' BrowseForFolder .Cet extrait de code fait partie d' Exemple explorer.

    CString strPath;
    // The this pointer points to the CExplorerView class which extends the CView class.
    // CMFCShellListCtrl m_wndList
    if (m_wndList.GetCurrentFolder (strPath) &&
        theApp.GetShellManager ()->BrowseForFolder (strPath, 
            this, strPath, _T("Copy the selected item(s) to the folder:")))
    {
        MessageBox (CString (_T("The selected path is: ")) + strPath);
    }

Configuration requise

en-tête : afxshellmanager.h

Voir aussi

Référence

Classe de CShellManager

Graphique de la hiérarchie