Click here to Skip to main content
13,193,442 members (53,298 online)
Click here to Skip to main content
Add your own
alternative version


53 bookmarked
Posted 16 Feb 2006

How to Browse for a Folder

, 16 Feb 2006
Rate this:
Please Sign up or sign in to vote.
This article presents a 'cut-n-paste' solution for getting the path to a directory.


This article presents a no-frills, cut-n-paste solution to the age-old problem of browsing for a folder. There are several classes out here that offer much more customization and a plethora of features, but I'm sure one more example won't hurt.

When to use this solution

The benefit of this approach over some of the others here is that this implementation is a direct wrapper function for SHBrowseForFolder. As such, you can use it in console applications that don't use MFC, such as unit-testing applications that could benefit from not hard-coding an output location for test results.

So, in short, if you're looking for eye candy, check out XFolderDialog or some of the other folder dialogs here. Otherwise, read on.

Using the code

To use this code, you need to include the following standard files:

#include "shlobj.h"
#include <string>

The GetFolder function


  • folderpath - A reference to the string that will contain the folder path if successful.
  • szCaption - An optional message for the dialog.
  • hOwner - An optional handle to the parent window.


  • true if successful, false if cancelled or an error occurs.
bool GetFolder(std::string& folderpath, 
               const char* szCaption = NULL, 
               HWND hOwner = NULL)
   bool retVal = false;

   // The BROWSEINFO struct tells the shell 
   // how it should display the dialog.
   memset(&bi, 0, sizeof(bi));

   bi.ulFlags   = BIF_USENEWUI;
   bi.hwndOwner = hOwner;
   bi.lpszTitle = szCaption;

   // must call this if using BIF_USENEWUI

   // Show the dialog and get the itemIDList for the 
   // selected folder.
   LPITEMIDLIST pIDL = ::SHBrowseForFolder(&bi);

   if(pIDL != NULL)
      // Create a buffer to store the path, then 
      // get the path.
      char buffer[_MAX_PATH] = {'\0'};
      if(::SHGetPathFromIDList(pIDL, buffer) != 0)
         // Set the string value.
         folderpath = buffer;
         retVal = true;

      // free the item id list


   return retVal;


Well, that's really all there is to it. If this code saves time for even one person out here, then the few minutes spent writing this was well worth it. Enjoy!


This article has no explicit license attached to it but may contain usage terms in the article text or the download files themselves. If in doubt please contact the author via the discussion board below.

A list of licenses authors might use can be found here


About the Author

Software Developer (Senior) Lockheed Martin
United States United States
Walter Storm is currently a principal software engineer doing quantitative research for a private hedge fund. Originally from Tunkhannock, PA., he has a B.S. in Aerospace Engineering from Embry-Riddle Aeronautical University[^], and an M.S. in Systems Engineering from SMU[^]. He has been professionally developing software in some form or another since January of 2001.

View Walter Storm's profile on LinkedIn.[^]

You may also be interested in...

Comments and Discussions

