フォルダ選択ダイアログ

ホーム

ATL/WTL

フォルダ選択ダイアログ

ドキュメント種別	ATL/WTL に関する文書
最終更新日	2007/04/08
PR

　WTLではフォルダ選択ダイアログを CFolderDialogImplというクラステンプレートでカプセル化しています。これはATLのCDialogImplクラステンプレートのように基底クラスとしてのみ使用します。 atldlgs.hヘッダではCFolderDialogImplから派生したCFolderDialogクラスが定義されています。

// atldlgs.h
class CFolderDialog : public CFolderDialogImpl<CFolderDialog>
{
    ...
    ...

　以下に示すのは、CFolderDialogクラスを使用する例です。

CFolderDialog dlg(NULL, _T("フォルダを選択してください。"));

if(dlg.DoModal() == IDOK){
    CString strMsg;
    strMsg.Format(_T("表示名：%s\nパス：%s"),
        dlg.GetFolderDisplayName(), dlg.GetFolderPath());
    MessageBox(strMsg);
}

CFolderDialogクラスのコンストラクタ引数はすべて省略できます。引数は順に、親ウィンドウのハンドル、フォルダ選択ダイアログに表示する文字列、フラグを指定できます。

フォルダ選択ダイアログを表示するためにはCFolderDialogクラスのメンバ関数であるDoModal()を呼び出します。［OK］ボタンを押してフォルダ選択ダイアログを閉じた場合は、戻り値としてIDOKが、［キャンセル］ボタンを押して閉じた場合はIDCANCELが返ります。

戻り値がIDOKの場合は、CFileDialogクラスのメンバ変数である m_szFolderPathとm_szFolderDisplayNameに、それぞれフォルダパスと表示名が設定されます。

CFolderDialogクラスの基底クラスであるCFolderDialogImplはコールバック関数を用意しており、メッセージによってに次のようなメッセージハンドラを呼び出します。

メッセージ	メッセージハンドラ
BFFM_INITIALIZED	OnInitialized
BFFM_SELCHANGED	OnSelChanged
BFFM_VALIDATEFAILED	OnValidateFailed

CFolderDialogImplの派生クラスは、これらのメンバ関数をオーバーライドすることによって、フォルダ選択ダイアログの動作をカスタマイズすることができます。

次に示すのは、OnInitialized()をオーバーライドして、独自のフォルダ選択ダイアログを作成する例です。プロジェクトにCustomDlg.hというヘッダファイルを追加し、そこにCCustomDlgというクラスを定義します。このフォルダ選択ダイアログはデフォルトでカレントディレクトリを選択し、親ウィンドウの中央に表示されます。

// CustomDlg.h
#pragma once

class CCustomDlg : public CFolderDialogImpl<CCustomDlg>
{
public:
    // コンストラクタ
    CCustomDlg(HWND hWndParent = NULL, LPCTSTR lpstrTitle = NULL,
        UINT uFlags = BIF_RETURNONLYFSDIRS)
        : CFolderDialogImpl<CCustomDlg>(hWndParent, lpstrTitle, uFlags)
    {}

    void OnInitialized(){
        CWindow wnd = m_hWnd;
        wnd.CenterWindow();

        TCHAR szPath[_MAX_PATH];
        GetCurrentDirectory(sizeof(szPath)/sizeof(TCHAR), szPath);
        SetSelection(szPath);
    }
};

CCustomDlgクラスのコンストラクタ引数は、 CFolderDialogクラスのコンストラクタ引数を参考にしています。 OnInitialized()ではm_hWndからCWindowオブジェクトを作成し、 CenterWindow()を呼び出してダイアログを中央に表示します。さらに、カレントディレクトリを取得し、 SetSelection()を呼び出してそのディレクトリを選択します。

　次に示すのは、CCustomDlgクラスを使用する例です。

