Compartilhar via


CShellManager::BrowseForFolder

Exibe uma caixa de diálogo que permite que o usuário selecione 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 cadeia de caracteres usada pelo método para armazenar o caminho da pasta selecionada.

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

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

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

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

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

Valor de retorno

Diferente de zero se o usuário seleciona uma pasta da caixa de diálogo; se não 0.

Comentários

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

Exemplo

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

Referência

Classe de CShellManager

Gráfico de hierarquia