QuestionIs it possible to add a second rootFolder? Pin
Laudenberg15-Apr-15 22:40
memberLaudenberg15-Apr-15 22:40 
AnswerRe: Is it possible to add a second rootFolder? Pin
Laudenberg20-Apr-15 3:06
memberLaudenberg20-Apr-15 3:06 
GeneralWorks great on Windows 8.1... Pin
abdekker12325-Mar-15 1:33
memberabdekker12325-Mar-15 1:33 
QuestionHow to suppress dialog popups during mousover tree items. Pin
Vytas Adomkaitis16-Dec-14 8:49
memberVytas Adomkaitis16-Dec-14 8:49 
GeneralMy vote of 5 Pin
Phat (Phillip) H. VU17-Jan-13 14:54
memberPhat (Phillip) H. VU17-Jan-13 14:54 
GeneralMy vote of 5 Pin
Member 14304116-Jul-10 20:07
memberMember 14304116-Jul-10 20:07 
GeneralMFC - UNICODE Version Pin
exp2lnt19-Oct-08 17:20
memberexp2lnt19-Oct-08 17:20 
GeneralThanks Pin
papa_coder18-Mar-06 8:41
memberpapa_coder18-Mar-06 8:41 
GeneralRe: Thanks Pin
Nitron4-Apr-06 5:12
memberNitron4-Apr-06 5:12 
Questionbigger path? Pin
eXplodus16-Feb-06 19:54
membereXplodus16-Feb-06 19:54 
AnswerRe: bigger path? Pin
Nitron17-Feb-06 5:13
memberNitron17-Feb-06 5:13 
GeneralRe: bigger path? Pin
eXplodus19-Feb-06 20:53
membereXplodus19-Feb-06 20:53 
GeneralRe: bigger path? Pin
Galatei22-Feb-06 7:43
memberGalatei22-Feb-06 7:43 
QuestionPossible to preset a specific folder? Pin
Christof Schardt16-Feb-06 11:38
memberChristof Schardt16-Feb-06 11:38 
AnswerRe: Possible to preset a specific folder? Pin
Nitron16-Feb-06 11:44
memberNitron16-Feb-06 11:44 
GeneralRe: Possible to preset a specific folder? Pin
Christof Schardt16-Feb-06 11:50
memberChristof Schardt16-Feb-06 11:50 
GeneralRe: Possible to preset a specific folder? Pin
Nishant Sivakumar16-Feb-06 14:18
staffNishant Sivakumar16-Feb-06 14:18 
GeneralRe: Possible to preset a specific folder? Pin
Christof Schardt16-Feb-06 19:56
memberChristof Schardt16-Feb-06 19:56 
GeneralRe: Possible to preset a specific folder? Pin
Nishant Sivakumar17-Feb-06 1:23
staffNishant Sivakumar17-Feb-06 1:23 
GeneralRe: Possible to preset a specific folder? Pin
SBJ21-Feb-06 4:52
memberSBJ21-Feb-06 4:52 
GeneralRe: Possible to preset a specific folder? Pin
Nishant Sivakumar21-Feb-06 13:15
staffNishant Sivakumar21-Feb-06 13:15 
GeneralRe: Possible to preset a specific folder? Pin
SBJ21-Feb-06 13:27
memberSBJ21-Feb-06 13:27 
AnswerRe: Possible to preset a specific folder? Pin
Nitron17-Feb-06 3:32
memberNitron17-Feb-06 3:32 
AnswerRe: Possible to preset a specific folder? Pin
Stephan Poirier21-Feb-06 18:12
memberStephan Poirier21-Feb-06 18:12 
I have something for what you are looking for. It's a wrapper class called CShellHelpers that execute all the commands needed to :

1 - Set the starting path of SHBrowseForFolder before opening of the dialog
2 - Then Retrieve the selected path when the dialog is closed

With this wrapper, you can go up from your starting location. It use the BFFM_INITIALIZED message in the BrowseCtrlCallback function to sets the startup folder location.

There are also some other functions like :
1 - Retrieve the icon belonging to the selected folder.
2 - Shell context menu for a given path.
3 - Retrieve volume serial number
4 - Shell About..

Whenever I need to browse for a folder, I use it!
I don't remember when I did this code. From what I can remember, I took some portion of code here and there and assembled it to make this wrapper. The class is still in constant devellopment and is not really ready for release to public but since I came across this discussion, I thought it would be kind from me to let you have my code. I included a small example that show how it work.

Email me if you want to have it. I can't find the damn button to "Add files" to this post! Big Grin | :-D

Have fun!


Programming looks like taking drugs...
I think I did an overdose. Poke tongue | ;-P
AnswerRe: Possible to preset a specific folder? Pin
brightatlantis16-Oct-07 4:26
memberbrightatlantis16-Oct-07 4:26 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Praise Praise    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.

Permalink | Advertise | Privacy | Terms of Use | Mobile
Web03 | 2.8.171018.2 | Last Updated 16 Feb 2006
Article Copyright 2006 by Nitron
Everything else Copyright © CodeProject, 1999-2017
Layout: fixed | fluid