一个MFC风格的BrowseForFolder 封装类

来源：互联网发布：websoc是什么软件编辑：程序博客网时间：2024/05/23 12:25

原文链接：CYABFFW: Yet Another BrowseForFolder Wrapper

以良好的MFC风格将Shell API函数SHBrowseForFolder()封装为一个CWnd子类。

使用示例1：

CYABFFW dlg();
if (IDOK == dlg.DoModal())
{
    CString s = dlg.GetPath();
    // Do something with `s'

使用示例2：

CYABFFW dlg(_T("Please select a directory"), // Hint to user

BIF_USE_NEWUI, // Flags for the dlg

this, // Parent window

CSIDL_DRIVES); // Root of search

if (IDOK == dlg.DoModal())

{

CString s = dlg.GetPath();

// Do something with `s'

YABFFW.h

class CYABFFW : public CWnd

{

// Construction

public:

/// Construct with a textual hint, BFF flags, parent window, a

/// root folder expressed as a CSIDL value, and a default

/// selection expressed as a textual path

CYABFFW(const CString &strHint = CString(), UINT nFlags = 0U,

CWnd *pParentWnd = NULL, int nRootFolder = CSIDL_DESKTOP,

const CString &strDefaultSel = CString());

/// Construct with a default selection expressed as a CSIDL

/// value, a textual hint, BFF flags, parent window, & a root

/// folder expressed as a CSIDL value

CYABFFW(int nDefaultSel, const CString &strHint = CString(),

UINT nFlags = 0U, CWnd *pParentWnd = NULL,

int nRootFolder = CSIDL_DESKTOP);

/// Construct with a hint from Resource, BFF flags, parent

/// window, a root folder expressed as a CSIDL value, and a

/// default selection expressed as a textual path

CYABFFW(int nHint, UINT nFlags = 0U, CWnd *pParentWnd = NULL,

int nRootFolder = CSIDL_DESKTOP,

const CString &strDefaultSel = CString());

/// Construct with a hint from Resource, a default selection

/// expressed as a CSIDL value, BFF flags, parent window, & a

/// root folder expressed as a CSIDL value

CYABFFW(int nDefaultSel, int nHint, UINT nFlags = 0U,

CWnd *pParentWnd = NULL, int nRootFolder = CSIDL_DESKTOP);

/// Construct with a textual hint, an arbitrary root folder,

/// BFF flags, a parent window, and a default selection

/// expressed as a textual path

CYABFFW(const CString &strHint, const CString &strRoot,

UINT nFlags = 0U, CWnd *pParentWnd = NULL,

const CString &strDefaultSel = CString());

/// Construct with a textual hint, a default selection

/// expressed as a CSIDL value, an arbitrary root folder, BFF

/// flags, & a parent window

CYABFFW(int nDefaultSel, const CString &strHint, const CString &strRoot,

UINT nFlags = 0U, CWnd *pParentWnd = NULL);

/// Construct with a hint from Resource, an arbitrary root

/// folder, BFF flags, a parent widnow, and a textual default

/// selection

CYABFFW(int nHint, const CString &strRoot, UINT nFlags = 0U,

CWnd *pParentWnd = NULL,

const CString &strDefaultSel = CString());

/// Construct with a hint from Resource, a default selection

/// expressed as a CSIDL value, an arbitrary root folder, BFF

/// flags, & a parent widnow

CYABFFW(int nDefaultSel, int nHint, const CString &strRoot,

UINT nFlags = 0U, CWnd *pParentWnd = NULL);

// Attributes

public:

/// Retrieve the display name of the selected item

CString GetDisplayName() const;

/// Retrieve the ITEMIDLIST of the selected item

LPCITEMIDLIST GetItemIdList() const;

/// Retrieve the path to the selected item

CString GetPath() const;

// Operations

public:

/// Display the Dialog - returns IDOK or IDCANCEL

int DoModal();

// Overrides

public:

/// Called when the BFF Dialog has initialized

virtual void OnInitBFFDialog();

/// Called when the selection has changed in the tree control

virtual void OnBFFSelChanged(LPITEMIDLIST pNewSel);

/// Called when the user types an invalid name

virtual BOOL OnBFFValidateFailed(const CString &strBadName);

// ClassWizard generated virtual function overrides

//{{AFX_VIRTUAL(CYABFFW)

//}}AFX_VIRTUAL

// Implementation

public:

virtual ~CYABFFW();

// Generated message map functions

protected:

//{{AFX_MSG(CYABFFW) NOTE - the ClassWizard will add and remove

// member functions here.

//}}AFX_MSG

DECLARE_MESSAGE_MAP()

private:

/// Static method to be used for the SHBFF callback

static int CALLBACK BrowseCallbackProc(HWND hWnd, UINT nMsg,

LPARAM lParam,

LPARAM lpData);

private:

/// Free the memory referenced by m_pItemIdList

void FreeItemIdList(IMalloc *pMalloc = NULL);

/// CSIDL => ITEMIDLIST

LPITEMIDLIST ResolveCsidl(int nCsidl) const;

/// Textual filesystem path => ITEMIDLIST

LPITEMIDLIST ResolveFsPath(const CString &strPath) const;

private:

/// Display name of the selected item

CString m_strDisplayName;

/// Flags to be passed to the browse dialog

UINT m_nFlags;

/// "Hint" to be displayed above the tree control

CString m_strHint;

/// ITEMIDLIST identifying the selected Shell item

LPITEMIDLIST m_pItemIdList;

/// Parent CWnd (NULL => App main window)

CWnd *m_pParentWnd;

/// Selected path

CString m_strPath;

/// ITEMIDLIST identifying the root

LPITEMIDLIST m_pRoot;

/// Default selection, if given as text (empty if none)

CString m_strDefaultSel;

/// Default selection, if given as a CSIDL value (NULL if none)

LPITEMIDLIST m_pDefaultSel;

};

YABFFW.cpp