CShellManager::BrowseForFolder

Visualizza una finestra di dialogo che consente all'utente di selezionare una cartella della shell.

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

Parametri

  • [out] strOutFolder
    La stringa utilizzata dal metodo per archiviare il percorso della cartella selezionata.

  • [in] pWndParent
    Puntatore alla finestra padre.

  • [in] lplszInitialFolder
    Stringa contenente la cartella selezionata per impostazione predefinita quando la finestra di dialogo.

  • [in] lpszTitle
    Il titolo della finestra di dialogo.

  • [in] ulFlags
    Flag che specificano opzioni per la finestra di dialogo.Vedere BROWSEINFO per la descrizione dettagliata.

  • [out] piFolderImage
    Un puntatore al valore intero in cui il metodo scrive il contenuto di immagine della cartella selezionata.

Valore restituito

Diverso da zero se l'utente seleziona una cartella nella finestra di dialogo, in caso contrario 0.

Note

Quando si chiama questo metodo, l'applicazione crea e visualizza una finestra di dialogo che consente all'utente di selezionare una cartella.Il metodo scriverà il percorso della cartella nel parametro strOutFolder.

Esempio

Nell'esempio seguente viene illustrato come recuperare un riferimento a un oggetto CShellManager tramite il metodo CWinAppEx::GetShellManager e come utilizzare il metodo BrowseForFolder.Questo frammento di codice fa parte Esempio 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);
    }

Requisiti

intestazione: afxshellmanager.h

Vedere anche

Riferimenti

Classe di CShellManager

Grafico della gerarchia