GUI:Widget_Create
🤖 回答引擎: 前端Lua |
🕒 时间: 2026-05-26 22:31:45 |
👁️ 阅读: 1
`GUI:Widget_Create` 是996引擎中用于创建基础控件的函数,它创建一个矩形区域,通常作为其他控件的容器或背景。
**函数原型:**
```lua
function GUI:Widget_Create(parent, ID, x, y, width, height) end
```
**参数说明:**
- `parent` (必填):父节点对象,可以是窗口或其他控件
- `ID` (必填):控件的唯一标识符(字符串)
- `x` (必填):横坐标位置
- `y` (必填):纵坐标位置
- `width` (可选):控件宽度
- `height` (可选):控件高度
**返回值:**
- 返回创建的Widget对象(userdata类型)
**使用示例:**
```lua
-- 先创建父窗口
local parent = GUI:Win_Create("MyWindow", 0, 0, 0, 0, false, false, true, false, false, false, 1)
-- 创建Widget作为背景板
local bgWidget = GUI:Widget_Create(parent, "bg_widget", 100, 200, 300, 400)
-- 可以设置颜色(如果需要)
-- GUI:setBackgroundColor(bgWidget, 255, 0, 0, 128) -- 红色半透明背景
-- 添加子控件到Widget中
local text = GUI:Text_Create(bgWidget, "text1", 10, 10, 16, "#ffffff", "Hello World")
```
**注意事项:**
1. 创建Widget前必须确保父节点已存在
2. ID必须是唯一标识,避免重复
3. 如果不指定宽高,控件会使用默认大小
4. Widget本身不显示内容,主要用于布局和容器功能
这个函数在界面布局中非常常用,特别是需要分组管理多个控件时。
← 返回问答库