绘图对象(ISkinObj)的扩展

系统内置了如SSkinImgList, SSkinImgFrame, SSkinScrollbar等绘图对象，在窗口中通过引用这些绘图对象可以绘制出不同的预定义图形图象（如按钮，滚动条，九宫格等）。

实际上用户可以实现任意的绘图对象并把它们注册到系统里，以便在XML及代码中使用。

下面先看一下实现一个ISkinObj需要实现哪些接口：

    /**    * @struct     ISkinObj    * @brief      Skin 对象    *     * Describe    */    class SOUI_EXP ISkinObj : public SObject,public TObjRefImpl2<IObjRef,ISkinObj>    {    public:        ISkinObj()        {        }        virtual ~ISkinObj()        {        }        /**         * Draw         * @brief    将this绘制到RenderTarget上去         * @param    IRenderTarget * pRT --  绘制用的RenderTarget         * @param    LPCRECT rcDraw --  绘制位置         * @param    DWORD dwState --  绘制状态         * @param    BYTE byAlpha --  透明度         * @return   void         * Describe           */            virtual void Draw(IRenderTarget *pRT, LPCRECT rcDraw, DWORD dwState,BYTE byAlpha=0xFF)=0;        /**         * GetSkinSize         * @brief    获得Skin的默认大小         * @return   SIZE -- Skin的默认大小         * Describe  派生类应该根据skin的特点实现该接口         */            virtual SIZE GetSkinSize()        {            SIZE ret = {0, 0};            return ret;        }        /**         * IgnoreState         * @brief    查询skin是否有状态信息         * @return   BOOL -- true有状态信息         * Describe           */            virtual BOOL IgnoreState()        {            return TRUE;        }        /**         * GetStates         * @brief    获得skin对象包含的状态数量         * @return   int -- 状态数量         * Describe  默认为1         */            virtual int GetStates()        {            return 1;        }    };

ISkinObj是一个派生自SObject及TObjRefImpl2<IObjRef,ISkinObj>的类，提供了几个状态查询相关的接口，也提供了一个Draw接口来在IRenderTarget上绘制该绘制对象。

注意的是，这些接口中只有Draw接口是纯虚接口。

在它的基类中，SOjbect使得ISkinObj可以方便的从XML配置文件中初始化，而TObjRefImpl2<IObjRef,ISkinObj>则提供引用计数的实现。

内置的ISkinObj不支持显示GIF图片，以显示GIF图象为例来分析如何扩展绘图对象来支持GIF图片显示。

对象定义（trunk\controls.extend\gif\SSkinGif.h）

namespace SOUI{    class SGifFrame    {    public:        CAutoRefPtr<IBitmap> pBmp;        int                  nDelay;    };    /**    * @class     SSkinGif    * @brief     GIF图片加载及显示对象    *     * Describe    */    class SSkinGif : public ISkinObj    {        SOUI_CLASS_NAME(SSkinGif, L"gif")    public:        SSkinGif():m_nFrames(0),m_iFrame(0),m_pFrames(NULL)        {        }                //初始化GDI+环境，由于这里需要使用GDI+来解码GIF文件格式        static BOOL Gdiplus_Startup();        //退出GDI+环境        static void Gdiplus_Shutdown();        virtual ~SSkinGif()        {            if(m_pFrames) delete [] m_pFrames;        }        /**         * Draw         * @brief    绘制指定帧的GIF图         * @param    IRenderTarget * pRT --  绘制目标         * @param    LPCRECT rcDraw --  绘制范围         * @param    DWORD dwState --  绘制状态，这里被解释为帧号         * @param    BYTE byAlpha --  透明度         * @return   void         * Describe           */            virtual void Draw(IRenderTarget *pRT, LPCRECT rcDraw, DWORD dwState,BYTE byAlpha=0xFF);        /**         * GetStates         * @brief    获得GIF帧数         * @return   int -- 帧数         * Describe           */            virtual int GetStates(){return m_nFrames;}        /**         * GetSkinSize         * @brief    获得图片大小         * @return   SIZE -- 图片大小         * Describe           */            virtual SIZE GetSkinSize()        {            SIZE sz={0};            if(m_nFrames>0 && m_pFrames)            {                sz=m_pFrames[0].pBmp->Size();            }            return sz;        }        /**         * GetFrameDelay         * @brief    获得指定帧的显示时间         * @param    int iFrame --  帧号,为-1时代表获得当前帧的延时         * @return   long -- 延时时间(*10ms)         * Describe           */            long GetFrameDelay(int iFrame=-1);        /**         * ActiveNextFrame         * @brief    激活下一帧         * @return   void          * Describe           */            void ActiveNextFrame();        /**         * SelectActiveFrame         * @brief    激活指定帧         * @param    int iFrame --  帧号         * @return   void         * Describe           */            void SelectActiveFrame(int iFrame);                /**         * LoadFromFile         * @brief    从文件加载GIF         * @param    LPCTSTR pszFileName --  文件名         * @return   int -- GIF帧数，0-失败         * Describe           */            int LoadFromFile(LPCTSTR pszFileName);        /**         * LoadFromMemory         * @brief    从内存加载GIF         * @param    LPVOID pBits --  内存地址         * @param    size_t szData --  内存数据长度         * @return   int -- GIF帧数，0-失败         * Describe           */            int LoadFromMemory(LPVOID pBits,size_t szData);        SOUI_ATTRS_BEGIN()            ATTR_CUSTOM(L"src",OnAttrSrc)   //XML文件中指定的图片资源名,(type:name)        SOUI_ATTRS_END()    protected:        LRESULT OnAttrSrc(const SStringW &strValue,BOOL bLoading);        int LoadFromGdipImage(Gdiplus::Bitmap * pImg);        int m_nFrames;        int m_iFrame;        SGifFrame * m_pFrames;    };}//end of name space SOUI

对象注册：

