image_base_t

概述

image

图片控件基类。

本类把图片相关控件的公共行为进行抽象,放到一起方便重用。目前已知的具体实现如下图:

image

本类是一个抽象类,不能进行实例化。请在应用程序中使用具体的类,如image_t。


函数

函数名称 说明
image_base_cast 转换为image_base对象(供脚本语言使用)。
image_set_anchor 设置控件的锚点(仅在WITH_VGCANVAS定义时生效)。
image_set_clickable 设置控件是否可以被点击。
image_set_image 设置控件的图片名称。
image_set_rotation 设置控件的旋转角度(仅在WITH_VGCANVAS定义时生效)。
image_set_scale 设置控件的缩放比例(仅在WITH_VGCANVAS定义时生效)。
image_set_selectable 设置控件是否可以被选中。
image_set_selected 设置控件的选中状态。

属性

属性名称 类型 说明
anchor_x float_t 锚点X(0-1)。0在控件左边,0.5在控件中间,1在控件右边。
anchor_y float_t 锚点Y(0-1)。0在控件顶部,0.5在控件中间,1在控件底部。
clickable bool_t 点击时,是否触发EVT_CLICK事件。
image char* 图片的名称。
rotation float_t 控件的旋转角度(幅度)。
scale_x float_t 控件在X方向上的缩放比例。
scale_y float_t 控件在Y方向上的缩放比例。
selectable bool_t 是否设置选中状态。
selected bool_t 当前是否被选中。

image_base_cast 函数


  • 函数功能:

转换为image_base对象(供脚本语言使用)。

  • 函数原型:
  1. widget_t* image_base_cast (widget_t* widget);
  • 参数说明:
参数 类型 说明
返回值 widget_t* image_base对象。
widget widget_t* image_base对象。

image_set_anchor 函数


  • 函数功能:

设置控件的锚点(仅在WITH_VGCANVAS定义时生效)。

  • 函数原型:
  1. ret_t image_set_anchor (widget_t* widget, float_t anchor_x, float_t anchor_y);
  • 参数说明:
参数 类型 说明
返回值 ret_t 返回RET_OK表示成功,否则表示失败。
widget widget_t* 控件对象。
anchor_x float_t 锚点X(0-1)。0在控件左边,0.5在控件中间,1在控件右边。
anchor_y float_t 锚点Y(0-1)。0在控件顶部,0.5在控件中间,1在控件底部。

image_set_clickable 函数


  • 函数功能:

设置控件是否可以被点击。

  • 函数原型:
  1. ret_t image_set_clickable (widget_t* widget, bool_t clickable);
  • 参数说明:
参数 类型 说明
返回值 ret_t 返回RET_OK表示成功,否则表示失败。
widget widget_t* 控件对象。
clickable bool_t 是否可以被点击。

image_set_image 函数


  • 函数功能:

设置控件的图片名称。

  • 函数原型:
  1. ret_t image_set_image (widget_t* widget, char* name);
  • 参数说明:
参数 类型 说明
返回值 ret_t 返回RET_OK表示成功,否则表示失败。
widget widget_t* image对象。
name char* 图片名称,该图片必须存在于资源管理器。

image_set_rotation 函数


  • 函数功能:

设置控件的旋转角度(仅在WITH_VGCANVAS定义时生效)。

  • 函数原型:
  1. ret_t image_set_rotation (widget_t* widget, float_t rotation);
  • 参数说明:
参数 类型 说明
返回值 ret_t 返回RET_OK表示成功,否则表示失败。
widget widget_t* 控件对象。
rotation float_t 旋转角度(幅度)。

image_set_scale 函数


  • 函数功能:

设置控件的缩放比例(仅在WITH_VGCANVAS定义时生效)。

  • 函数原型:
  1. ret_t image_set_scale (widget_t* widget, float_t scale_x, float_t scale_y);
  • 参数说明:
参数 类型 说明
返回值 ret_t 返回RET_OK表示成功,否则表示失败。
widget widget_t* 控件对象。
scale_x float_t X方向缩放比例。
scale_y float_t Y方向缩放比例。

image_set_selectable 函数


  • 函数功能:

设置控件是否可以被选中。

  • 函数原型:
  1. ret_t image_set_selectable (widget_t* widget, bool_t selectable);
  • 参数说明:
参数 类型 说明
返回值 ret_t 返回RET_OK表示成功,否则表示失败。
widget widget_t* 控件对象。
selectable bool_t 是否可以被选中。

image_set_selected 函数


  • 函数功能:

设置控件的选中状态。

  • 函数原型:
  1. ret_t image_set_selected (widget_t* widget, bool_t selected);
  • 参数说明:
参数 类型 说明
返回值 ret_t 返回RET_OK表示成功,否则表示失败。
widget widget_t* 控件对象。
selected bool_t 是否被选中。

anchor_x 属性


锚点X(0-1)。0在控件左边,0.5在控件中间,1在控件右边。

  • 类型:float_t
特性 是否支持
可直接读取
可直接修改
可持久化
可脚本化
可在IDE中设置
可在XML中设置
可通过widget_get_prop读取
可通过widget_set_prop修改

anchor_y 属性


锚点Y(0-1)。0在控件顶部,0.5在控件中间,1在控件底部。

  • 类型:float_t
特性 是否支持
可直接读取
可直接修改
可持久化
可脚本化
可在IDE中设置
可在XML中设置
可通过widget_get_prop读取
可通过widget_set_prop修改

clickable 属性


点击时,是否触发EVT_CLICK事件。

  • 类型:bool_t
特性 是否支持
可直接读取
可直接修改
可持久化
可脚本化
可在IDE中设置
可在XML中设置
可通过widget_get_prop读取
可通过widget_set_prop修改

image 属性


图片的名称。

  • 类型:char*
特性 是否支持
可直接读取
可直接修改
可持久化
可脚本化
可在IDE中设置
可在XML中设置
可通过widget_get_prop读取
可通过widget_set_prop修改

rotation 属性


控件的旋转角度(幅度)。

  • 类型:float_t
特性 是否支持
可直接读取
可直接修改
可持久化
可脚本化
可在IDE中设置
可在XML中设置
可通过widget_get_prop读取
可通过widget_set_prop修改

scale_x 属性


控件在X方向上的缩放比例。

  • 类型:float_t
特性 是否支持
可直接读取
可直接修改
可持久化
可脚本化
可在IDE中设置
可在XML中设置
可通过widget_get_prop读取
可通过widget_set_prop修改

scale_y 属性


控件在Y方向上的缩放比例。

  • 类型:float_t
特性 是否支持
可直接读取
可直接修改
可持久化
可脚本化
可在IDE中设置
可在XML中设置
可通过widget_get_prop读取
可通过widget_set_prop修改

selectable 属性


是否设置选中状态。

  • 类型:bool_t
特性 是否支持
可直接读取
可直接修改
可持久化
可脚本化
可在IDE中设置
可在XML中设置
可通过widget_get_prop读取
可通过widget_set_prop修改

selected 属性


当前是否被选中。

  • 类型:bool_t
特性 是否支持
可直接读取
可直接修改
可脚本化