本文详解 GXUI 框架中 TextBox 尺寸控制的常见误区与正确实践，重点说明为何直接调用 SetSize() 无效，并提供基于主线程调度的安全解决方案。
本文详解 gxui 框架中 textbox 尺寸控制的常见误区与正确实践，重点说明为何直接调用 `setsize()` 无效，并提供基于主线程调度的安全解决方案。
在 Go GXUI 中，TextBox 的尺寸不能通过简单的 SetSize() 方法在任意时刻直接设定——这是初学者最容易踩坑的地方。GXUI 是一个基于事件驱动、跨平台的 GUI 框架，其 UI 组件的状态更新（包括布局、尺寸、可见性等）必须在 UI 主线程（即 driver 所在 goroutine）中执行。若在非 UI 线程（如初始化逻辑或回调外的普通 goroutine）中调用 SetSize()，该操作会被忽略或延迟失效，导致界面仍显示默认窄条状（通常仅适配文本内容宽度），即使传入了 math.Size{W: 300, H: 300} 也毫无反应。
根本原因在于：GXUI 的渲染管线与事件循环由 driver 管理，所有 UI 变更需经 driver.Call() 同步到主线程。直接调用 textBox.SetSize(...) 属于“异步脏写”，绕过了框架的调度机制，因此无效。
✅ 正确做法是使用 driver.Call() 将尺寸设置操作安全地提交至 UI 主线程：
// 假设 driver 和 theme 已正确初始化
textBox := theme.CreateTextBox()
textBox.SetText("")
// ✅ 正确：通过 driver.Call 调度到 UI 线程
driver.Call(func() {
textBox.SetSize(math.Size{W: 300, H: 300})
})⚠️ 注意事项：
-
不要在 goroutine 中裸调 SetSize：如下写法依然错误（未包裹 driver.Call）：
go func() { textBox.SetSize(math.Size{W: 300, H: 300}) // ❌ 仍运行在新 goroutine，非 UI 线程 }() - 推荐在组件挂载后设置：确保 textBox 已被添加至容器（如 layout.Widget）并完成初次布局后再调用 driver.Call，可避免因组件未就绪导致的静默失败。
- 尺寸单位为逻辑像素：math.Size 中的 W/H 均为 GXUI 抽象的逻辑像素（logical pixels），自动适配不同 DPI 屏幕，无需手动缩放。
- 替代方案：若需响应式宽度（如占满父容器），应优先使用布局管理器（如 layout.NewHBoxLayout() 或 layout.NewVBoxLayout() 配合 widget.Expand 策略），而非硬编码尺寸。
总结：GXUI 中 UI 组件的任何状态变更（含尺寸、位置、文本、样式）都必须通过 driver.Call() 进行线程安全调度。理解并遵守这一约束，是写出稳定、可维护 GXUI 应用的关键前提。