        theApp->RegisterSkinFactory(TplSkinFactory<SSkinGif>());//注册SkinGif

对象的使用（trunk\demo\uires\xml\dlg_main.xml）：

  <skin>    <!--局部skin对象-->    <gif name="gif_horse" src="gif:gif_horse"/>    <gif name="gif_penguin" src="gif:gif_penguin"/>  </skin>

这里的gif标签与SSkinGif类中的宏SOUI_CLASS_NAME(SSkinGif,L"gif")中的“gif”是匹配的。

到此，在布局XML及程序中都可以获得这个SSkinGif对象的指针了。

控件的扩展

控件的扩展和绘图对象的扩展套路类似，也是先从系统提供的基础类派生，再注册到系统，最后再XML或者代码中使用。

和绘图对象不同在于，控件是UI，需要处理各种UI相关的消息以及向程序发出各种控件特有的事件。

同样我们还是以GIF显示的控件为例（trunk\controls.extend\gif\SGifPlayer.h）：

namespace SOUI{    /**    * @class     SGifPlayer    * @brief     GIF图片显示控件    *     * Describe    */    class SGifPlayer : public SWindow    {        SOUI_CLASS_NAME(SGifPlayer, L"gifplayer")   //定义GIF控件在XM加的标签    public:        SGifPlayer();        ~SGifPlayer();        /**         * PlayGifFile         * @brief    在控件中播放一个GIF图片文件         * @param    LPCTSTR pszFileName --  文件名         * @return   BOOL -- true:成功         * Describe           */            BOOL PlayGifFile(LPCTSTR pszFileName);    protected://SWindow的虚函数        virtual CSize GetDesiredSize(LPRECT pRcContainer);    public://属性处理        SOUI_ATTRS_BEGIN()                    ATTR_CUSTOM(L"skin", OnAttrGif) //为控件提供一个skin属性，用来接收SSkinObj对象的name        SOUI_ATTRS_END()    protected:        HRESULT OnAttrGif(const SStringW & strValue, BOOL bLoading);    protected://消息处理，SOUI控件的消息处理和WTL，MFC很相似，采用相似的映射表，相同或者相似的消息映射宏                /**         * OnPaint         * @brief    窗口绘制消息响应函数         * @param    IRenderTarget * pRT --  绘制目标         * @return   void         * Describe  注意这里的参数是IRenderTarget *,而不是WTL中使用的HDC，同时消息映射宏也变为MSG_WM_PAINT_EX         */            void OnPaint(IRenderTarget *pRT);        /**         * OnTimer         * @brief    SOUI窗口的定时器处理函数         * @param    char cTimerID --  定时器ID，范围从0-127。         * @return   void         * Describe  SOUI控件的定时器是Host窗口定时器ID的分解，以方便所有的控件都通过Host获得定时器的分发。         *           注意使用MSG_WM_TIMER_EX来映射该消息。定时器使用SWindow::SetTimer及SWindow::KillTimer来创建及释放。         *           如果该定时器ID范围不能满足要求，可以使用SWindow::SetTimer2来创建。         */            void OnTimer(char cTimerID);        /**         * OnShowWindow         * @brief    处理窗口显示消息         * @param    BOOL bShow --  true:显示         * @param    UINT nStatus --  显示原因         * @return   void          * Describe  参考MSDN的WM_SHOWWINDOW消息         */            void OnShowWindow(BOOL bShow, UINT nStatus);        //SOUI控件消息映射表        SOUI_MSG_MAP_BEGIN()                MSG_WM_TIMER_EX(OnTimer)    //定时器消息            MSG_WM_PAINT_EX(OnPaint)    //窗口绘制消息            MSG_WM_SHOWWINDOW(OnShowWindow)//窗口显示状态消息        SOUI_MSG_MAP_END()        private:        SSkinGif *m_pgif;        int    m_iCurFrame;    };}

实现了该类以后，在WinMain中注册：

        theApp->RegisterWndFactory(TplSWindowFactory<SGifPlayer>());//注册GIFPlayer

我们可以在布局XML中创建GIF控件控件并显示了(trunk\demo\uires\xml\dlg_main.xml）：

        <gifplayer pos="10,10" skin="gif_horse" name="giftest" cursor="ANI_ARROW"/>        <button width="250" height="30" name="btnSelectGif">load gif file</button>        <gifplayer pos="10,150" skin="gif_penguin"/>

上面的gifplayer节点即表示从XML中创建两个SGifPlayer类对象。

而gifplayer对象的skin属性则引用前面定义的SSkinGif对象。

备注：

实际上更多扩展技巧可以参考系统内置的控件的实现。内置控件与扩展控件唯一的区别就在于由谁实现将控件向系统注册。

内置控件在SOUI内核初始化的时候自动注册，而扩展控件则需要手动增加一行注册代码。

效果预览

第十篇：扩展SOUI的控件及绘图对象(ISkinObj)

声明：以上内容来自用户投稿及互联网公开渠道收集整理发布，本网站不拥有所有权，未作人工编辑处理，也不承担相关法律责任，若内容有误或涉及侵权可进行投诉：投诉/举报工作人员会在5个工作日内联系你，一经查实，本站将立刻删除涉嫌侵权内容。

联系
我们

首页 > 代码库 > 第十篇：扩展SOUI的控件及绘图对象(ISkinObj)

第十篇：扩展SOUI的控件及绘图对象(ISkinObj)

绘图对象(ISkinObj)的扩展

控件的扩展

看完仍有疑问？有类似问题直接问程序猿