GUI:Layout_Create
🤖 回答引擎: 前端Lua |
🕒 时间: 2026-06-14 23:12:32 |
👁️ 阅读: 0
`GUI:Layout_Create` 是用于创建布局控件的函数，以下是其完整参数说明和使用示例：
## 函数定义
```lua
GUI:Layout_Create(parent, ID, x, y, width, height, clippingEnabled)
```
## 参数说明
| 参数 | 必选 | 类型 | 说明 |
|------|------|------|------|
| parent | 是 | obj | 父节点对象 |
| ID | 是 | string | 布局控件的唯一标识符 |
| x | 是 | int | 布局左上角的X坐标 |
| y | 是 | int | 布局左上角的Y坐标 |
| width | 是 | int | 布局的宽度 |
| height | 是 | int | 布局的高度 |
| clippingEnabled | 是 | bool | 是否启用裁剪（超出布局区域的内容不可见） |
## 使用示例
```lua
-- 创建父节点
local parent = GUI:Win_Create("GMMain", 0, 0, 0, 0, false, false, true, false, false, false, 1)
-- 创建布局控件
local layout = GUI:Layout_Create(parent, "my_layout", 100, 100, 200, 150, false)
-- 设置布局背景颜色（可选）
GUI:Layout_setBackGroundColor(layout, "#000000")
-- 设置背景透明度（可选）
GUI:Layout_setBackGroundColorOpacity(layout, 255)
-- 设置背景图片（可选）
GUI:Layout_setBackGroundImage(layout, "")
-- 设置是否可触摸（可选）
GUI:setTouchEnabled(layout, true)
-- 设置锚点（可选）
GUI:setAnchorPoint(layout, 0.5, 0.5)
```
## 常用属性设置函数
```lua
-- 设置背景颜色类型（0：无，1：纯色，2：渐变）
GUI:Layout_setBackGroundColorType(layout, 1)
-- 设置九宫格缩放
GUI:Layout_setBackGroundImageScale9Enabled(layout, true)
-- 设置是否可见
GUI:setVisible(layout, true)
-- 设置透明度
GUI:setOpacity(layout, 255)
-- 设置标签
GUI:setTag(layout, 100)
```
**注意事项：**
1. 布局控件通常用作容器，用于组织其他UI控件
2. `clippingEnabled`参数为true时，超出布局区域的内容会被裁剪
3. 布局控件默认不显示背景，需要手动设置背景属性
4. 创建后可以添加其他控件作为其子节点
这是创建UI布局的基础函数，在浮生梦老师的前端课程中会详细讲解各种布局的使用场景和技巧。
← 返回问答库