< 파일 선택 다이얼로그 >

WTL은 common dialog의 파일 선택 다이얼로그를 CFileDialogImpl이라고 하는 템플릿 클래스에서 캡슐화하고 있습니다. 이 클래스는 ATL의 CDialogImpl 클래스와 같이 base class로서의 보고 사용합니다. atldlgs.h 헤더에서는 CFileDialogImpl 클래스의 상속 클래스로서 CFileDialog 클래스가 정의되고 있습니다.

// atldlgs.h

class CFileDialog : public CFileDialogImpl<CFileDialog>

{

...

...

CFileDialog 클래스는 [파일을 여는] 다이얼로그와 [이름을 붙여 보존] 다이얼로그를 서포트하고 있습니다.

　WTL의 CFileDialog 클래스는 MFC의 동명의 클래스와 동등의 기능을 갖추고 있습니다. 이하에 나타내는 것은 CFileDialog 클래스를 사용하는 예 입니다. 덧붙여 WTL의 common dialog 클래스를 사용하기 위해서는 atldlgs.h 헤더를 포함 할 필요가 있습니다.

// [파일을 여는]다이얼로그

CFileDialog dlg(TRUE, _T("txt"), NULL, OFN_HIDEREADONLY | OFN_CREATEPROMPT,

_T("텍스트 파일 (*.txt)\0*.txt\0모든 파일 (*.*)\0*.*\0\0"));

if(dlg.DoModal() == IDOK){

CString strMsg;

strMsg.Format(_T("파일명：%s\n파스：%s"), dlg.m_szFileTitle, dlg.m_szFileName);

MessageBox(strMsg);

}

// [이름을 붙여 보존]다이얼로그

CFileDialog dlg(FALSE, _T("txt"), _T("무제"), OFN_OVERWRITEPROMPT,

_T("텍스트 파일 (*.txt)\0*.txt\0모든 파일 (*.*)\0*.*\0\0"));

if(dlg.DoModal() == IDOK){

CString strMsg;

strMsg.Format(_T("파일명：%s\n패스：%s"), dlg.m_szFileTitle, dlg.m_szFileName);

MessageBox(strMsg);

}

CFileDialog 클래스의 constructor의 제1인수에는BOOL값을 지정합니다. TRUE의 경우는 [파일을 여는] 다이얼로그를 작성하며, FALSE의 경우는 [이름을 붙여 보존] 다이얼로그를 작성합니다. 나머지의 인수는 생략 가능하며 순서에 디폴트 확장자(extension), 디폴트 파일명 , 플래그 , 필터 , 부모 윈도우의 핸들입니다.

파일 선택 다이얼로그를 표시하기 위해서는 DoModal()을 사용합니다. [여는](또는[보존]) 버튼을 눌러 파일 선택 다이얼로그를 다물었을 경우는 반환 값으로서 IDOK가, [캔슬]을 눌러 닫았을 경우는IDCANCEL이 되돌아 옵니다.

IDOK해서 되돌아 왔을 경우는 CFileDialog 클래스의 멤버인 m_szFileTitle과m_szFileName에 각각 파일명과 파일 패스가 설정되어 있습니다.

CFileDialog 클래스의 base class인 CFileDialogImpl클래스는 메세지 맵을 준비해 있습니다. 이것은 파일 선택 다이얼로그용의 WM_NOTIFY 메세지를 매핑 합니다. 메세지 맵은 WM_NOTIFY 메세지의 통지 코드에 의해 간접적으로 다음과 같은 멤버 함수를 호출합니다.

통지 코드	멤버 함수명
CDN_FILEOK	OnFileOK
CDN_FOLDERCHANGE	OnFolderChange
CDN_HELP	OnHelp
CDN_INITDONE	OnInitDone
CDN_SELCHANGE	OnSelChange
CDN_SHAREVIOLATION	OnShareViolation
CDN_TYPECHANGE	OnTypeChange

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

다음에 나타내는 것은 OnInitDone()이라는 OnHelp()를 오버라이드(override) 하여 독자적인 파일 선택 다이얼로그를 작성하는 예입니다. 이 파일 선택 다이얼로그에는 [헬프] 버튼이 추가되어 부모 윈도우의 중앙에 표시됩니다. 이 예에서는 CustomDlg.h이라고 하는 헤더 파일을 준비하고 거기에 CCustomDlg클래스를 정의하고 있습니다.

// CustomDlg.h

class CCustomDlg : public CFileDialogImpl<CCustomDlg>

{

public:

// constructor　 　

CCustomDlg(BOOL bOpenFileDialog,

LPCTSTR lpszDefExt = NULL,

LPCTSTR lpszFileName = NULL,

DWORD dwFlags = OFN_HIDEREADONLY | OFN_OVERWRITEPROMPT,

LPCTSTR lpszFilter = NULL,

HWND hWndParent = NULL)

: CFileDialogImpl<CCustomDlg>(bOpenFileDialog,

lpszDefExt, lpszFileName, dwFlags, lpszFilter, hWndParent)

{

// [헬프]버튼을 표시하기 위해서OFN_SHOWHELP플래그 추가

m_ofn.Flags |= OFN_SHOWHELP;

}

void OnInitDone(LPOFNOTIFY lpon){

// 파일 선택 다이얼로그를 친윈도우의 중심으로 표시

GetFileDialogWindow().CenterWindow();

}

void OnHelp(LPOFNOTIFY lpon){

// 현재 열려 있는 폴더 패스를 취득

TCHAR szPath[_MAX_PATH];

GetFolderPath(szPath, sizeof(szPath)/sizeof(TCHAR));

CString strMsg;

strMsg.Format(_T("현재의 폴더는 %s 입니다. "), szPath);

MessageBox(strMsg);

}

};

CCustomDlg 클래스의 constructor인수는 CFileDialog 클래스의 constructor인수를 참고로 하고 있습니다. constructor내에서는 파일 선택 다이얼로그에 [헬프] 버튼을 추가하기 위해서 OFN_SHOWHELP플래그를 추가합니다. OnInitDone()에서 초기화 처리를 합니다만 여기에서는 GetFileDialogWindow()에 의해 파일 선택 다이얼로그의 윈도우 오브젝트를 취득하여 CenterWindow()에 의해 다이얼로그를 중앙에 표시하고 있습니다. OnHelp()은 [헬프] 버튼을 눌렀을 때에 불려집니다. 여기에서는 현재 열려 있는 폴더 패스를 메시지 박스로 표시하고 있을 뿐입니다.

　다음에 나타내는 것은 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(FALSE, _T("txt"), _T("무제"), OFN_OVERWRITEPROMPT,

_T("텍스트 파일 (*.txt)\0*.txt\0모든 파일 (*.*)\0*.*\0\0"));

if(dlg.DoModal() == IDOK){

CString strMsg;

strMsg.Format(_T("파일명：%s\n패스：%s"),

dlg.m_szFileTitle, dlg.m_szFileName);

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 헤더를 인클루드 합니다. atldlgs.h 헤더에는 common dialog용 클래스가 정의되고 있습니다.

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

　마지막으로 CommDlg.cpp 에서 maindlg.h 헤더의 앞에 CustomDlg.h 헤더를 포함 합니다.