第十三篇：在SOUI中使用有窗口句柄的子窗口
无论一个DirectUI系统提供的DUI控件多么丰富，总会有些情况下用户需要在DUI窗口上放置有窗口句柄的子窗口。
为了和无窗口句柄的子窗口相区别，这里将有窗口句柄的子窗口称之为真窗口。
每一个使用SOUI创建的界面都是从SHostWnd派生出来的。SHostWnd本身就是一个有窗口句柄的真窗口。
因此和一般的win32编程一样，用户可以简单的自己以SHostWnd.m_hWnd为父窗口创建各种真子窗口。然后和win32一样，响应resize等消息自己管理子窗口的位置及显示。
很显然，这样处理将不能有效的利用SOUI提供的强大的布局及子窗口管理功能。
为了能够更有效的管理真窗口，在SOUI系统中提供了一个控件：SRealWnd。
SRealWnd派生自SWindow，因此它能够实现和SWindow一样的布局功能，并被SOUI系统管理窗口的各种状态：如size,visible等。
要使用SReaWnd来管理子窗口，我们首先需要实现一个接口：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;
}
}整体上代码很简单，配上注释，应该一看就懂。
<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控件的窗口。