	プロジェクトファイルダウンロード

// stdafx.h
#pragma once

#include <atlbase.h>
#include <atlapp.h>
extern CAppModule _Module;
#include <atlwin.h>

#include <atlcrack.h>
#include <atlmisc.h>
#include <atldlgs.h>  // コモンダイアログ用クラスを使用するため

// MainDlg.h
#pragma once

class CMainDlg : public CDialogImpl<CMainDlg>
{
public:
    enum { IDD = IDD_MAINDLG };

    BEGIN_MSG_MAP(CMainDlg)
        MSG_WM_INITDIALOG(OnInitDialog)
        COMMAND_ID_HANDLER_EX(IDC_BUTTON_OPENDLG, OnButtonOpenDlg)
        COMMAND_ID_HANDLER_EX(IDOK, OnOK)
        COMMAND_ID_HANDLER_EX(IDCANCEL, OnCancel)
    END_MSG_MAP()

    BOOL OnInitDialog(CWindow wndFocus, LPARAM lInitParam){
        // スクリーンの中央に配置
        CenterWindow();

        // 大きいアイコン設定
        HICON hIcon = AtlLoadIconImage(IDR_MAINFRAME, LR_DEFAULTCOLOR,
            ::GetSystemMetrics(SM_CXICON), ::GetSystemMetrics(SM_CYICON));
        SetIcon(hIcon, TRUE);
        
        // 小さいアイコン設定
        HICON hIconSmall = AtlLoadIconImage(IDR_MAINFRAME, LR_DEFAULTCOLOR,
            ::GetSystemMetrics(SM_CXSMICON), ::GetSystemMetrics(SM_CYSMICON));
        SetIcon(hIconSmall, FALSE);

        return TRUE;
    }

    void OnButtonOpenDlg(UINT uNotifyCode, int nID, CWindow wndCtl){
        CCustomDlg dlg(NULL, _T("フォルダを選択してください。"));

        if(dlg.DoModal() == IDOK){
            CString strMsg;
            strMsg.Format(_T("表示名：%s\nパス：%s"),
                dlg.GetFolderDisplayName(), dlg.GetFolderPath());
            MessageBox(strMsg);
        }
    }

    void OnOK(UINT uNotifyCode, int nID, CWindow wndCtl){
        EndDialog(nID);
    }

    void OnCancel(UINT uNotifyCode, int nID, CWindow wndCtl){
        EndDialog(nID);
    }
};

// SampleProject.cpp
#include "stdafx.h"
#include "resource.h"
#include "CustomDlg.h"
#include "MainDlg.h"

CAppModule _Module;

int WINAPI _tWinMain(HINSTANCE hInstance, 
    HINSTANCE /*hPrevInstance*/, LPTSTR /*lpstrCmdLine*/, int /*nCmdShow*/)
{
    HRESULT hRes = ::CoInitialize(NULL);
    ATLASSERT(SUCCEEDED(hRes));

    ::DefWindowProc(NULL, 0, 0, 0L);

    AtlInitCommonControls(ICC_BAR_CLASSES);

    hRes = _Module.Init(NULL, hInstance);
    ATLASSERT(SUCCEEDED(hRes));

    CMainDlg dlg;
    int nRet = (int) dlg.DoModal();

    _Module.Term();
    ::CoUninitialize();

    return nRet;
}

　まず、リソースを作成します。ダイアログにボタンコントロールを配置し、［ID］と［Caption］を次のように設定します。

コントロール名	ID	Caption
ボタン	IDC_BUTTON_OPENDLG	ダイアログを開く

　次に、stdafx.hヘッダでは、コモンダイアログを使用するためにatldlgs.hヘッダをインクルードします。

　CMainDlgクラスでは、リソースIDがIDC_BUTTON_OPENDLGのWM_COMMANDメッセージハンドラとして OnButtonOpenDlg()を追加します。このハンドラ関数ではCCustomDlgクラスのインスタンスを作成し、 DoModal()を呼び出して独自のフォルダ選択ダイアログを表示します。

　最後に、SampleProject.cppファイルでMainDlg.hヘッダの前にCustomDlg.hヘッダをインクルードします。