awtk/docs/self_layouter_default.md

缺省的控件自身布局器 (self_layouter_default) 介绍

概述

缺省布局中有 5 个参数：

• x x 坐标
• y y 坐标
• w 控件宽度
• h 控件高度
• floating 是否为浮动布局。 如果设置为 true，该控件不受父控件的 children_layouter 的影响。

二、像素方式

直接指定控件的 x/y/w/h 的像素值，这是缺省的方式，也是最缺乏灵活性的方式。

示例：

• 在 XML 界面描述文件中：

<button x="10" y="5" w="80" h="30" text="ok"/>

• 在代码中：

widget_move_resize(btn, 10, 5, 80, 30);

三、百分比

• x/w 的值如果包含"%"，则自动换算成相对其父控件宽度的百分比。
• y/h 的值如果包含"%"，则自动换算成相对其父控件高度的百分比。

示例：

• 在 XML 界面描述文件中：

<button x="10%" y="10" w="50%" h="30" text="ok"/>

• 在代码中（看起来要麻烦一点）：

widget_set_self_layout_params(btn, "10%", "10", "50%", "30");
widget_layout(btn);

在代码中设置控件的布局参数，方法类似，后面就不再举例子了。

四、水平居中

让控件在水平方向上居中，只需要将 x 的值设置成"c"或者"center"即可。

示例：

<button x="center" y="10" w="50%" h="30" text="ok"/>

五、垂直居中

让控件在垂直方向上居中，只需要将 y 的值设置成"m"或者"middle"即可。

示例：

<button x="center" y="middle" w="50%" h="30" text="ok"/>

六、位于右边

让控件位于父控件的右侧，只需要将 x 的值设置成"r"或者"right"即可。

示例：

<button x="right" y="10" w="50%" h="30" text="ok"/>

如果还想离右侧有一定距离，可以在 right 后指定距离的像素。

示例：

<button x="right:20" y="10" w="50%" h="30" text="ok"/>

七、位于底部

让控件位于父控件的底部，只需要将 y 的值设置成"b"或者"bottom"即可。

示例：

<button x="10" y="bottom" w="50%" h="30" text="ok"/>

如果还想离底部有一定距离，可以在 bottom 后指定距离的像素。

示例：

<button x="10" y="bottom:20" w="50%" h="30" text="ok"/>

八、宽度和高度为负数

无论是像素模式还是百分比模式，宽度和高度均可为负数。

• 宽度为负数。其值为父控件的宽度+该负值。
• 高度为负数。其值为父控件的高度+该负值。

九、浮动布局

如果 floating 设置为 true，该控件不受父控件的 children_layouter 的影响。

示例：

<button x="10" y="20" w="50" h="30" floating="true" "text="ok"/>