StellarX 更新日志

变更

• Dialog 在窗口 resize、最大化、还原等场景下只重新计算位置并保持居中显示，不再跟随窗口拉伸自身尺寸。
• Dialog 标题改为由自身直接绘制，不再依赖单独的 Label 子控件。
• Window::getWidth() / Window::getHeight() 返回当前已实际生效的客户区尺寸；待处理尺寸改用 getPendingWidth() / getPendingHeight()。
• 非模态对话框覆盖区域内的底层控件不再继续响应鼠标事件。

修复

• 修复直接最大化窗口时可能出现的黑背景与控件残影。
• 修复 Dialog 在 resize、重定位与关闭过程中的背景残留。
• 修复对话框遮挡场景下的底层控件误交互。
• 修复 Canvas / TabControl 在事件已经被消费后仍继续向下分发的问题。
• 修复 Table 在空数据、空表头、列数不一致等输入下的边界风险。
• 修复 Label::setText() 后尺寸与绘制范围不同步的问题。

可能不兼容

• Dialog::setInitialization(bool) 已移除。
• 如果旧代码将 Window::getWidth() / getHeight() 当作待收口尺寸使用，需要改用 getPendingWidth() / getPendingHeight()。

注意

• 此次更新变更了 TextBox::setText 语义。旧代码如果在调用 setText 后手动调用 draw，升级后应删除相关调用，避免概率触发闪烁。

变更

• TextBox::setText 语义调整：文本未变化时直接返回；文本变化时根据图形上下文/窗口是否创建决定立即重绘或仅标脏。
• TextBox 文本溢出绘制时按像素宽度截断并添加省略号，内部仍保存完整文本。

修复

• 修复 TabControl::getActiveIndex() 在无激活页签时可能返回错误索引的问题。
• 修复对话框打开时持续触发全量重绘的问题。
• 修复对话框关闭合成 WM_MOUSEMOVE 的触发时机问题。
• 调整 Window::runEventLoop 普通控件事件分发顺序，由正序改为逆序遍历。

新增

• 新增日志系统使用 Demo：examples\SXLog-日志系统使用demo。
• 新增轻量日志系统 SxLog，支持级别与 Tag 筛选、控制台/文件输出、按大小滚动、中英文双语文本选择。
• 提供 SX_LOGD、SX_LOGI、SX_LOGW、SX_LOGE、SX_LOGF、SX_LOG_TRACE、SX_TRACE_SCOPE 等宏。

变更

• TabControl 页签切换时序调整为“先关闭当前已打开页，再打开目标页”。
• 控件 Setter 语义收敛为“更新状态并标脏”，绘制由窗口/容器的重绘收口机制触发。

修复

• 修复 TextBox::setText 在进入事件循环前调用触发中断的问题。
• 修复 TabControl 切换/关闭后 Table 新旧内容重叠的问题。

可能不兼容

• 删除 Button 尺寸别名 API：getButtonWidth() / getButtonHeight()，统一使用 getWidth() / getHeight()。
• setIsVisible(true) 与 setText() 等 Setter 不再保证立刻触发绘制。

新增

• Table 支持运行期重置表头与数据，新增 clearHeaders()、clearData()、resetTable()。
• TextBox 新增 PASSWORD_MODE，绘制层面使用掩码字符显示。

变更

• TabControl 默认激活页语义明确化：首次绘制前只记录默认激活索引，首次绘制后再生效。

修复

• 修复 TabControl::setActiveIndex 绘制前调用导致程序中断的问题。
• 修复 TabControl 由不可见设置为可见时非激活页错误绘制的问题。