CShellManager::BrowseForFolder
Displays a dialog box that enables the user to select a shell folder.
BOOL BrowseForFolder(
CString& strOutFolder,
CWnd* pWndParent = NULL,
LPCTSTR lplszInitialFolder = NULL,
LPCTSTR lpszTitle = NULL,
UINT ulFlags = BIF_RETURNONLYFSDIRS,
LPINT piFolderImage = NULL
);
Parameters
[out] strOutFolder
The string used by the method to store the path of the selected folder.[in] pWndParent
A pointer to the parent window.[in] lplszInitialFolder
A string that contains the folder that is selected by default when the dialog box is displayed.[in] lpszTitle
The title for the dialog box.[in] ulFlags
Flags specifying options for the dialog box. See BROWSEINFO for the detailed description.[out] piFolderImage
A pointer to the integer value where the method writes the image index of the selected folder.
Return Value
Nonzero if the user selects a folder from the dialog box; otherwise 0.
Remarks
When you call this method, the application creates and shows a dialog box that enables the user to select a folder. The method will write the path of the folder into the strOutFolder parameter.
Example
The following example demonstrates how to retrieve a reference to a CShellManager object by using the CWinAppEx::GetShellManager method and how to use the BrowseForFolder method. This code snippet is part of the Explorer sample.
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);
}
Requirements
Header: afxshellmanager.h