第二十一篇：SOUI中的控件注册机制

Win32编程中，用户需要一个新控件时，需要向系统注册一个新的控件类型。注册以后，调用::CreateWindow时才能根据标识控件类型的字符串创建出一个新的控件窗口对象。

为了能够从XML描述的字符串中创建出需要的控件对象，和Win32类似，在SOUI中要创建一个新的控件也同样需要向SOUI系统注册新的控件类。

从demo.cpp的main中我们可以看到类似如下的控件注册控件的代码：

        //向SApplication系统中注册由外部扩展的控件及SkinObj类
        SWkeLoader wkeLoader;
        if(wkeLoader.Init(_T("wke.dll")))
        {
            theApp->RegisterWndFactory(TplSWindowFactory<SWkeWebkit>());//注册WKE浏览器
        }
        theApp->RegisterWndFactory(TplSWindowFactory<SGifPlayer>());//注册GIFPlayer
        theApp->RegisterSkinFactory(TplSkinFactory<SSkinGif>());//注册SkinGif
        theApp->RegisterSkinFactory(TplSkinFactory<SSkinAPNG>());//注册SSkinAPNG
        theApp->RegisterSkinFactory(TplSkinFactory<SSkinVScrollbar>());//注册纵向滚动条皮肤

        theApp->RegisterWndFactory(TplSWindowFactory<SIPAddressCtrl>());//注册IP控件
        theApp->RegisterWndFactory(TplSWindowFactory<SPropertyGrid>());//注册属性表控件
        theApp->RegisterWndFactory(TplSWindowFactory<SChromeTabCtrl>());//注册ChromeTabCtrl
        theApp->RegisterWndFactory(TplSWindowFactory<SIECtrl>());//注册IECtrl
        theApp->RegisterWndFactory(TplSWindowFactory<SChatEdit>());//注册ChatEdit
        theApp->RegisterWndFactory(TplSWindowFactory<SScrollText>());//注册SScrollText

        if(SUCCEEDED(CUiAnimation::Init()))
        {
            theApp->RegisterWndFactory(TplSWindowFactory<SUiAnimationWnd>());//注册动画控件
        }
        theApp->RegisterWndFactory(TplSWindowFactory<SFlyWnd>());//注册飞行动画控件
        theApp->RegisterWndFactory(TplSWindowFactory<SFadeFrame>());//注册渐显隐动画控件
        theApp->RegisterWndFactory(TplSWindowFactory<SRadioBox2>());//注册渐显隐动画控件

上面代码中即有新皮肤对象的注册也有窗口控件的注册，这种注册控件方式看起来有点怪异，但使用起来也还算是简单，只需要一行代码（实际上是从著名的游戏GUI CEGUI借鉴过来的）。

以注册窗口控件为例，下面我来解释一下为什么会有这样一种控件注册方式。

先看看TplSWindowFactory模板类的实现：

    class SWindowFactory
    {
    public:
        virtual ~SWindowFactory() {}
        virtual SWindow* NewWindow() = 0;
        virtual LPCWSTR SWindowBaseName()=0;

        virtual const SStringW & getWindowType()=0;

        virtual SWindowFactory* Clone() const =0;
    };

    template <typename T>
    class TplSWindowFactory : public SWindowFactory
    {
    public:
        //! Default constructor.
        TplSWindowFactory():m_strTypeName(T::GetClassName())
        {
        }

        LPCWSTR SWindowBaseName(){return T::BaseClassName();}

        // Implement WindowFactory interface
        virtual SWindow* NewWindow()
        {
            return new T;
        }

        virtual const SStringW & getWindowType()
        {
            return m_strTypeName;
        }

        virtual SWindowFactory* Clone() const
        {
            return new TplSWindowFactory();
        }
    protected:
        SStringW m_strTypeName;
    };

TplSWindowFactory从SWindowFactory派生，自动为模板参数中指定的类型生成一个SWindowFactory对象。

SWindowFactory有什么用呢？SWindowFactory最核心的用途就在于它的方法：SWindow * SWindowFactory::NewWindow();该方法说来很简单，不过是根据不同的字符串从堆上分配一个SWindow对象，但是在C++中我们需要满足一条基本原则：内存在哪个模块中分配（从哪个模块的堆上分配）就必须被哪个模块释放。在SOUI中，通常情况下控件都是由SOUI.DLL这个模块来分配内存的，也就是说SWindow * SWindowFactory::NewWindow()只会在SOUI模块中调用。

那么生成的对象在哪里释放呢？这就需要看一下SWindow或者SSkinObjBase这两个类的实现了。

    class SOUI_EXP SWindow : public SObject
        , public SMsgHandleState
        , public TObjRefImpl2<IObjRef,SWindow>
    {
        SOUI_CLASS_NAME(SWindow, L"window")
        //....
    };

    class SOUI_EXP SSkinObjBase : public TObjRefImpl<ISkinObj>
    {
       //......
    };

SWindow和SSkinObjBase实际上都派生自TObjRefImpl这个模板类。下面看一下这个类的实现:

template<class T>
class TObjRefImpl :  public T
{
public:
    TObjRefImpl():m_cRef(1)
    {
    }

    virtual ~TObjRefImpl(){
    }

    //!添加引用
    /*!
    */
    virtual void AddRef()
    {
        InterlockedIncrement(&m_cRef);
    }

    //!释放引用
    /*!
    */
    virtual void Release()
    {
        InterlockedDecrement(&m_cRef);
        if(m_cRef==0)
        {
            OnFinalRelease();
        }
    }

    //!释放对象
    /*!
    */
    virtual void OnFinalRelease()
    {
        delete this;
    }
protected:
    volatile LONG m_cRef;
};

template<class T,class T2>
class TObjRefImpl2 :  public TObjRefImpl<T>
{
public:
    virtual void OnFinalRelease()
    {
        delete static_cast<T2*>(this);
    }
};

TObjRefImpl一个重要的虚函数是void OnFinalRelease(){delete this;}

由于SWindow及SSkinObjBase是在SOUI模块中实现的，因此派生自这两个类的新的控件类及皮肤类最后都将在SOUI模块中被释放，从而保证了对象内存的分配、释放在一个模块。这也就是说不管是SOUI模块内实现的控件还是在应用层扩展的控件一般情况下都应该向SOUI系统注册并经由SOUI内核来实现对象的分配与释放。

那么问题来了，是不是所有新控件都必须向系统注册呢？当然不是的，注意OnFinalRelease是一个虚函数，只需要在新的控件类中增加一个

void OnFinalRelease(){delete this;}就可以把控件内存的释放转移到应用层的模块了。如此你就可以在自己的模块中直接使用new来创建新控件了。(可以参考属性表控件中部分子控件的实现）