CShellManager::BrowseForFolder

Zeigt ein Dialogfeld an, in dem Benutzer ermöglicht, einen Shellordner auszuwählen.

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

Parameter

  • [out] strOutFolder
    Die Zeichenfolge wird durch die Methode, um den Pfad des ausgewählten Ordners zu speichern.

  • [in] pWndParent
    Ein Zeiger auf das übergeordnete Fenster.

  • [in] lplszInitialFolder
    Eine Zeichenfolge, die den Ordner enthält, standardmäßig ausgewählt, wenn das Dialogfeld angezeigt wird.

  • [in] lpszTitle
    Der Name für das Dialogfeld.

  • [in] ulFlags
    Flags, die Optionen für das Dialogfeld angeben.Siehe BROWSEINFO für die ausführliche Beschreibung.

  • [out] piFolderImage
    Ein Zeiger auf den ganzzahligen Wert, in dem die Methode den Bildindex des ausgewählten Ordners schreibt.

Rückgabewert

Ungleich 0 (null), wenn der Benutzer einen Ordner aus dem Dialogfeld auswählt; 0 andernfalls.

Hinweise

Wenn Sie diese Methode aufrufen, erstellt die Anwendung erstellt und zeigt ein Dialogfeld an, das den Benutzer ermöglicht, einen Ordner auszuwählen.Die Methode schreibt den Pfad des Ordners im strOutFolder-Parameter.

Beispiel

Das folgende Beispiel zeigt, wie ein Verweis auf ein CShellManager-Objekt abrufen, indem die CWinAppEx::GetShellManager-Methode erstellt wird und wie die BrowseForFolder-Methode verwendet.Dieser Codeausschnitt ist Teil Explorer-Beispiel.

    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);
    }

Anforderungen

Header: afxshellmanager.h

Siehe auch

Referenz

CShellManager-Klasse

Hierarchien-Diagramm