< 위저드 모드 >

전회는 통상의 프롭퍼티 시트를 작성했습니다만 CPropertySheetImpl클래스의 멤버 함수인 SetWizardMode() 을 호출하는 것에 의해 위저드 타입의 프롭퍼티 시트를 작성할 수가 있습니다.

CPropertyPage<IDD_PROPPAGE_VERSION> page;

CPropertySheet sheet;

sheet.AddPage(page);

sheet.SetWizardMode(); // 위저드 모드로 설정

sheet.DoModal();

우선 전회 작성한 프롭퍼티 페이지용의 다이얼로그 자원 IDD_PROPPAGE_VERSION 을 지정해 프롭퍼티 페이지를 작성해 그것을 프롭퍼티 시트에 추가합니다. 그리고 SetWizardMode()에 의해 위저드 모드로 합니다. 그리고 다이얼로그 자원의 타이틀 캐릭터 라인이 위저드의 타이틀로서 표시됩니다. 이와 같이 위저드 모드의 프롭퍼티 시트의 작성은 통상의 프롭퍼티 시트의 경우와 서로 너무 바뀝니다.

　그런데 위의 예에서는 [완료]버튼이 없습니다. 그리고 프롭퍼티 페이지상의 컨트롤이 있는 조건을 채웠을 경우만 [다음에] 버튼을 유효하게 하고 싶다고 하는 일이 있겠지요. 그러한 경우는 CPropertyPageImpl클래스로부터 파생시킨 독자적인 자산 페이지 클래스를 작성해 그 중에SetWizardButtons()를 호출해 버튼 상태를 설정합니다.

　다음에 나타내는 것은 CPropertySheetImpl 클래스나 CPropertyPageImpl클래스로부터 상속 클래스를 작성하여 독자적인 위저드 모드 프롭퍼티 시트를 작성하는 예입니다.

우선 프로젝트에 프롭퍼티 페이지용의 다이얼로그 자원을 2개 추가하여 각각의 ID를 IDD_PROPPAGE_CUSTOM과 IDD_PROPPAGE_FINISH로 변경합니다. 1번째의 다이얼로그 리소스(ID:IDD_PROPPAGE_CUSTOM)에는 ID가 IDC_CHECK_NEXT 의 체크 박스를 추가합니다.

다음으로 CustomWizard.h라고 하는 헤더 파일을 준비해 거기에 CCustomPage, CFinishPage라고 하는 프롭퍼티 페이지 클래스와 CCustomWizard라고 하는 프롭퍼티 시트 클래스를 정의합니다.

// CustomWizard.h

class CCustomPage : public CPropertyPageImpl<CCustomPage>

{

CButton m_button_topmost;

public:

enum { IDD = IDD_PROPPAGE_CUSTOM };

// constructor　 　

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

: CPropertyPageImpl<CCustomPage>(title)

{}

BEGIN_MSG_MAP_EX(CCustomPage)

MSG_WM_INITDIALOG(OnInitDialog)

COMMAND_ID_HANDLER_EX(IDC_CHECK_NEXT, OnCheckNext)

CHAIN_MSG_MAP(CPropertyPageImpl<CCustomPage>)

END_MSG_MAP()

LRESULT OnInitDialog(HWND hWnd, LPARAM lParam){

m_button_topmost = GetDlgItem(IDC_CHECK_NEXT);

return TRUE;

}

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

OnSetActive();

}

BOOL OnSetActive(){

// 체크 박스가 체크되고 있는 경우는[다음에]버튼을 유효하게 해 ,

// 그렇지 않으면 무효로 한다. [돌아오는]버튼은 항상 무효.

SetWizardButtons(m_button_topmost.GetCheck() ? PSWIZB_NEXT : 0);

return TRUE;

}

};

class CFinishPage : public CPropertyPageImpl<CFinishPage>

