Compartilhar via


CShellManager::BrowseForFolder

Exibe uma caixa de diálogo que permite ao usuário selecionar uma pasta do 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
    A seqüência de caracteres usada pelo método para armazenar o caminho da pasta selecionada.

  • [in] pWndParent
    Um ponteiro para a janela pai.

  • [in] lplszInitialFolder
    Uma seqüência de caracteres que contém a pasta selecionada por padrão quando a caixa de diálogo é exibida.

  • [in] lpszTitle
    O título da caixa de diálogo.

  • [in] ulFlags
    Sinalizadores especificando opções para a caixa de diálogo.See BROWSEINFO descrição detalhada.

  • [out] piFolderImage
    Um ponteiro para o valor inteiro em que o método grava o índice de imagem da pasta selecionada.

Valor de retorno

Diferente de zero se o usuário seleciona uma pasta da caixa de diálogo; caso contrário, 0.

Comentários

Quando você chamar esse método, o aplicativo cria e mostra uma caixa de diálogo que permite ao usuário selecionar uma pasta.O método gravará o caminho da pasta no strOutFolder parâmetro.

Exemplo

O exemplo a seguir demonstra como recuperar uma referência a um CShellManager objeto usando o CWinAppEx::GetShellManager método e como usar o BrowseForFolder método. Neste trecho de código faz parte o Exemplo do Explorer: Aplicativo do MFC Windows 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

Cabeçalho: afxshellmanager.h

Consulte também

Conceitos

Gráfico de hierarquia do MFC

Referência

Classe CShellManager