< DDX / DDV >

MFC에서는 DDC/DDV라고 하는 구조가 준비되어 있습니다만, WTL에서도 DDX/DDV가 준비되어 있습니다.
다만 MFC의 그것과는 조금 사용 방법이 다릅니다. 여기에서는 WTL의 DDX/DDV에 대해서 설명 합니다.

DDX

　DDX(dialog data exchange) 는 다이얼로그 상의 컨트롤의 초기화와 컨트롤과의 데이터의 교환을 단순화하기 위한 구조입니다.

여기서 말하는 컨트롤의 초기화란 서브 클래스화하거나 윈도우 핸들을 컨트롤 클래스로 설정하거나 하는 것을 의미합니다. 컨트롤과의 데이터의 교환이란 지정한 변수의 값을 컨트롤로 설정하거나 컨트롤로부터 취득한 값을 지정한 변수에 대입하는 것을 의미합니다.

　다음에 나타내는 것은 이DDX를 사용하는 예입니다. 1로부터 에디트 컨트롤에 입력한 값까지의 총화를 요구합니다. (예를 들면10을 입력했을 경우 ,1+2+3+···+10(을)를 계산. ) 덧붙여 값의 상한은100으로 합니다.

// stdafx.h

#include <atlbase.h>

#include <atlapp.h>

extern CAppModule _Module;

#include <atlwin.h>

#include <atlcrack.h>

#include <atlmisc.h>

#include <atlctrls.h>

#include <atlddx.h> // DDX/DDV을 사용하기 위해

// maindlg.h

class CMainDlg : public CDialogImpl<CMainDlg>, public CWinDataExchange<CMainDlg>

{

public:

enum { IDD = IDD_MAINDLG };

// constructor　 　

CMainDlg() : m_nInput(1)

{}

CEdit m_edit_input;

int m_nInput;

// DDX맵

BEGIN_DDX_MAP(CMainDlg)

DDX_CONTROL_HANDLE(IDC_EDIT_INPUT, m_edit_input)

DDX_INT(IDC_EDIT_INPUT, m_nInput)

END_DDX_MAP()

// 메세지 맵

BEGIN_MSG_MAP_EX(CMainDlg)

MSG_WM_INITDIALOG(OnInitDialog)

COMMAND_ID_HANDLER_EX(IDC_BUTTON_SUM, OnButtonSum)

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

// 컨트롤 설정

DoDataExchange(FALSE);

m_edit_input.LimitText(3);

return TRUE;

}

void OnDataExchangeError(UINT nCtrlID, BOOL bSave){

CString strMsg;

strMsg.Format(_T("컨트롤(ID:%u) 과의 데이터 교환에 실패. "), nCtrlID);

MessageBox(strMsg, _T("DDX에러"), MB_ICONWARNING);

::SetFocus(GetDlgItem(nCtrlID));

}

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

if(DoDataExchange(TRUE)){

// 치 체크

if(m_nInput < 1 || 100 < m_nInput){

MessageBox(_T("1 로부터 100 까지 의 값을 입력해 주세요. "),

_T("에러"), MB_ICONWARNING);

return;

}

int nSum = 0;

for(int i=1; i<=m_nInput; i++)

nSum += i;

CString strMsg;

strMsg.Format(_T("1 로부터 %d 까지 의 총화는 %d 입니다. "), m_nInput, nSum);

MessageBox(strMsg);

}

}

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

EndDialog(nID);

}

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

EndDialog(nID);

}

};

// Control.cpp

#include "stdafx.h"

#include "resource.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_EDIT_INPUT
푸쉬 버튼	IDC_BUTTON_SUM

　다음으로 DDX/DDV를 사용하기 위해서 stdafx.h안에서 atlddx.h헤더를 포함 합니다.

　다음으로 CMainDlg클래스의 base class에 CWinDataExchange 클래스를 추가합니다. 그리고 CEdit 클래스의 인스턴스와 int 형태의 변수를 CMainDlg 클래스의 멤버 변수로서 선언합니다. int형태 변수는 CMainDlg 클래스의 constructor　 　 으로 1 에 초기화합니다.

CEdit 클래스의 인스턴스는 DDX 맵의 DDX_CONTROL_HANDLE매크로에 의해 초기화됩니다. DDX_CONTROL_HANDLE 매크로는 제1인수에게 건네졌다 ID의 컨트롤의 윈도우 핸들을 제2인수에게 건네진 오브젝트에 대입합니다.

WTL의DDX는 컨트롤의 초기화용으로 다음과 같은 매크로를 준비해 있습니다.

• DDX_CONTROL(ID, 오브젝트명)

