前言:
无论一个DirectUI系统提供的DUI控件多么丰富,总会有些情况下用户需要在DUI窗口上放置有窗口句柄的子窗口。
为了和无窗口句柄的子窗口相区别,这里将有窗口句柄的子窗口称之为真窗口。
每一个使用SOUI创建的界面都是从SHostWnd派生出来的。SHostWnd本身就是一个有窗口句柄的真窗口。
因此和一般的win32编程一样,用户可以简单的自己以SHostWnd.m_hWnd为父窗口创建各种真子窗口。然后和win32一样,响应resize等消息自己管理子窗口的位置及显示。
很显然,这样处理将不能有效的利用SOUI提供的强大的布局及子窗口管理功能。
为了能够更有效的管理真窗口,在SOUI系统中提供了一个控件:SRealWnd。
SRealWnd派生自SWindow,因此它能够实现和SWindow一样的布局功能,并被SOUI系统管理窗口的各种状态:如size,visible等。
要使用SReaWnd来管理子窗口,我们首先需要实现一个接口:IRealWndHandler
IRealWndHandler的定义:
/** * @struct IRealWndHandler * @brief * * Describe */ struct IRealWndHandler : public IObjRef { /** * SRealWnd::OnRealWndCreate * @brief 窗口创建 * @param SRealWnd *pRealWnd -- 窗口指针 * * Describe 窗口创建 */ virtual HWND OnRealWndCreate(SRealWnd *pRealWnd)=NULL; /** * SRealWnd::OnRealWndDestroy * @brief 销毁窗口 * @param SRealWnd *pRealWnd -- 窗口指针 * * Describe 销毁窗口 */ virtual void OnRealWndDestroy(SRealWnd *pRealWnd)=NULL; /** * SRealWnd::OnRealWndInit * @brief 初始化窗口 * @param SRealWnd *pRealWnd -- 窗口指针 * @return BOOL -- FALSE:交由系统处理,TRUE:用户处理 * * Describe 初始化窗口 */ virtual BOOL OnRealWndInit(SRealWnd *pRealWnd)=NULL; /** * SRealWnd::OnRealWndSize * @brief 调整窗口大小 * @param SRealWnd *pRealWnd -- 窗口指针 * @return BOOL -- FALSE:交由SOUI处理; TRUE:用户管理窗口的移动 * * Describe 调整窗口大小 */ virtual BOOL OnRealWndSize(SRealWnd *pRealWnd)=NULL; };
可以看到这里一共有4个接口,其中OnRealWndInit是OnRealWndSize为真窗口初始化及位置调整的回调,一般可以不处理,其它2个接口则是管理真窗口的创建及销毁,因此必须有实现。
接口实现示例:
真窗口的具体使用方法可以参考SOUI代码中samples目录下的mfc.demo。
这里把代码实现帖出来:
SouiRealWndHandler.h
#pragma once #include <unknown/obj-ref-impl.hpp> namespace SOUI { class CSouiRealWndHandler :public TObjRefImpl2<IRealWndHandler,CSouiRealWndHandler> { public: CSouiRealWndHandler(void); ~CSouiRealWndHandler(void); /** * SRealWnd::OnRealWndCreate * @brief 创建真窗口 * @param SRealWnd * pRealWnd -- 窗口指针 * @return HWND -- 创建出来的真窗口句柄 * Describe */ virtual HWND OnRealWndCreate(SRealWnd *pRealWnd); /** * SRealWnd::OnRealWndDestroy * @brief 销毁窗口 * @param SRealWnd *pRealWnd -- 窗口指针 * * Describe 销毁窗口 */ virtual void OnRealWndDestroy(SRealWnd *pRealWnd); /** * SRealWnd::OnRealWndInit * @brief 初始化窗口 * @param SRealWnd *pRealWnd -- 窗口指针 * * Describe 初始化窗口 */ virtual BOOL OnRealWndInit(SRealWnd *pRealWnd); /** * SRealWnd::OnRealWndSize * @brief 调整窗口大小 * @param SRealWnd *pRealWnd -- 窗口指针 * @return BOOL -- TRUE:用户管理窗口的移动;FALSE:交由SOUI自己管理。 * Describe 调整窗口大小, 从pRealWnd中获得窗口位置。 */ virtual BOOL OnRealWndSize(SRealWnd *pRealWnd); }; }
SouiRealWndHandler.cpp:
#include "StdAfx.h" #include "SouiRealWndHandler.h" namespace SOUI { CSouiRealWndHandler::CSouiRealWndHandler(void) { } CSouiRealWndHandler::~CSouiRealWndHandler(void) { } HWND CSouiRealWndHandler::OnRealWndCreate( SRealWnd *pRealWnd ) { const SRealWndParam ¶m=pRealWnd->GetRealWndParam(); if(param.m_strClassName==_T("button")) {//只实现了button的创建 //分配一个MFC CButton对象 CButton *pbtn=new CButton; //创建CButton窗口,注意使用pRealWnd->GetContainer()->GetHostHwnd()作为CButton的父窗口 //把pRealWnd->GetID()作为真窗口的ID pbtn->Create(param.m_strWindowName,WS_CHILD|WS_VISIBLE|BS_PUSHBUTTON,::CRect(0,0,0,0),CWnd::FromHandle(pRealWnd->GetContainer()->GetHostHwnd()),pRealWnd->GetID()); //把pbtn的指针放到SRealWnd的Data中保存,以便在窗口destroy时释放pbtn对象。 pRealWnd->SetData(pbtn); //返回成功创建后的窗口句柄 return pbtn->m_hWnd; }else { return 0; } } void CSouiRealWndHandler::OnRealWndDestroy( SRealWnd *pRealWnd ) { const SRealWndParam ¶m=pRealWnd->GetRealWndParam(); if(param.m_strClassName==_T("button")) {//销毁真窗口,释放窗口占用的内存 CButton *pbtn=(CButton*) pRealWnd->GetData(); if(pbtn) { pbtn->DestroyWindow(); delete pbtn; } } } //不处理,返回FALSE BOOL CSouiRealWndHandler::OnRealWndSize( SRealWnd *pRealWnd ) { return FALSE; } //不处理,返回FALSE BOOL CSouiRealWndHandler::OnRealWndInit( SRealWnd *pRealWnd ) { return FALSE; } }
整体上代码很简单,配上注释,应该一看就懂。
XML配置:
<SOUI title="DUI-DEMO" width="600" height="400" appwin="0" ncRect="5,5,5,5" resize="1" translucent="0"> <root skin="skin.bkframe" cache="1"> <caption pos="0,0,-0,29"> <text pos="11,9" >%title% ver:%ver%</text> <imgbtn id="1" name="btn_close" skin="skin.btnclose" pos="-45,0" tip="close" animate="0"/> </caption> <window pos="0,29,-0,-0"> <realwnd pos="10,10,-10,-10" name="mfcbtn" wndclass="button" id="100" wndname="MFC Button"/> </window> </root> </SOUI>
在XML中,我们使用了一个realwnd的标签,该标签有一个重要的属性:wndclass,IRealWndHandler通过该属性来判断应该创建一个什么样的真窗口。
运行效果:
上面红框中的按钮即为使用realwnd标签创建的MFC Button。
真窗口的消息响应:
由于真窗口是SOUI主窗口的子窗口,因此真窗口的消息可以在SOUI主窗口的消息映射表中处理(注意:这里不是SOUI控件的事件映射表)。
如:
#pragma once class CRealWndDlg : public SOUI::SHostDialog { public: CRealWndDlg(void); ~CRealWndDlg(void); //响应MFC.button的按下消息, nID==100为在XML中指定的realwnd的id属性。 void OnBtnClick( UINT uNotifyCode, int nID, HWND wndCtl ) { if(uNotifyCode == BN_CLICKED && nID == 100) { SOUI::SMessageBox(m_hWnd,_T("the real mfc button is clicked!"),_T("mfc.demo"),MB_OK|MB_ICONEXCLAMATION); } } //消息映射表 BEGIN_MSG_MAP_EX(CMainDlg) MSG_WM_COMMAND(OnBtnClick) CHAIN_MSG_MAP(SOUI::SHostDialog) REFLECT_NOTIFICATIONS_EX() END_MSG_MAP() };
结束语:
很显然,通过这种方式,也可以非常方便的创建出各种类型的其它窗口。
窗口创建出来后,系统就会自动管理窗口状态。
最后,要记住一条:有真窗口时,SOUI主窗口不能设置translucent="1"这一属性。因为任何子窗口在半透明窗口上都不能正常显示。这一条也适用于包含IE控件的窗口。