{

public:

enum { IDD = IDD_PROPPAGE_FINISH };

// constructor　 　

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

: CPropertyPageImpl<CFinishPage>(title)

{}

BEGIN_MSG_MAP_EX(CFinishPage)

CHAIN_MSG_MAP(CPropertyPageImpl<CFinishPage>)

END_MSG_MAP()

BOOL OnSetActive(){

// [돌아오는]버튼과[완료]버튼을 유효하게 한다.

// 덧붙여[다음에]버튼은[완료]버튼으로 옮겨진다.

SetWizardButtons(PSWIZB_BACK | PSWIZB_FINISH);

return TRUE;

}

};

class CCustomWizard : public CPropertySheetImpl<CCustomWizard>

{

public:

CCustomPage m_pageCustom;

CFinishPage m_pageFinish;

// constructor　 　

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

UINT uStartPage = 0, HWND hWndParent = NULL)

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

{

SetWizardMode(); // 위저드 모드로 설정

AddPage(m_pageCustom);

AddPage(m_pageFinish);

}

BEGIN_MSG_MAP_EX(CCustomWizard)

CHAIN_MSG_MAP(CPropertySheetImpl<CCustomWizard>)

END_MSG_MAP()

};

CCustomPage 클래스는 위저드의 1페이지째를 나타냅니다. 이 프롭퍼티 페이지에는 체크 박스가 한 개 있어 체크를 넣으면 SetWizardButtons(PSWIZB_NEXT)가 불려져 [다음에] 버튼이 유효하게 됩니다. 덧붙여OnSetActive()는 프롭퍼티 페이지가 액티브하게 될 때마다 불려 갑니다만 프롭퍼티 페이지가 최초로 표시되었을 때는 체크 박스는 체크되어 있지 않기 때문에 SetWizardButtons(0)가 불려져 [돌아오는] 버튼도 [다음에] 버튼도 무효가 됩니다.

CFinishPage클래스는 위저드의 2페이지째를 나타냅니다. 이 프롭퍼티 페이지는 스태틱 컨트롤로 메세지를 표시하고 있을 뿐입니다. 덧붙여 이 페이지가 위저드의 최후이므로OnSetActive()에서는 PSWIZB_FINISH을 지정해 SetWizardButtons()를 호출하는 것으로 [다음에] 버튼을[완료]버튼으로 변경하고 있습니다. 이와 같이 [다음에] 버튼과 [완료] 버튼은 공통의 버튼을 사용합니다.

CCustomWizard 클래스는 상기의 2개의 프롭퍼티 페이지 클래스의 인스턴스를 멤버 변수로 가져 constructor 　 으로 AddPage()를 호출하는 것에 의해 추가하고 있습니다. 그리고 constructor에서는 SetWizardMode()을 호출해 프롭퍼티 시트를 위저드 모드로 하고 있습니다.

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

// 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 };

// 메세지 맵

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

CCustomWizard wizard;

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

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

}

}

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 "CustomWizard.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()를 추가해 거기서 CCustomWizard 클래스의 인스턴스를 작성해 DoModal()에 의해 독자적인 위저드 모드 프롭퍼티 시트를 표시합니다. 덧붙여 표시한 위저드 모드의 프롭퍼티 시트를 [완료]버튼을 눌러 닫으면 DoModal()는 IDOK를 돌려줍니다.

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

Wizard97스타일

