CShellManager::BrowseForFolder
Muestra un cuadro de diálogo que permite al usuario seleccionar una carpeta de shell.
BOOL BrowseForFolder(
CString& strOutFolder,
CWnd* pWndParent = NULL,
LPCTSTR lplszInitialFolder = NULL,
LPCTSTR lpszTitle = NULL,
UINT ulFlags = BIF_RETURNONLYFSDIRS,
LPINT piFolderImage = NULL
);
Parámetros
[out] strOutFolder
La cadena utilizada por el método para almacenar la ruta de la carpeta seleccionada.[in] pWndParent
Puntero en la ventana primaria.[in] lplszInitialFolder
Una cadena que contiene la carpeta que está seleccionado de forma predeterminada cuando se muestra el cuadro de diálogo.[in] lpszTitle
El título para el cuadro de diálogo.[in] ulFlags
Marcas que especifican las opciones del cuadro de diálogo. Vea BROWSEINFO para la descripción detallada.[out] piFolderImage
Un puntero al valor entero donde el método escribe el índice de la imagen de la carpeta seleccionada.
Valor devuelto
Distinto de cero si el usuario selecciona una carpeta del cuadro de diálogo; si no 0.
Comentarios
Cuando se llama a este método, la aplicación crea y muestra un cuadro de diálogo que permite al usuario seleccionar una carpeta. el método escribirá la ruta de la carpeta en el parámetro de strOutFolder .
Ejemplo
El ejemplo siguiente muestra cómo recuperar una referencia a un objeto de CShellManager utilizando el método de CWinAppEx::GetShellManager y cómo utilizar el método de BrowseForFolder . Este fragmento de código es parte de Ejemplo 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);
}
Requisitos
encabezado: afxshellmanager.h