지정된 ID의 컨트롤을 지정된 오브젝트에 서브 클래스화합니다.

• DDX_CONTROL_HANDLE(ID, 오브젝트명)

지정된 ID의 컨트롤의 윈도우 핸들을 지정된 오브젝트에 대입합니다.

덧붙여 이러한 매크로가 실행되는 (즉 컨트롤 클래스의 인스턴스가 초기화된다 ) 것은 컨트롤 클래스의 인스턴스에 NULL가 설정되어 있어 , 한편 DoDataExchange(FALSE)을 호출한 때만입니다. 위의 예에서는 OnInitDialog() 안에서DoDataExchange(FALSE)를 호출해 CEdit 클래스의 인스턴스인m_edit_input에 에디트 컨트롤의 윈도우 핸들을 설정해 있습니다. 그 후CEdit::LimitText()를 호출해 에디트 컨트롤에 3자리수 밖에 입력할 수 없게 하고 있습니다.

　CMainDlg클래스의 DDX맵에서는 또한 DDX_INT매크로를 사용해 컨트롤과int형태 변수를 관련짓고 있습니다. 이렇게 하는 것에 의해 ,DoDataExchange(FALSE)를 호출했을 때는 자동적으로SetDlgItemInt()에 의해 변수의 값이 컨트롤로 설정되어 DoDataExchange(TRUE)를 호출했을 때는 자동적으로GetDlgItemInt()에 의해 컨트롤에 입력된 수치가 변수에 대입됩니다. 값의 취득 또는 설정에 성공했을 때는 ,DoDataExchange()은TRUE을 돌려줍니다. 실패했을 때는FALSE을 돌려줍니다.

WTL의DDX는 컨트롤과 변수가 관련짓고용으로 다음과 같은 매크로를 준비해 있습니다.

• DDX_TEXT(ID, 변수명)

지정된 ID의 컨트롤과 지정된 캐릭터 라인형 변수(LPTSTR,BSTR,CComBSTR,CString) 를 관련짓습니다.

• DDX_INT(ID, 변수명)

지정된 ID의 컨트롤과 지정되었다 int형태 변수를 관련짓습니다.

• DDX_UINT(ID, 변수명)

지정된 ID의 컨트롤과 지정된UINT형태 변수를 관련짓습니다.

• DDX_FLOAT(ID, 변수명)

지정된 ID의 컨트롤과 지정된float형태 변수를 관련짓습니다.

• DDX_FLOAT_P(ID, 변수명, 정밀도)

지정된 ID의 컨트롤과 지정된float형태 변수를 관련짓습니다. 정밀도를 지정할 수 있습니다.

• DDX_CHECK(ID, 변수명)

지정된 ID의 체크 버튼 컨트롤과 지정된int형태 또는bool형태 변수를 관련짓습니다.

• DDX_RADIO(ID, 변수명)

지정된 ID의 라디오 버튼 컨트롤과 지정된int형태 변수를 관련짓습니다.

덧붙여 컨트롤과 변수의 사이에 데이터의 취득 또는 설정이 실패했을 때는 CWinDataExchange 클래스의 멤버 함수인 OnDataExchangeError()이 불려 갑니다. CMainDlg클래스에서는 이OnDataExchangeError()를 오버라이드(override) 해 메시지 박스를 표시하도록(듯이) 하고 있습니다.

　마지막으로 버튼의 핸들러 함수인OnButtonSum()을 추가합니다. OnButtonSum()안에서는 입력된 값을 체크해 유효한 값이면 1 으로부터 그 값까지의 총화를 계산해 메시지 박스로 표시합니다.

DDV