SetHeader()나 SetWatermark()를 호출하면 PSH_WIZARD97플래그가 설정되어 위저드를 Wizard97 스타일로 할 수가 있습니다. 　다음에 나타내는 것은 방금 전 작성한 위저드 클래스를 Wizard97스타일에 고쳐 쓰는 예입니다. // CustomWizard.h class CCustomPage : public CPropertyPageImpl<CCustomPage> { CButton m_button_topmost; public: enum { IDD = IDD_PROPPAGE_CUSTOM }; // constructor　 　 CCustomPage(ATL::_U_STRINGorID title = (LPCTSTR)NULL) : CPropertyPageImpl<CCustomPage>(title) { // 헤더 타이틀을 설정 SetHeaderTitle(_T("최초의 페이지")); SetHeaderSubTitle(_T("부제")); } BEGIN_MSG_MAP_EX(CCustomPage) MSG_WM_INITDIALOG(OnInitDialog) COMMAND_ID_HANDLER_EX(IDC_CHECK_NEXT, OnCheckNext) CHAIN_MSG_MAP(CPropertyPageImpl<CCustomPage>) END_MSG_MAP() LRESULT OnInitDialog(HWND hWnd, LPARAM lParam){ m_button_topmost = GetDlgItem(IDC_CHECK_NEXT); return TRUE; } void OnCheckNext(UINT uNotifyCode, int nID, HWND hWndCtl){ OnSetActive(); } BOOL OnSetActive(){ // 체크 박스가 체크되고 있는 경우는[다음에]버튼을 유효하게 해 , // 그렇지 않으면 무효로 한다. [돌아오는]버튼은 항상 무효. SetWizardButtons(m_button_topmost.GetCheck() ? PSWIZB_NEXT : 0); return TRUE; } }; class CFinishPage : public CPropertyPageImpl<CFinishPage> { public: enum { IDD = IDD_PROPPAGE_FINISH }; // constructor　 　 CFinishPage(ATL::_U_STRINGorID title = (LPCTSTR)NULL) : CPropertyPageImpl<CFinishPage>(title) { // 워터 마크를 표시하기 위해서 헤더를 비표시(?/font> m_psp.dwFlags |= PSP_HIDEHEADER; } BEGIN_MSG_MAP_EX(CFinishPage) CHAIN_MSG_MAP(CPropertyPageImpl<CFinishPage>) END_MSG_MAP() BOOL OnSetActive(){ // [돌아오는]버튼과[완료]버튼을 유효하게 한다. // 덧붙여[다음에]버튼은[완료]버튼으로 옮겨진다. SetWizardButtons(PSWIZB_BACK | PSWIZB_FINISH); return TRUE; } }; class CCustomWizard : public CPropertySheetImpl<CCustomWizard> { public: CCustomPage m_pageCustom; CFinishPage m_pageFinish; CBitmap bmpHeader; // 헤더용 비트 맵 CBitmap bmpWatermark; // 워터 마크용 비트 맵 // constructor　 　 CCustomWizard(ATL::_U_STRINGorID title = (LPCTSTR)NULL, UINT uStartPage = 0, HWND hWndParent = NULL) : CPropertySheetImpl<CCustomWizard>(title, uStartPage, hWndParent) { // 헤더용 비트 맵을 설정 bmpHeader.LoadBitmap(IDB_BITMAP_HEADER); SetHeader(bmpHeader); // 워터 마크용 비트 맵을 설정 bmpWatermark.LoadBitmap(IDB_BITMAP_WATERMARK); SetWatermark(bmpWatermark); AddPage(m_pageCustom); AddPage(m_pageFinish); } BEGIN_MSG_MAP_EX(CCustomWizard) CHAIN_MSG_MAP(CPropertySheetImpl<CCustomWizard>) END_MSG_MAP() }; 우선 헤더용으로 다음과 같은 비트맵 리소스를 프로젝트에 추가해 ID를 IDB_BITMAP_HEADER로 합니다. 그리고 워터 마크(틈새를 만들어 )용으로 다음과 같은 비트맵 리소스를 프로젝트에 추가해 ID를 IDB_BITMAP_WATERMARK로 합니다. 이러한 비트맵 리소스는 CCustomWizard 클래스의 constructor으로 위저드로 설정합니다. 위저드의 1페이지째에는 헤더 타이틀을 표시합니다. 그 때문에 CCustomPage 클래스의 constructor 　 으로 SetHeaderTitle()와 SetHeaderSubTitle()를 호출합니다. 위저드의 2페이지 째에는 워터 마크를 표시합니다. 워터 마크를 표시하기 위해서는 헤더를 비 표시로 할 필요가 있기때문에 CFinishPage 클래스의 constructor으로 PSP_HIDEHEADER 플래그를 설정합니다.