awtk/docs/manual/combo_box_t.md

combo_box_t

概述

combobox控件。

函数

函数名称	说明
combo_box_append_option	追加一个选项。
combo_box_cast	转换combo_box对象(供脚本语言使用)。
combo_box_count_options	获取选项个数。
combo_box_create	创建combo_box对象
combo_box_get_option	获取第index个选项。
combo_box_get_text	获取combo_box的文本。
combo_box_get_value	获取combo_box的值。
combo_box_reset_options	重置所有选项。
combo_box_set_open_window	点击按钮时可以打开popup窗口，本函数可设置窗口的名称。
combo_box_set_options	设置选项。
combo_box_set_selected_index	设置第index个选项为当前选中的选项。

属性

名属性称	类型	说明
open_window	char*	为点击按钮时，要打开窗口的名称。
options	char*	设置可选项(冒号分隔值和文本，分号分隔选项，如:1:red;2:green;3:blue)。
selected_index	int32_t	当前选中的选项。
value	int32_t	值。

事件

事件名称	类型	说明
EVT_VALUE_WILL_CHANGE	event_t	值即将改变事件。
EVT_VALUE_CHANGED	event_t	值改变事件。

combo_box_append_option 函数

---

参数	类型	说明
返回值	ret_t	返回RET_OK表示成功，否则表示失败。
widget	widget_t*	combo_box对象。
value	int32_t	值。
text	char*	文本。

追加一个选项。

combo_box_cast 函数

---

参数	类型	说明
返回值	widget_t*	combo_box对象。
widget	widget_t*	combo_box对象。

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

combo_box_count_options 函数

---

参数	类型	说明
返回值	int32_t	返回选项个数。
widget	widget_t*	combo_box对象。

获取选项个数。

combo_box_create 函数

---

参数	类型	说明
返回值	widget_t*	对象。
parent	widget_t*	父控件
x	xy_t	x坐标
y	xy_t	y坐标
w	wh_t	宽度
h	wh_t	高度

创建combo_box对象

combo_box_get_option 函数

---

参数	类型	说明
返回值	combo_box_option_t*	返回index个选项。
widget	widget_t*	combo_box对象。
index	uint32_t	选项的索引。

获取第index个选项。

combo_box_get_text 函数

---

参数	类型	说明
返回值	char*	返回文本。
widget	widget_t*	combo_box对象。

获取combo_box的文本。

combo_box_get_value 函数

---

参数	类型	说明
返回值	int32_t	返回值。
widget	widget_t*	combo_box对象。

获取combo_box的值。

combo_box_reset_options 函数

---

参数	类型	说明
返回值	ret_t	返回RET_OK表示成功，否则表示失败。
widget	widget_t*	combo_box对象。

重置所有选项。

combo_box_set_open_window 函数

---

参数	类型	说明
返回值	ret_t	返回RET_OK表示成功，否则表示失败。
widget	widget_t*	combo_box对象。
open_window	char*	弹出窗口的名称。

点击按钮时可以打开popup窗口，本函数可设置窗口的名称。

combo_box_set_options 函数

---

参数	类型	说明
返回值	ret_t	返回RET_OK表示成功，否则表示失败。
widget	widget_t*	combo_box对象。
options	char*	选项。

设置选项。

combo_box_set_selected_index 函数

---

参数	类型	说明
返回值	ret_t	返回RET_OK表示成功，否则表示失败。
widget	widget_t*	combo_box对象。
index	uint32_t	选项的索引。

设置第index个选项为当前选中的选项。

open_window 属性

---

为点击按钮时，要打开窗口的名称。

• 类型：char*

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

options 属性

---

设置可选项(冒号分隔值和文本，分号分隔选项，如:1:red;2:green;3:blue)。

• 类型：char*

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

selected_index 属性

---

当前选中的选项。

• 类型：int32_t

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

value 属性

---

值。

• 类型：int32_t

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