< 프롭퍼티 시트 >

WTL에서 프롭퍼티 시트와 그 프롭퍼티 시트 상에 표시하는 탭(프롭퍼티 페이지)을 각각 CPropertySheetImpl, CPropertyPageImpl 라고 하는 템플릿 클래스에서 캡슐화하고 있습니다. 이러한 클래스는 ATL의 CDialogImpl클래스와 같이 base class로서의 보고 사용합니다. atldlgs.h 헤더에서는 각각의 상속 클래스로서 CPropertySheet클래스와 CPropertyPage클래스가 정의되고 있습니다.

// atldlgs.h

class CPropertySheet : public CPropertySheetImpl<CPropertySheet>

{

...

...

template <WORD t_wDlgTemplateID>

class CPropertyPage : public CPropertyPageImpl<CPropertyPage<t_wDlgTemplateID> >

{

...

...

　WTL의 CPropertySheet 클래스와 CPropertyPage클래스는 MFC의 동명의 클래스와 거의 같은 멤버 함수를 준비해 있습니다. 아래에 나타내는 것은 CPropertySheet클래스와 CPropertyPage 클래스를 사용하는 간단한 예 입니다. 다이얼로그 자원을 프롭퍼티 페이지에 관련 지어 그 페이지를 프롭퍼티 시트에 추가해 표시할 뿐입니다. 덧붙여 WTL의 프롭퍼티 시트 관련 클래스를 사용하기 위해서는 atldlgs.h 헤더를 인클루드 할 필요가 있습니다.

CPropertyPage<IDD_PROPPAGE_VERSION> page;

CPropertySheet sheet(_T("샘플"));

sheet.AddPage(page);

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

// [OK]버튼을 눌러 닫았을 때의 처리

}

우선 프로젝트에 프롭퍼티 페이지용의 다이얼로그 자원(IDD_PROPPAGE_MEDIUM)을 추가해 ID를IDD_PROPPAGE_VERSION로 변경합니다. 그리고 그 다이얼로그 자원에 스태틱 컨트롤을 배치해 캐릭터 라인이나 아이콘을 설정합니다. 이 다이얼로그 자원을 CPropertyPage 클래스의 템플릿 인수로 지정하는 것으로 프롭퍼티 페이지에 다이얼로그 자원을 관련 지을 수 있습니다. 프롭퍼티 페이지의 탭 부분에는 다이얼로그 자원의 타이틀 캐릭터 라인이 표시됩니다. 덧붙여 CPropertyPage 클래스의 constructor에 캐릭터 라인을 지정하면 그 캐릭터 라인이 탭 부분의 캐릭터 라인으로서 설정됩니다.

다음에 CPropertySheet 클래스의 인스턴스를 작성해 AddPage()에 의해 프롭퍼티 페이지를 프롭퍼티 시트에 추가합니다. 프롭퍼티 시트에는 AddPage()을 여러 차례 호출하는 것에 의해 복수의 프롭퍼티 페이지를 추가할 수 있습니다. CPropertySheet 클래스의 경우도 constructor에 캐릭터 라인을 지정하는 것에 의해 프롭퍼티 시트의 타이틀 캐릭터 라인을 설정할 수가 있습니다.

프롭퍼티 시트를 모달로 표시하기 위해서는 DoModal()을 사용합니다. [OK] 버튼을 눌러 파일 선택 다이얼로그를 닫은 경우는 반환값으로서 IDOK가 [캔슬]을 눌러 닫았을 경우는IDCANCEL이 반환됩니다. 덧붙여 Create()를 사용하면 프롭퍼티 시트를 모달리스로 표시할 수 있습니다.

　위의 예 에서는 단지 다이얼로그 자원상에 스태틱 컨트롤을 배치해 캐릭터 라인이나 아이콘 표시하는 것만으로 했다. 그러나 프롭퍼티 시트의 실제의 용도는 다이얼로그 리소스 상의 여러가지 컨트롤에 데이터를 설정하거나 그 데이터를 외부의 클래스와 교환합니다. 그런데, 다음은 CPropertySheetImpl클래스나 CPropertyPageImpl클래스로부터 상속 클래스를 작성하여 프롭퍼티 시트의 동작을 커스텀마이즈 하는 예를 나타냅니다.

우선 프로젝트에 프롭퍼티 페이지용의 다이얼로그 리소스(IDD_PROPPAGE_MEDIUM)를 추가해 ID를 IDD_PROPPAGE_WINDOW로 변경합니다. 이 다이얼로그 리소스에는 ID가 IDC_CHECK_TOPMOST의 체크 박스를 추가합니다.

다음에 CustomSheet.h 라고 하는 헤더 파일을 준비하여 거기에 CCustomPage 라고 하는 프롭퍼티 페이지 클래스를 정의합니다.

// CustomSheet.h

class CCustomPage : public CPropertyPageImpl<CCustomPage>

{

CButton m_button_topmost;

public:

enum { IDD = IDD_PROPPAGE_WINDOW };

bool m_bTopmost;

// constructor　 　

CCustomPage(ATL::_U_STRINGorID title = (LPCTSTR)NULL)

: CPropertyPageImpl<CCustomPage>(title)

{}

BEGIN_MSG_MAP_EX(CCustomPage)

MSG_WM_INITDIALOG(OnInitDialog)

CHAIN_MSG_MAP(CPropertyPageImpl<CCustomPage>)

END_MSG_MAP()

LRESULT OnInitDialog(HWND hWnd, LPARAM lParam){

m_button_topmost = GetDlgItem(IDC_CHECK_TOPMOST);

m_button_topmost.SetCheck(m_bTopmost);

return TRUE;

}

BOOL OnKillActive(){

m_bTopmost = (m_button_topmost.GetCheck() != 0);

return TRUE;

}

};

CCustomPage클래스는 CPropertyPageImpl클래스로부터 파생하고 있어(템플릿 인수는 아니고 ) enum에 의해 직접 다이얼로그 리소스 (IDD_PROPPAGE_WINDOW)을 관련 짓고 있습니다. 그리고, 체크 박스의 체크 상태를 나타내는 m_bTopmost라고 하는 bool 형태 멤버 변수를 가지고 있어 이 변수를 사용해 외부의 클래스와 데이터의 교환을 합니다. CCustomPage 클래스의 WM_INITDIALOG 메세지 핸들러에서는 이 변수의 값으로 체크 박스 상태를 초기화해 OnKillActive() 안에서 체크 박스 상태를 m_bTopmost에 보존합니다. OnKillActive()는 프롭퍼티 페이지가 포커스를 잃을 때([OK] 버튼을 눌러 프롭퍼티 시트를 닫을 때도 포함한다)에 불려 집니다. 즉, 프롭퍼티 시트(프롭퍼티 페이지)를 표시하기 전에 m_bTopmost에 값을 설정하여 프롭퍼티 시트(프롭퍼티 페이지)를 닫은 후에 m_bTopmost의 값을 취득하는 것에 의해 프롭퍼티 시트와 외부의 윈도우가 체크 박스 상태를 공유할 수가 있습니다.

　덧붙여 CCustomPage 클래스의 메세지 맵에서는 base class인 CPropertyPageImpl클래스에의 체인을 추가하고 있습니다. CPropertyPageImpl클래스는 메세지 맵을 준비하고 있어 이것은 프롭퍼티 페이지에 대한 WM_NOTIFY 메세지를 매핑 합니다. WM_NOTIFY 메세지 핸들러에서는 통지 코드에 의해 다음과 같은 멤버 함수를 호출합니다.

통지 코드	멤버 함수명
PSN_SETACTIVE	OnSetActive
PSN_KILLACTIVE	OnKillActive
PSN_APPLY	OnApply
PSN_RESET	OnReset
PSN_QUERYCANCEL	OnQueryCancel
PSN_WIZNEXT	OnWizardNext
PSN_WIZBACK	OnWizardBack
PSN_WIZFINISH	OnWizardFinish
PSN_HELP	OnHelp
PSN_GETOBJECT	OnGetObject
PSN_TRANSLATEACCELERATOR	OnTranslateAccelerator
PSN_QUERYINITIALFOCUS	OnQueryInitialFocus

CPropertyPageImpl 클래스의 상속 클래스는 이러한 멤버 함수를 오버라이드(override)하는 것에 의해 프롭퍼티 페이지의 동작을 커스텀마이즈 할 수가 있습니다.

　다음과 같이 CustomSheet.h 파일 내에 CCustomSheet 라고 하는 프롭퍼티 시트 클래스를 정의합니다.

// CustomSheet.h

class CCustomPage : public CPropertyPageImpl<CCustomPage>

{

...

};

class CCustomSheet : public CPropertySheetImpl<CCustomSheet>

{

public:

CCustomPage m_pageCustom;

CPropertyPage<IDD_PROPPAGE_VERSION> m_pageVersion;

// constructor　 　

CCustomSheet(ATL::_U_STRINGorID title = (LPCTSTR)NULL,

UINT uStartPage = 0, HWND hWndParent = NULL)

: CPropertySheetImpl<CCustomSheet>(title, uStartPage, hWndParent)

{

m_psh.dwFlags |= PSH_NOAPPLYNOW;

AddPage(m_pageCustom);

AddPage(m_pageVersion);

}

BEGIN_MSG_MAP_EX(CCustomSheet)

CHAIN_MSG_MAP(CPropertySheetImpl<CCustomSheet>)

END_MSG_MAP()

static int CALLBACK PropSheetCallback(HWND hWnd, UINT uMsg, LPARAM lParam){

if(uMsg == PSCB_PRECREATE){

// 문맥 헬프 버튼을 삭제

((LPDLGTEMPLATE)lParam)->style &= ~DS_CONTEXTHELP;

return 0;

}

return CPropertySheetImpl<CCustomSheet>::PropSheetCallback(hWnd, uMsg, lParam);

}

};

CCustomSheet클래스의 constructor인수는 CPropertySheet 클래스의 constructor 인수를 참고로 하고 있습니다. CCustomSheet 클래스의 constructor에서는 프롭퍼티 시트의 [적용] 버튼을 비 표시로 하기 위해서 PSH_NOAPPLYNOW 플래그를 추가하고 있습니다. 그리고, 멤버 변수로서 선언한 2개의 프롭퍼티 페이지를AddPage()에 의해 추가하고 있습니다. CCustomSheet 클래스에서는 프롭퍼티 시트의 문맥 헬프 버튼( 타이틀 바 위의[?]버튼) 을 비표시로 하기 위해서 PropSheetCallback() 콜백 함수를 오버라이드(override) 하고 있습니다. 이 함수에서는 PSCB_PRECREATE 메세지가 보내져 왔을 때에 DS_CONTEXTHELP스타일을 삭제하고 있습니다. 덧붙여 시스템에 IE5 이상이 인스톨 되고 있는 경우는 constructor으로 PSH_NOCONTEXTHELP 플래그를 추가하는 것으로 문맥 헬프 버튼을 비 표시로 할 수 있습니다.

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

// stdafx.h

#include <atlbase.h>

#include <atlapp.h>

extern CAppModule _Module;

#include <atlwin.h>

#include <atlcrack.h>

#include <atlmisc.h>

#include <atlctrls.h>

#include <atldlgs.h> // common dialog를 사용하기 위해(때문에)

// maindlg.h

class CMainDlg : public CDialogImpl<CMainDlg>

{

public:

enum { IDD = IDD_MAINDLG };

bool m_bTopmost;

// 메세지 맵

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);

m_bTopmost = false;

return TRUE;

}

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

CCustomSheet sheet(_T("샘플"));

sheet.m_pageCustom.m_bTopmost = m_bTopmost;

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

m_bTopmost = sheet.m_pageCustom.m_bTopmost;

SetWindowPos(m_bTopmost ? HWND_TOPMOST : HWND_NOTOPMOST,

0, 0, 0, 0, SWP_NOSIZE | SWP_NOMOVE | SWP_SHOWWINDOW);

}

}

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 "CustomSheet.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()를 추가해 거기서 CCustomSheet 클래스의 인스턴스를 작성해 DoModal()에 의해 독자적인 프롭퍼티 시트를 표시합니다.

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