< 폴더 선택 다이얼로그 >

WTL에서 폴더 선택 다이얼로그를 CFolderDialogImpl 이라고 하는 템플릿 클래스에서 캡슐화하고 있습니다. 이 클래스는 ATL의 CDialogImpl 클래스와 같이 base class로서의 보고 사용합니다. atldlgs.h 헤더에서는 CFileDialogImpl클래스의 상속 클래스로서 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클래스의 constructor인수는 모두 생략 할 수 있습니다만 , 여기에서는 제1인수에는 부모 윈도우의 핸들, 제2인수에는 폴더 선택 다이얼로그에 표시하는 캐릭터 라인을 지정해 있습니다. 이 외 제3인수에는 플래그를 지정할 수 있습니다.

폴더 선택 다이얼로그를 표시하기 위해서는 DoModal()을 사용합니다. [OK] 버튼을 눌러 폴더 선택 다이얼로그를 닫었을 경우는 반환 값으로서 IDOK가, [캔슬]을 눌러 닫았을 경우는IDCANCEL이 반환 됩니다.

IDOK가 반환된 경우는 CFileDialog 클래스의 멤버인 m_szFolderPath과 m_szFolderDisplayName에 각각 폴더 패스와 표시명이 설정되어 있습니다.

CFolderDialog 클래스의 base class인 CFolderDialogImpl클래스는 콜백 함수를 준비해 있습니다. 콜백 함수는 메세지에 의해 다음과 같은 메세지 핸들러를 호출합니다.

메세지	메세지 핸들러
BFFM_INITIALIZED	OnInitialized
BFFM_SELCHANGED	OnSelChanged
BFFM_VALIDATEFAILED	OnValidateFailed

CFolderDialogImpl클래스의 상속 클래스는 이러한 멤버 함수를 오버라이드(override) 하는 것에 의해 폴더 선택 다이얼로그의 동작을 커스텀마이즈 할 수가 있습니다.

다음에 나타내는 것은 OnInitialized()을 오버라이드(override)하여 독자적인 폴더 선택 다이얼로그를 작성하는 예입니다. 이 폴더 선택 다이얼로그는 디폴트로 현재 디렉토리를 선택하며 부모 윈도우의 중앙에 표시됩니다. 이 예에서는 CustomDlg.h이라고 하는 헤더 파일을 준비하여 거기에 CCustomDlg 클래스를 정의하고 있습니다.

// CustomDlg.h

class CCustomDlg : public CFolderDialogImpl<CCustomDlg>

{

public:

// constructor　 　

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 클래스의 constructor인수는 CFolderDialog클래스의 constructor인수를 참고로 하고 있습니다. OnInitialized() 그럼 초기화 처리를 합니다만 여기에서는 m_hWnd으로부터 CWindow 오브젝트를 작성해 CenterWindow()에 의해 다이얼로그를 중앙에 표시하고 있습니다. 또한 현재 디렉토리의 패스를 취득해 SetSelection()에 의해 선택하고 있습니다.

　다음에 나타내는 것은 CCustomDlg 클래스를 사용하는 예입니다.

// stdafx.h

#include <atlbase.h>

#include <atlapp.h>

extern CAppModule _Module;

#include <atlwin.h>

#include <atlcrack.h>

#include <atlmisc.h>

#include <atldlgs.h> // common dialog를 사용하기 위해

// maindlg.h

class CMainDlg : public CDialogImpl<CMainDlg>

{

public:

enum { IDD = IDD_MAINDLG };

// 메세지 맵

BEGIN_MSG_MAP_EX(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()

LRESULT OnInitDialog(HWND hWnd, LPARAM lParam){

// 스크린의 중앙에 배치

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, HWND hWndCtl){

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, HWND hWndCtl){

EndDialog(nID);

}

void OnCancel(UINT uNotifyCode, int nID, HWND hWndCtl){

EndDialog(nID);

}

};

// CommDlg.cpp

#include "stdafx.h"

#include "resource.h"

#include "CustomDlg.h"

#include "maindlg.h"

CAppModule _Module;

int WINAPI _tWinMain(HINSTANCE hInstance, HINSTANCE, LPTSTR lpCmdLine, int nCmdShow)

{

HRESULT hRes = ::CoInitialize(NULL);

ATLASSERT(SUCCEEDED(hRes));

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

AtlInitCommonControls(ICC_COOL_CLASSES | ICC_WIN95_CLASSES);

hRes = _Module.Init(NULL, hInstance);

ATLASSERT(SUCCEEDED(hRes));

int nRet = 0;

// BLOCK: 어플리케이션 실행

{

CMainDlg dlgMain;

nRet = dlgMain.DoModal();

}

_Module.Term();

::CoUninitialize();

return nRet;

}

　우선 리소스를 작성합니다. 다이얼로그에 버튼 컨트롤을 배치하여 리소스 ID를 다음과 같이 지정합니다.

컨트롤명	리소스 ID
푸쉬 버튼	IDC_BUTTON_OPENDLG

　다음에 stdafx.h 에서는 atldlgs.h 헤더를 인클루드 합니다.

　CMainDlg클래스에서는 버튼용의 커멘드 메세지 핸들러 OnButtonOpenDlg()를 추가하여 거기서 CCustomDlg 클래스의 인스턴스를 작성해 DoModal()에 의해 독자적인 폴더 선택 다이얼로그를 표시합니다.

　마지막으로 CommDlg.cpp 에서 maindlg.h 헤더의 앞에 CustomDlg.h 헤더를 인클루드 합니다.