awtk/docs/manual/row_t.md
2019-11-15 11:33:43 +08:00

78 lines
2.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.

## row\_t
### 概述
![image](images/row_t_0.png)
row。一个简单的容器控件用于水平排列其子控件。
它本身不提供布局功能仅提供具有语义的标签让xml更具有可读性。
子控件的布局可用layout\_children属性指定。
请参考[布局参数](https://github.com/zlgopen/awtk/blob/master/docs/layout.md)。
row\_t是[widget\_t](widget_t.md)的子类控件widget\_t的函数均适用于row\_t控件。
在xml中使用"row"标签创建row。如
```xml
<row x="0" y="0" w="100%" h="100%" children_layout="default(c=0,r=1)">
<button name="open:basic" text="Basic"/>
<button name="open:button" text="Buttons"/>
<button name="open:edit" text="Edits"/>
<button name="open:keyboard" text="KeyBoard"/>
</row>
```
可用通过style来设置控件的显示风格如背景颜色等。如
```xml
<style name="default" border_color="#a0a0a0">
<normal bg_color="#f0f0f0" />
</style>
```
----------------------------------
### 函数
<p id="row_t_methods">
| 函数名称 | 说明 |
| -------- | ------------ |
| <a href="#row_t_row_cast">row\_cast</a> | 转换为row对象(供脚本语言使用)。 |
| <a href="#row_t_row_create">row\_create</a> | 创建row对象 |
#### row\_cast 函数
-----------------------
* 函数功能:
> <p id="row_t_row_cast">转换为row对象(供脚本语言使用)。
* 函数原型:
```
widget_t* row_cast (widget_t* widget);
```
* 参数说明:
| 参数 | 类型 | 说明 |
| -------- | ----- | --------- |
| 返回值 | widget\_t* | row对象。 |
| widget | widget\_t* | row对象。 |
#### row\_create 函数
-----------------------
* 函数功能:
> <p id="row_t_row_create">创建row对象
* 函数原型:
```
widget_t* row_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 | 高度 |