基础控件 | HiEasyX

📄️ 窗口 Window

窗口是 HiEasyX 里一切控件的"家"。没有窗口，按钮、文本、滑块都无处安放。你可以把它理解为一块带有标题栏的浮动面板，支持拖拽移动、缩放大小，甚至还能折叠起来。

按钮大概是 GUI 里最"老熟人"的控件了。点击它，就会发生一些事情。在 HiEasyX 中，按钮的使用非常简单——调用 Button()，如果返回值是 true，说明这一帧用户刚刚点击了它。

Text() 是 HiEasyX 中最简单的控件——它只负责把一段文字画在屏幕上，不做任何交互，也不响应鼠标。但简单不代表不重要，标签、说明、状态提示都靠它。

Image() 控件让你能在 HiEasyX 的窗口里显示一张图片。它的数据源是 EasyX 的 IMAGE 对象（或者说是一块内存缓冲区），所以你可以加载本地图片、显示程序生成的图像，甚至把其他 EasyX 绘图结果嵌入到 UI 中。

滑块（Slider）是调节数值的利器。拖拽一下，参数就变大了；往回拉，参数又变小。HiEasyX 的滑块支持 1~4 维的 float 和 int 版本，也就是说你可以用一个滑块同时控制 RGBA 四个通道，或者只控制一个音量大小。

复选框就是那个小方框，打勾表示"是"，空白表示"否"。它最适合用来做开关选项，比如"显示网格"、"开启音效"、"自动保存"之类的布尔设置。

有时候你需要展示一组相关的选项，比如"兴趣爱好"（多选）或者"性别"（单选）。一个个写 Checkbox() 当然可以，但 HiEasyX 提供了更方便的 CheckboxGroup() 和 CheckboxGroupSingle()，让你用一份数据配置就能渲染出一整组复选框。

下拉框（也叫下拉菜单、组合框）的作用是：在界面上只占一行的高度，点击后展开一个列表，用户从中选择一项。它特别适合选项较多、但又不希望一直占地方的场景，比如"选择分辨率"、"选择语言"、"选择角色职业"等。

输入框是我们和程序“对话”最常用的方式之一。在 HiEasyX 里，TextInput 提供了一个功能完整的多行文本编辑器，支持光标、选区、滚动条，还有原生的 IME 中文输入。

进度条是最直观的“任务还剩多少”的表达方式。HiEasyX 的 ProgressBar 支持带文字标签和不带标签两种风格，颜色也可以完全自定义，非常适合加载画面、文件拷贝、游戏血条等场景。

有时候，内置控件再丰富，也满足不了你的脑洞。也许你不想画按钮，而是想画一个折线图、粒子效果，或者一个自定义的游戏小地图。这时候就该 Canvas 登场了——它给你一个裸的 HXBufferPainter*，你可以在上面为所欲为。

当内容太多，一个屏幕塞不下时，我们就需要滚动条。HiEasyX 的 Scroller 是一个容器型控件：它包裹住里面所有的子控件，当它们超出可视区域时，自动提供水平和/或竖直滚动条。

标签页（Tab）是现代界面里组织内容的利器：一个窗口里塞下十几页内容，用户点一下标签就能切换，既省空间又清晰。HiEasyX 的 TabBar + TabItem 组合让你轻松实现这一效果。

菜单栏是桌面软件的经典导航方式：顶部一条横杆，点击后下拉出一层层选项。HiEasyX 的 MenuBar 支持无限级嵌套、分隔线和禁用项，足以撑起一个正经的编辑器或 IDE。

工具提示（Tooltip）是 UI 里的“贴心小助手”：当鼠标悬停在某个按钮或图标上时，弹出一行简短的说明文字，告诉用户这个功能是干嘛的。HiEasyX 的 Tooltip 使用极其简单，却能显著提升界面的友好度。

颜色选择器提供了一个带 RGB 滑块和预览框的交互式取色面板。它非常适合需要让用户自定义颜色的场景，例如主题配置、材质颜色、画笔颜色等。