많은 개발자들이 C++Builder 4를 이용하여 ActiveX 컨트롤을 만들 때 직면하는 문제가 속성에 대해 어떻게 지속성(Persistent)를 유지시켜주느냐 하는 문제이다. 이 문제로 인해 많은 개발자들로부터 질문을 받았고, 그래서 이 글에서 이에 대한 해결책을 직접 예제를 작성해 해결해 보기로 하겠다.
ActiveX 컨트롤에서는 IPersistPropertyBag 인터페이스를 사용하면 이 문제는 간단히 해결될 수 있다. 이 인터페이스를 사용할 경우, HTML의 PARAM 태그를 사용하여 넘어온 값을 ActiveX 컨트롤의 속성에 설정할 수 있게 된다. ActiveX 컨트롤에 IPersistPropertyBag 인터페이스를 추가하는 것은 ActiveX 컨트롤 에 대한 속성을 확장시키는 개념이기도 하다.
솔직히 C++Builder에서 ActiveX 컨트롤을 만들어 IPersistePropertyBag 인터페이스를 추가하는 과정은 몇가지 단계적인 스텝만 따라한다면 아주 쉽게 구현할 수 있다. 필요한 인터페이스는 오브젝트 클래스 정의 부분에 추가하고, 이 인터페이스에 대해서는 세 개의 메소드를 구현해 주어야 한다. 다음의 예제는 단계적으로 간단한 ActiveXForm(폼도 하나의 컨트롤이다.)을 기반으로 한 ActiveX 컨트롤을 사용하여 어떻게 처리하는 지 보여주겠다. 단순하게 쉽게 이해하기 위해 이 예제에서 스텝 바이 스텝 형태로 설명하기로 한다.
1) File|New를 선택하고 ActiveX 탭을 선택한다. 그런다음, ActiveForm을 선택한다.
NewActiveX Name : BCB4ActiveFormX
Implementation Name :BCB4ActiveFormImpl1.cpp
Project Name : BCB4ActiveFormProj1
2) 그리고, 나머지 설정사항은 그대로 둔다. 그리고, OK 버튼을 클릭해 보자. 그러면, 자동적으로 C++Builder는 ActiveX 컨트롤을 생성하기 위한 래핑 클래스를 자기 스스로 알아서 만들어 준다.
3) 먼저, BCB4ActiveFormImpl1.h 파일에서 보면 다음의 액티브 폼 선언부가 보인다. 여기에서 진한 부분을 추가한다.
class ATL_NO_VTABLE TBCB4ActiveFormXImpl:
VCLCONTROL_IMPL(TBCB4ActiveFormXImpl, BCB4ActiveFormX, TBCB4ActiveFormX, IBCB4ActiveFormX,
DIID_IBCB4ActiveFormXEvents),
public IPersistPropertyBagImpl<TBCB4ActiveFormXImpl>
{
ATL은 IPersistPropertyBagImpl<> 템플릿을 통해 속성 백(Bag)을 지원한다. 사용자 클래스를 IPersistPropertyBagImpl<>템플릿으로부터 파생해야하며, 속성 백을 통해 속성 맵으로 초기활될 속성들을 추가해야 한다. 그래서 이 인터페이스를 템플릿에 추가한 것이다.
4) TestProp1, 2 변수를 이 클래스안에서 만든다. 이렇게 만드는 이유는 만들 속성(첫번째,두번째)들에 대해 값을 할당해주고 값을 저장하기 위한 변수이다.
void InitializeControl()
{
m_VclCtl->OnActivate = ActivateEvent;
m_VclCtl->OnClick = ClickEvent;
m_VclCtl->OnCreate = CreateEvent;
m_VclCtl->OnDblClick = DblClickEvent;
m_VclCtl->OnDeactivate = DeactivateEvent;
m_VclCtl->OnDestroy = DestroyEvent;
m_VclCtl->OnKeyPress = KeyPressEvent;
m_VclCtl->OnPaint = PaintEvent;
}
AnsiString TestProp1;
AnsiString TestProp2;
5) COM_MAP 선언부에서 다음과 같이 추가해야 콤 인터페이스의 엔트리 부분에 IPersistPropertyBag 가 추가된다.
BEGIN_COM_MAP(TBCB4ActiveFormXImpl)
VCL_CONTROL_COM_INTERFACE_ENTRIES(IBCB4ActiveFormX)
COM_INTERFACE_ENTRY_IMPL(IPersistPropertyBag)
END_COM_MAP()
6) 그리고 나서 HTML의 PARAM/VALUE 태그를 통해 접근하고자 하는 각 속성에 해당되는 것들을 COM 맵 안에다 PROP_PAGE() 매크로를 사용해 정의한다.
BEGIN_PROPERTY_MAP(TBCB4ActiveFormXImpl)
// PROP_PAGE(CLSID_BCB4ActiveFormXPage)
PROP_ENTRY("TestProp1", 15, CLSID_BCB4ActiveFormX)
PROP_ENTRY("TestProp2", 16, CLSID_BCB4ActiveFormX)
END_PROPERTY_MAP()
PROP_PAGE(,,) 을 일명 속성 가방이라고도 하며, 이 안의 파라미터 인자는 첫번째는 속성 디스크립션, 두번째는 dispid, 세번째는 clsid를 적어주어야 한다.
7) 이제 실제로 구현될 속성을 만들어 주어야 하는데 이것은 어떻게 만들까? 바로 타입 라이브러리 에디터를 사용하면 된다. View | Type Library 를 선택한다. IBCB4ActiveFormX 를 마우스로 클릭하고 오른쪽 버튼을 클릭하고 New|Property 를 클릭해 새 속성을 만든다. ( 두 개의 속성을 만든다.)
TestProp1, TestProp2
파라미터는 BSTR 로 전달하게끔 만든다.

