awtk/docs/manual/combo_box_item_t.md
2019-01-15 14:34:05 +08:00

158 lines
4.0 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

## combo\_box\_item\_t
### 概述
![image](images/combo_box_item_t_0.png)
ComboBox Item控件。
本类仅供combo\_box控件内部使用。
----------------------------------
### 函数
<p id="combo_box_item_t_methods">
| 函数名称 | 说明 |
| -------- | ------------ |
| <a href="#combo_box_item_t_combo_box_item_cast">combo\_box\_item\_cast</a> | 转换combo_box_item对象(供脚本语言使用)。 |
| <a href="#combo_box_item_t_combo_box_item_create">combo\_box\_item\_create</a> | 创建combo_box_item对象 |
| <a href="#combo_box_item_t_combo_box_item_set_checked">combo\_box\_item\_set\_checked</a> | 设置控件是否被选中。 |
| <a href="#combo_box_item_t_combo_box_item_set_value">combo\_box\_item\_set\_value</a> | 设置控件的值。 |
### 属性
<p id="combo_box_item_t_properties">
| 名属性称 | 类型 | 说明 |
| -------- | ----- | ------------ |
| <a href="#combo_box_item_t_checked">checked</a> | bool\_t | 是否被选中。 |
| <a href="#combo_box_item_t_value">value</a> | int32\_t | 值。 |
### 事件
<p id="combo_box_item_t_events">
| 事件名称 | 类型 | 说明 |
| -------- | ----- | ------- |
| EVT\_VALUE\_WILL\_CHANGE | event\_t | 值(勾选状态)即将改变事件。 |
| EVT\_VALUE\_CHANGED | event\_t | 值(勾选状态)改变事件。 |
#### combo\_box\_item\_cast 函数
-----------------------
* 函数功能:
> <p id="combo_box_item_t_combo_box_item_cast"> 转换combo_box_item对象(供脚本语言使用)。
* 函数原型:
```
widget_t* combo_box_item_cast (widget_t* widget);
```
* 参数说明:
| 参数 | 类型 | 说明 |
| -------- | ----- | --------- |
| 返回值 | widget\_t* | combo\_box\_item对象。 |
| widget | widget\_t* | combo\_box\_item对象。 |
#### combo\_box\_item\_create 函数
-----------------------
* 函数功能:
> <p id="combo_box_item_t_combo_box_item_create"> 创建combo_box_item对象
* 函数原型:
```
widget_t* combo_box_item_create (widget_t* parent, xy_t x, xy_t y, wh_t w, wh_t h);
```
* 参数说明:
| 参数 | 类型 | 说明 |
| -------- | ----- | --------- |
| 返回值 | widget\_t* | 对象。 |
| parent | widget\_t* | 父控件 |
| x | xy\_t | x坐标 |
| y | xy\_t | y坐标 |
| w | wh\_t | 宽度 |
| h | wh\_t | 高度 |
#### combo\_box\_item\_set\_checked 函数
-----------------------
* 函数功能:
> <p id="combo_box_item_t_combo_box_item_set_checked"> 设置控件是否被选中。
* 函数原型:
```
ret_t combo_box_item_set_checked (widget_t* widget, bool_t checked);
```
* 参数说明:
| 参数 | 类型 | 说明 |
| -------- | ----- | --------- |
| 返回值 | ret\_t | 返回RET\_OK表示成功否则表示失败。 |
| widget | widget\_t* | combo\_box\_item对象。 |
| checked | bool\_t | 是否被选中。 |
#### combo\_box\_item\_set\_value 函数
-----------------------
* 函数功能:
> <p id="combo_box_item_t_combo_box_item_set_value"> 设置控件的值。
* 函数原型:
```
ret_t combo_box_item_set_value (widget_t* widget, int32_t value);
```
* 参数说明:
| 参数 | 类型 | 说明 |
| -------- | ----- | --------- |
| 返回值 | ret\_t | 返回RET\_OK表示成功否则表示失败。 |
| widget | widget\_t* | combo\_box\_item对象。 |
| value | int32\_t | 值 |
#### checked 属性
-----------------------
> <p id="combo_box_item_t_checked"> 是否被选中。
* 类型bool\_t
| 特性 | 是否支持 |
| -------- | ----- |
| 可直接读取 | 是 |
| 可直接修改 | 否 |
| 可持久化 | 是 |
| 可脚本化 | 是 |
| 可在IDE中设置 | 是 |
| 可在XML中设置 | 是 |
| 可通过widget\_get\_prop读取 | 是 |
| 可通过widget\_set\_prop修改 | 是 |
#### value 属性
-----------------------
> <p id="combo_box_item_t_value"> 值。
* 类型int32\_t
| 特性 | 是否支持 |
| -------- | ----- |
| 可直接读取 | 是 |
| 可直接修改 | 否 |
| 可持久化 | 是 |
| 可脚本化 | 是 |
| 可在IDE中设置 | 是 |
| 可在XML中设置 | 是 |
| 可通过widget\_get\_prop读取 | 是 |
| 可通过widget\_set\_prop修改 | 是 |