荔园在线
荔园之美，在春之萌芽，在夏之绽放，在秋之收获，在冬之沉淀
[回到开始]
[上一篇][下一篇]
发信人: oopilix (PADRAD), 信区: Visual
标 题: [zz]在ATL中实现窗口
发信站: 荔园晨风BBS站 (Tue May 13 20:07:21 2003), 站内信件
lostall
ATL提供了一些工具类以实现窗口，这样在ATL组件里就可以不依赖MFC而很方
便的创建窗口。
一、实现对话框
ATL中有三个模板类可用于创建一个对话框：
(1)CSimpleDialog：创建模式对话框, 可以host Windows Controls
template < WORD t_wDlgTemplateID, BOOL t_bCenter = TRUE >
class CSimpleDialog : public CDialogImplBase
(2)CDialogImpl：创建模式或非模式对话框, 可以host Windows Controls
template < class T, class TBase = CWindow >
class ATL_NO_VTABLE CDialogImpl : public CDialogImplBaseT< TBase >
(3)CAxDialogImpl：创建模式或非模式对话框, 可以host Windows Controls
和ActiveX Controls
template < class T, class TBase = CWindow >
class ATL_NO_VTABLE CAxDialogImpl : public CDialogImplBaseT< TBase >
用CSimpleDialog和CDialogImpl不能显示含有ActiveX控件的对话框，只有
CAxDialogImpl可以。如果想处理对话框中ActiveX控件的事件，在
OnInitDialog()中加入AtlAdviseSinkMap(this, TRUE)。在退出时加入
AtlAdviseSinkMap(this, FALSE)。通过Insert/New ATL
Object/miscellaneous/Dialog生成的对话框缺省就是从CAxDialogImpl继承的。
这三个类的使用方法很类似。都是派生出一个新类，并确保有一个IDD的成员
指明资源ID。如：
class CMyDialog : public CDialogImpl, ...
{
public:
enum { IDD = IDD_MYDIALOG }; //必须要有IDD这个成员，一般都是enum型
BEGIN_MSG_MAP(CMyDialog)
MESSAGE_HANDLER(WM_INITDIALOG, OnInitDialog)
END_MSG_MAP()
LRESULT OnInitDialog(UINT uMsg, WPARAM wParam, LPARAM lParam, BOOL&
bHandled)
{
return 1;
}
};
CMyDialog dlg ;
dlg.DoModal() ;
CSimpleDialog的使用可以更简单一些，如下：
CSimpleDialog< IDD_MYDIALOG > dlg ;
dlg.DoModal() ;
另外CSimpleDialog对IDOK和IDCANCEL有内在的支持，即会自动调用
EndDialog，在其定义中包含如下代码：
BEGIN_MSG_MAP(thisClass)
MESSAGE_HANDLER(WM_INITDIALOG, OnInitDialog)
COMMAND_RANGE_HANDLER(IDOK, IDNO, OnCloseCmd)
END_MSG_MAP()
......
LRESULT OnCloseCmd(WORD /*wNotifyCode*/, WORD wID, HWND /*hWndCtl*/,
BOOL& /*bHandled*/)
{
::EndDialog(m_hWnd, wID);
return 0;
}
但CDialogImpl和CAxDialogImpl没有内在的支持，所以必须自己加消息处理函
数调用EndDialog，比如：
COMMAND_ID_HANDLER(IDOK, OnOK)
COMMAND_ID_HANDLER(IDCANCEL, OnCancel)
LRESULT OnOK(WORD wNotifyCode, WORD wID, HWND hWndCtl, BOOL& bHandled)
{
EndDialog(wID);
return 0;
}
LRESULT OnCancel(WORD wNotifyCode, WORD wID, HWND hWndCtl, BOOL&
bHandled)
{
EndDialog(wID);
return 0;
}
二、subclass和superclass
subclass的作用就是截获消息，指向自己的容器过程函数。有两种subclass。
(1)instance subclass：子类化一个已有的容器对象实例。每个窗口对象实例
都由系统分配了一段内存空间(HWND指的就是这个内存块)，保存有窗口的各种信息
，包括WndProc的地址。所以可以改写这个地址为自己的WndProc地址，从而可以截
获对消息的处理。(当然也要保留原来的WndProc地址，以pass message)
(2)global subclass：子类化一个window class。在WNDCLASS中保留有
WndProc的地址，所以可以改变它为自己的WndProc的地址，这样所有基于这个新的
WNDCLASS创建的对象实例都将指向新的WndProc的地址。如图所示：
instance subclass global subclass
superclass作用与subclass一样，有两点区别：(1)没有instance
superclass，只能superclass窗口类。(2)subclass不能截获WM_CREATE、
WM_NCCREATE等创建消息，而superclass可以截获，但也一定要pass给原来的
WndProc以完成初始化工作。
三、使用CWindowImpl实现一个窗口
CWindowImpl是个模板类，其定义如下：
template < class T, class TBase = CWindow, class TWinTraits =
CControlWinTraits >
class ATL_NO_VTABLE CWindowImpl : public CWindowImplBaseT< TBase,
TWinTraits >
template < class TBase = CWindow, class TWinTraits = CControlWinTraits
>
class ATL_NO_VTABLE CWindowImplBaseT : public CWindowImplRoot< TBase >
template < class TBase = CWindow >
class ATL_NO_VTABLE CWindowImplRoot : public TBase, public CMessageMap
可见，对于CWindowImpl< CMyWindow >来说，最终的基类仍是CWindow(缺省情
况下)。模板参数TWinTraits主要用于指明所要创建窗口的style。ATL已经内建了
一些类型：CControlWinTraits、CFrameWinTraits、CMDIChildWinTraits等，缺省
的是CControlWinTraits，包含的style有 WM_CHILD | WM_VISIBLE |
WS_CLIPCHILDREN | WS_CLIPSIBLINGS。当然也可以自己定义窗口的style和
extended styles。
template < DWORD t_dwStyle = 0, DWORD t_dwExStyle = 0 >
class CWinTraits
{
public:
static DWORD GetWndStyle(DWORD dwStyle)
{
return dwStyle == 0 ? t_dwStyle : dwStyle;
}
static DWORD GetWndExStyle(DWORD dwExStyle)
{
return dwExStyle == 0 ? t_dwExStyle : dwExStyle;
}
};
typedef CWinTraits< WS_CHILD | WS_VISIBLE | WS_CLIPCHILDREN |
WS_CLIPSIBLINGS, 0 >
CControlWinTraits;
typedef CWinTraits< WS_OVERLAPPEDWINDOW | WS_CLIPCHILDREN |
WS_CLIPSIBLINGS, WS_EX_APPWINDOW | WS_EX_WINDOWEDGE >
CFrameWinTraits;
typedef CWinTraits< WS_OVERLAPPEDWINDOW | WS_CHILD | WS_VISIBLE |
WS_CLIPCHILDREN | WS_CLIPSIBLINGS, WS_EX_MDICHILD >
CMDIChildWinTraits;
(1)使用superclass
class CMyWindow : public CWindowImpl< CMyWindow >, ...
{
public:
DECLARE_WND_SUPERCLASS(NULL, "EDIT")
// 消息映射宏
// 消息处理函数
} ;
CMyWindow wnd ;
wnd.Create(...) ;
(2)使用instance subclass
class CMyWindow : public CWindowImpl< CMyWindow >, ...
{
public:
// 消息映射宏
// 消息处理函数
} ;
CMyWindow wnd ;
wnd.SubclassWindow(hSomeWnd) ;// 已有窗口的句柄
(3)创建新的窗口
class CMyWindow : public CWindowImpl< CMyWindow >, ...
{
public:
DECLARE_WND_CLASS("MyWindow") // 仅仅定义一个类名，也可以为NULL，系统
会
自动生成一个类名
// 消息映射宏
// 消息处理函数
} ;
CMyWindow wnd ;
wnd.Create(...) ;
四、消息映射宏
ATL里定义了一组消息映射宏，一个典型的例子如下：
BEGIN_MSG_MAP(CMyClass)
MESSAGE_HANDLER(WM_PAINT, OnPaint)
CHAIN_MSG_MAP(CMyBaseClass) // CMyBaseClass表示基类
ALT_MSG_MAP(1) // ATL_MSG_MAP主要用于"contained window"
CHAIN_MSG_MAP(CMyBaseClass)
ALT_MSG_MAP(2)
MESSAGE_HANDLER(WM_CHAR, OnChar)
CHAIN_MSG_MAP_ALT(CMyBaseClass, 1)
END_MSG_MAP()
宏展开的结果大致如下：
BOOL CMyClass::ProcessWindowMessage(HWND, UINT, WPARAM, LPARAM, LRESULT&
lResult, DWORD dwMsgMapID)
{
BOOL bHandled = TRUE ;// 该变量用于判断消息是否已处理过
...
switch(dwMsgMapID) // 缺省为0
{
case 0:
if (uMsg == WM_PAINT)
{
bHandled = TRUE ;
lResult = OnPaint(uMsg, wParam, lParam, bHandled) ;
// bHandled是引用
型参数
if (bHandled) return TRUE ;
}
if (CMyBaseClass::ProcessWindowMessage(hWnd, uMsg, wParam,
lParam,
lResult))
return TRUE ;
break ;
case 1: // ALT_MSG_MAP(1)，分支作用
if CMyBaseClass::ProcessWindowMessage(hWnd, uMsg, wParam,
lParam,
lResult))
return TRUE ;
break ;
case 2: // ALT_MSG_MAP(1)
if (uMsg == WM_CHAR)
{
bHandled = TRUE ;
lResult = OnChar(uMsg, wParam, lParam, bHandled) ;
if (bHandled) return TRUE ;
}
if CMyBaseClass::ProcessWindowMessage(hWnd, uMsg, wParam,
lParam,
lResult, 1)) // 选择分支1
return TRUE ;
break ;
default:
...
}
return FALSE ;
}
ProcessWindowMessage()是虚函数，论其根源在CMessageMap中定义，
CMessageMap是CWindowImpl的基类之一(另一个是CWindow)。一般在WindowProc中
调用ProcessWindowMessage，若调用失败，即返回FALSE，则调用DefWindowProc，
而DefWindowProc则调用成员变量m_pfnSuperWindowProc所指向的窗口过程，这个
变量用于subclass和superclass时保留原始的窗口过程指针。
CHAIN_MSG_MAP给了一个机会，可以执行theChainClass(一般就是父类)的
ProcessWindowMessage函数，它一般用于ActiveX Control的实现中，如：
CHAIN_MSG_MAP(CComControl< CMyCtl >)。这时该宏是必要的，因为父类可能处理
了某些消息，经如在CComControl的类定义中就有下面几条语句：
MESSAGE_HANDLER(WM_PAINT, CComControlBase::OnPaint)
MESSAGE_HANDLER(WM_SETFOCUS, CComControlBase::OnSetFocus)
MESSAGE_HANDLER(WM_KILLFOCUS, CComControlBase::OnKillFocus)
MESSAGE_HANDLER(WM_MOUSEACTIVATE, CComControlBase::OnMouseActivate)
可见CComControl包含了对WM_PAINT、WM_SETFORCE、WM_KILLFOCUS、
WM_MOUSEACTIVE四个消息的处理。只有在父类也处理不了这个消息的情况下才应该
去调用DefWindowProc。
五、使用Contained Window
contained window被包含在其他对象中，典型用法如下：
class CMyContainer : public CComControl< CMyContainer >, ... // a full
control
{
public:
CContainedWindow m_wndEdit, m_wndList ;
CMyContainer()
: m_wndEdit("Edit", this, 1) // 1表示分支
, m_wndList("List", this, 2) // 2表示分支
{ ... }
BEGIN_MSG_MAP(CMyContainer)
// 处理自己的消息
ALT_MSG_MAP(1) // case 1 :
// 处理edit容器的消息
ALT_MSG_MAP(2) // case 2 :
// 处理list容器的消息
END_MSG_MAP()
LRESULT OnCreate(...)
{
m_wndEdit.Create(...) ;
m_wndList.Create(...) ;
}
......
} ;
比较CWindowImpl和CContainedWindow的消息处理过程：
(1)CWindowImpl：
(2)CContainedWindow：
可见contained window先是由包含它的container处理它的消息，如果处理不
了才转到它自己的DefWindowProc。
六、实现hosting ActiveX control。
ATL也提供了一些类以实现可以hosting ActiveX control的窗口。前面提过的
CAxDialogImpl就是这样的类，另外CAxWindow可适用于更通用的窗口。它的使用方
法也非常简单，下面是一个简单的例子，实现一个窗口，包含一个日历控件。
(1)声明如下形式的类定义：
class CAtlAxWindow
: public CWindowImpl< CAtlAxWindow, CWindow, CFrameWinTraits >
, public IDispEventImpl< 1, CAtlAxWindow, &DIID_DCalendarEvents,
&LIBID_MSACAL, 7, 0 >
{
public:
// 窗口消息
BEGIN_MSG_MAP(CAtlAxWindow)
...
END_MSG_MAP()
// 事件处理
BEGIN_SINK_MAP(CAtlAxWindow)
SINK_ENTRY_EX(1, DIID_DCalendarEvents, 0x1,
OnAfterUpdateCalendar)
...
END_SINK_MAP()
STDMETHOD(OnAfterUpdateCalendar)() ;
private:
CAxWindow m_axwnd ;// host activex control
};
从CWindowImpl继承，是为了创建一个包含ActiveX控件的父窗口，这里用了
CFrameWinTraits，表明创建Frame样式的窗口。从IDispEventImpl继承，是为了能
接受被包含控件的事件。
(2)创建hosting窗口有两种方法，分别如下：
// 方法一
RECT rect = { 0, 0, 400, 300 };
m_axwnd.Create(m_hWnd, rect, _T("MSCAL.Calendar.7"),
WS_OVERLAPPEDWINDOW | WS_VISIBLE | WS_CLIPSIBLINGS |
WS_CLIPCHILDREN,
0);
m_axwnd.CenterWindow() ;
m_axwnd.SetWindowText(_T("ActiveX Host Window")) ;
SubclassWindow(m_axwnd.m_hWnd) ;
// 方法二，也可以不使用m_axwnd，在Create中设置WindowName为"AtlAxWin"直
接创建
RECT rect = { 0, 0, 400, 300 };
Create(NULL, rect, NULL, WS_OVERLAPPEDWINDOW | WS_VISIBLE |
WS_CLIPSIBLINGS | WS_CLIPCHILDREN);
CenterWindow() ;
SetWindowText(_T("ActiveX Host Window")) ;
m_axwnd.Attach(m_hWnd) ;
m_axwnd.CreateControl(OLESTR("MSCAL.Calendar.7")) ;
这几句话非常简单，具体函数的含义可查查MSDN。
(3)创建完hosting窗口后，要建立事件连接，如下代码：
// 建立事件连接
CComPtr< IUnknown > spIUnknown ;
m_axwnd.QueryControl(IID_IUnknown, (void**)&spIUnknown) ;
DispEventAdvise(spIUnknown, &DIID_DCalendarEvents) ;
--
※ 来源:·荔园晨风BBS站 bbs.szu.edu.cn·[FROM: 61.144.235.41]
[回到开始]
[上一篇][下一篇]
荔园在线首页 友情链接：深圳大学 深大招生 荔园晨风BBS S-Term软件 网络书店