8) BCB4ActiveFormX 내에 선언된 속성은 사용자가 정의할 경우, 강제로 접근할 수는 없다. 그러나, 방법은 있다. 전역변수로 이것을 처리해 줄 수 있는 또 다른 변수를 정의하면 된다. 다음과 같이
TBCB4ActiveFormX *BCB4ActiveFormX;
AnsiString V_TestProp1;
AnsiString V_TestProp2;
그리고 구현부에서 값을 읽어오고 저장하는 논리적 처리를 해주면 된다.
......중간 생략.......
STDMETHODIMP TBCB4ActiveFormXImpl::get_TestProp1(BSTR* Value)
{
try
{
*Value = WideString(TestProp1).Copy();
}
catch(Exception &e)
{
return Error(e.Message.c_str(), IID_IBCB4ActiveFormX);
}
return S_OK;
};
STDMETHODIMP TBCB4ActiveFormXImpl::set_TestProp1(BSTR Value)
{
try
{
const DISPID dispid = 15;
if (FireOnRequestEdit(dispid) == S_FALSE)
return S_FALSE;
TestProp1 = Value;
V_TestProp1 = TestProp1;
FireOnChanged(dispid);
}
catch(Exception &e)
{
return Error(e.Message.c_str(), IID_IBCB4ActiveFormX);
}
return S_OK;
};
STDMETHODIMP TBCB4ActiveFormXImpl::get_TestProp2(BSTR* Value)
{
try
{
*Value = WideString(TestProp2).Copy();
}
catch(Exception &e)
{
return Error(e.Message.c_str(), IID_IBCB4ActiveFormX);
}
return S_OK;
};
STDMETHODIMP TBCB4ActiveFormXImpl::set_TestProp2(BSTR Value)
{
try
{
const DISPID dispid = 15;
if (FireOnRequestEdit(dispid) == S_FALSE)
return S_FALSE;
TestProp2 = Value;
V_TestProp2 = TestProp2;
FireOnChanged(dispid);
}
catch(Exception &e)
{
return Error(e.Message.c_str(), IID_IBCB4ActiveFormX);
}
return S_OK;
};
9) 빈 액티브 폼 위에 버튼 2개, 에디트 박스 2개을 올려 놓는다. 그리고 각 버튼의 OnClick 이벤트에 대해 다음과 같이 작성해 보자.
void __fastcall TBCB4ActiveFormX::Button1Click(TObject *Sender)
{
Edit1->Text = V_TestProp1;
}
void __fastcall TBCB4ActiveFormX::Button2Click(TObject *Sender)
{
Edit2->Text = V_TestProp2;
}
10) 이제 이것을 웹으로 배포하기 위해서는 우선 컴파일(CTRL
+F9)하고, Project | Web Deploy Option에서 다음과 같이
정해준다.

11) Project | Web Deploy 한다.
12) 이렇게 배포하게 되면 wwwroot 디렉토리에 BCB4ActiveFormProj1.htm과 BCB4ActiveFormProj1.ocx 파일이 생성된다. 이 두 파일은 웹에서 볼 수 있는 파일들이다. BCB4ActiveFormProj1.htm 파일을 다음과 같이 수정한다.
<HTML>
<H1> C++Builder 4 ActiveX Test Page </H1><p>
You should see your C++Builder 4 forms or controls embedded in the form below.
<HR><center><P>
<OBJECT
classid="clsid:F9FB218F-D347-11D3-B86E-0060977192D0"
codebase="http://127.0.0.1/BCB4ActiveFormProj1.ocx#version=1,0,0,0"
width=690
height=455
align=center
hspace=0
vspace=0
>
<PARAM NAME="TestProp1" Value = "YD016">
<PARAM NAME="TestProp2" Value = "01010001">
</OBJECT>
</HTML>
이제 모든 과정은 끝났다.
브라우저 (IE5)를 통해 원하는 결과를 얻을 수 있을 것이다.

샘플 예제 다운로드