Skip to content

自定义控件开发

Warning

The current page still doesn't have a translation for this language.

You can read it through google translate.

SOUI框架提供了丰富的内置控件，但在实际应用中，我们常常需要开发自定义控件来满足特定的需求。本文将详细介绍如何在SOUI中开发自定义控件。

自定义控件开发流程

1. 选择基类

开发自定义控件的第一步是选择合适的基类。合理的基类选择是正确开发自定义控件的前提：

  • 如果是全新的控件，可以直接从 SWindow 继承
  • 如果是对现有控件的扩展，则从相应的控件类继承

2. 定义控件类

class SCustomControl : public SWindow
{
    SOUI_CLASS_NAME(SCustomControl, L"custom")  // 定义XML标签名
public:
    SCustomControl(void);
    ~SCustomControl(void);

protected:
    // 控件实现代码
};

3. 添加消息映射

SOUI的消息处理机制与WTL类似：

SOUI_MSG_MAP_BEGIN()
    MSG_WM_PAINT_EX(OnPaint)      // 处理绘制消息
    MSG_WM_LBUTTONDOWN(OnLButtonDown)  // 处理左键按下
SOUI_MSG_MAP_END()

注意：部分消息映射宏与WTL不同，比如： - MSG_WM_PAINT_EX 替代 MSG_WM_PAINT - MSG_WM_ERASEBKGND_EX 替代 MSG_WM_ERASEBKGND

4. 添加属性映射

为控件添加自定义属性支持：

SOUI_ATTRS_BEGIN()
    ATTR_COLOR(L"textColor", m_crText, TRUE)    // 文本颜色
    ATTR_SKIN(L"skin", m_pBgSkin, TRUE)         // 背景皮肤
    ATTR_CUSTOM(L"customAttr", OnAttrCustom)    // 自定义属性
SOUI_ATTRS_END()

5. 实现绘制逻辑

重写OnPaint方法实现控件的绘制：

void SCustomControl::OnPaint(IRenderTarget *pRT)
{
    // 绘制背景
    if(m_pBgSkin) 
    {
        m_pBgSkin->Draw(pRT, GetClientRect(), 0);
    }

    // 绘制自定义内容
    // ...
}

6. 注册控件

在应用程序初始化时注册自定义控件：

theApp->RegisterWndFactory(TplSWindowFactory<SCustomControl>());

绘图对象扩展

除了控件，SOUI还支持扩展绘图对象（ISkinObj）来实现自定义的绘制效果。

1. 创建自定义Skin类

class SCustomSkin : public ISkinObj
{
    SOUI_CLASS_NAME(SCustomSkin, L"customskin")
public:
    SCustomSkin();
    ~SCustomSkin();

    // 实现必要的接口
    virtual void Draw(IRenderTarget *pRT, LPCRECT rcDraw, DWORD dwState, BYTE byAlpha=0xFF);
    virtual SIZE GetSkinSize();
    virtual int GetStates();
};

2. 实现Draw方法

void SCustomSkin::Draw(IRenderTarget *pRT, LPCRECT rcDraw, DWORD dwState, BYTE byAlpha)
{
    // 实现绘制逻辑
}

3. 注册Skin对象

theApp->RegisterSkinFactory(TplSkinFactory<SCustomSkin>());

使用示例

XML中使用自定义控件

<customskin name="mySkin">
    <!-- skin属性设置 -->
</customskin>

<custom width="100" height="30" skin="mySkin">
    <!-- 控件内容 -->
</custom>

代码中使用

// 创建自定义控件
SCustomControl *pCustom = new SCustomControl();
parent->InsertChild(pCustom);

// 设置属性
pCustom->SetAttribute(L"skin", L"mySkin");

最佳实践

  1. 合理选择基类
  2. 充分利用现有控件功能

  3. 避免重复实现已有功能

  4. 良好的代码组织

  5. 类声明和实现分离

  6. 合理的文件组织结构

  7. 属性设计

  8. 提供足够的可配置性

  9. 属性命名要清晰易懂

  10. 性能优化

  11. 减少不必要的重绘
  12. 优化绘制算法

  13. 合理使用缓存

  14. 事件处理

  15. 提供必要的事件通知
  16. 合理的事件参数设计

调试技巧

  1. 使用SOUI提供的调试工具
  2. 合理使用断点和日志
  3. 检查消息处理和事件分发
  4. 验证属性设置是否生效