基础控件接口
基础控件接口即为所有控件的共用接口,所有控件都继承此类接口。
更新控件背景图片
/**
* @brief 更新控件背景图片
*
* @param [in] strName 按键输入图片路径(格式仅支持png),
* 相对路径为inonegui/res/ui或使用系统绝对路径。
* @return 无返回值
*
* @details More details
*/
VOID SetBgImage(STRING strName);
例如:更新控件背景图片, SetBgImage("bg/bg_0.png");
更新控件背景颜色
/**
* @brief 更新控件背景颜色
*
* @param [in] iColor RGB 24bit颜色,当前未支持alpha,
* 可以直接写值或使用预定义值如COLOR_BLACK等值,
* 详情可以参考在AiinoneIDE输入COLOR时的提示信息
*
* @return 无返回值
*
* @details More details
*/
VOID SetBgColor(DWORD iColor);
例如:更新控件背景颜色红色, SetBgColor(0xFF0000);或 SetBgColor(COLOR_RED);
更新控件是否可见
/**
* @brief 更新控件是否可见
*
* @param [in] bEnable TRUE:正常状态CTRL_STATE_NORMAL;FALSE:不可见状态CTRL_STATE_INVISIBLE
* @return 无返回值
*
* @details More details
*/
VOID SetVisible(BOOL bEnable);
例如:更新控件为不可见状态, SetVisible(FALSE);
更新控件是否可操作(禁止)
/**
* @brief 更新控件是否可操作
*
* @param [in] bEnable TRUE:正常状态CTRL_STATE_NORMAL;FALSE:禁止状态CTRL_STATE_DISABLED
* 禁止状态即代表不能操作,不能接收输入事件。
* @return 无返回值
*
* @details More details
*/
VOID SetEnabled(BOOL bEnable);
例如:更新控件为禁止状态, SetEnabled(FALSE);
更新控件是否选中
/**
* @brief 更新控件选中状态
*
* @param [in] bEnable TRUE:选中/开状态;FALSE:正常/关状态
* @return 无返回值
*
* @details More details
*/
VOID SetSelected(BOOL bEnable);
例如:开关按键的开启/关闭状态设置, 开:SetSelected(TRUE);关:SetSelected(FALSE);
查询控件可见状态
/**
* @brief 查询控件可见状态
*
* @param [in] 无参数
* @return 返回值 TRUE:可见;FALSE:不可见
*
* @details More details
*/
BOOL IsVisible();
例如:查询控件可见状态, pctrl->IsVisible()
查询控件可操作状态
/**
* @brief 查询控件可操作状态
*
* @param [in] 无参数
* @return 返回值 TRUE:可操作;FALSE:不可操作
*
* @details More details
*/
BOOL IsEnable();
例如:查询控件可操作状态, pctrl->IsEnable()
查询控件选中状态
/**
* @brief 查询控件选中状态
*
* @param [in] 无参数
* @return 返回值 TRUE:选中;FALSE:未选中
*
* @details More details
*/
BOOL IsSelected();
例如:查询控件选中/开启状态,常用在开关, pctrl->IsSelected()
手动强制刷新控件
/**
* @brief 手动强制刷新控件
*
* @param [in] pCtrl:刷新对象,默认参数为NULL;bNowPaint:是否立即刷新
* @return 返回值 ERR_OK
*
* @details More details
*/
INT AddRefreshCtrl(LTControl *pCtrl = NULL, BOOL bNowPaint = FALSE);
例如:手动强制刷新控件,通常情况下使用默认参数即可,刷新pctrl对象:pctrl->AddRefreshCtrl()