DDV(dialog data validation) (은)는 , 다이얼로그상의 컨트롤에 입력된 데이터의 정당성을 체크하기 위한 구조입니다. 앞의 것DDX의 예에서는 , 에디트 컨트롤에 입력된 수치의 범위 체크를 OnButtonSum()로 다음과 같이 가고 있었습니다. void OnButtonSum(UINT uNotifyCode, int nID, HWND hWndCtl){ if(DoDataExchange(TRUE)){ // 값 체크 if(m_nInput < 1 || 100 < m_nInput){ MessageBox(_T("1 로부터 100 까지 의 값을 입력해 주세요. "), _T("에러"), MB_ICONWARNING); return; } ... ... DDV를 사용하면(자) , 이러한 값의 체크 처리를 간략화할 수 있습니다. 다음에 나타내는 것은DDV을 사용해 값의 체크를 하는 예입니다. 앞의 것DDX의 예의CMainDlg클래스만을 변경합니다. // maindlg.h안 class CMainDlg : public CDialogImpl<CMainDlg>, public CWinDataExchange<CMainDlg> { public: enum { IDD = IDD_MAINDLG }; // constructor　 　 CMainDlg() : m_nInput(1) {} CEdit m_edit_input; int m_nInput; // DDX맵 BEGIN_DDX_MAP(CMainDlg) DDX_CONTROL_HANDLE(IDC_EDIT_INPUT, m_edit_input) DDX_INT_RANGE(IDC_EDIT_INPUT, m_nInput, 1, 100) END_DDX_MAP() // 메세지 맵 BEGIN_MSG_MAP_EX(CMainDlg) MSG_WM_INITDIALOG(OnInitDialog) COMMAND_ID_HANDLER_EX(IDC_BUTTON_SUM, OnButtonSum) 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); // 컨트롤 설정 DoDataExchange(FALSE); m_edit_input.LimitText(3); return TRUE; } void OnDataExchangeError(UINT nCtrlID, BOOL bSave){ CString strMsg; strMsg.Format(_T("컨트롤(ID:%u) 과의 데이터 교환에 실패. "), nCtrlID); MessageBox(strMsg, _T("DDX에러"), MB_ICONWARNING); ::SetFocus(GetDlgItem(nCtrlID)); } void OnDataValidateError(UINT nCtrlID, BOOL bSave, _XData& data){ CString strMsg; strMsg.Format(_T("%d 로부터 %d 까지 의 값을 입력해 주세요. "), data.intData.nMin, data.intData.nMax); MessageBox(strMsg, _T("DDV에러"), MB_ICONEXCLAMATION); ::SetFocus(GetDlgItem(nCtrlID)); } void OnButtonSum(UINT uNotifyCode, int nID, HWND hWndCtl){ if(DoDataExchange(TRUE)){ int nSum = 0; for(int i=1; i<=m_nInput; i++) nSum += i; CString strMsg; strMsg.Format(_T("1 로부터 %d 까지 의 총화는 %d 입니다. "), m_nInput, nSum); MessageBox(strMsg); } } void OnOK(UINT uNotifyCode, int nID, HWND hWndCtl){ EndDialog(nID); } void OnCancel(UINT uNotifyCode, int nID, HWND hWndCtl){ EndDialog(nID); } }; 우선 ,DDX맵의DDX_INT매크로를 ,DDX_INT_RANGE매크로로 변경합니다. 이 매크로의 제1, 2인수는DDX_INT매크로와 같이 , 컨트롤의 것ID과int형태 변수를 지정합니다. 제3인수에는 값의 최소치를 , 제4인수에는 값의 최대치를 지정합니다. 이렇게 하는 것에 의해 ,DoDataExchange()를 호출해 컨트롤에 값을 설정하거나 컨트롤로부터 값을 취득할 때에 , 그 값의 범위 체크를 합니다. 정당한 값 때는 ,DoDataExchange()은TRUE을 돌려줍니다. 부정한 값 때는FALSE을 돌려줍니다. WTL(은)는 다음과 같은DDV기능부DDX매크로를 준비해 있습니다. DDX_TEXT_LEN(ID, 변수명, 문자수) 지정되었다ID의 컨트롤과 지정된 캐릭터 라인형 변수(LPTSTR,BSTR,CComBSTR,CString) 를 관련짓습니다. 문자수 체크를 합니다. DDX_INT_RANGE(ID, 변수명, 최소치, 최대치) 지정되었다ID의 컨트롤과 지정된int형태 변수를 관련짓습니다. 값의 범위 체크를 합니다. DDX_UINT_RANGE(ID, 변수명, 최소치, 최대치) 지정되었다ID의 컨트롤과 지정된UINT형태 변수를 관련짓습니다. 값의 범위 체크를 합니다. DDX_FLOAT_RANGE(ID, 변수명, 최소치, 최대치) 지정되었다ID의 컨트롤과 지정된float형태 변수를 관련짓습니다. 값의 범위 체크를 합니다. DDX_FLOAT_P_RANGE(ID, 변수명, 최소치, 최대치, 정밀도) 지정되었다ID의 컨트롤과 지정된float형태 변수를 관련짓습니다. 정밀도를 지정할 수 있습니다. 값의 범위 체크를 합니다. DDV에 의해 값이 부정이라고 판단되었을 경우는 , CWinDataExchange클래스의 멤버 함수인OnDataValidateError()이 불려 갑니다. CMainDlg클래스에서는 이OnDataValidateError()를 오버라이드(override) 해 , 메시지 박스를 표시하도록(듯이) 하고 있습니다.