godking.message 是一个功能完备的 Aardio 信息框库，在原生 winform 基础上扩展了
20+ 种交互形态（提示、警告、错误、询问、输入、选择、进度、图片、超链接、自定义表单等），
并内置 淡入淡出、透明、鼠标穿透、右下角组队列 等高级特性。
🎯 设计哲学： 将复杂的 UI 交互封装为“一行代码”的调用，同时保留高度可定制性（颜色、字体、图标、动画、布局），
让开发者专注于业务逻辑，而非窗口细节。
🧱 架构 · 类层次
class godking.message {
— parent, title, icon, bgcolor, textColor, btnBgColor
— fadeInterval, fadeDuration, transparent, topmost, modalMode
— info, warn, ok, err, great, sorry, smile, frown
— ask, input, select, link, progress, img, form
— wait, pop
— create, createAndShow, disableClose
}
class message.group {
— 右下角消息队列，自动排列，支持 closeAll / close(index)
}
⚡ 功能全景
📢 8 种预设风格
info · warn · ok · err · great · sorry · smile · frown —— 每种带专属 FontAwesome 图标和配色，一键调用。
信息警告成功错误表情
🧩 交互型对话框
ask 确认/取消 · input 单行/密码输入 · select 单选/多选 · link 超链接 · form 嵌入自定义窗体。
模态返回值自定义
📊 进度 & 等待
progress 带进度条（可更新文本/值），wait 沙漏动画（无需关闭，可手动 close）。
非模态实时更新getPlus
🖼️ 图片 & 自定义
img 显示图片（支持缩放），form 加载任意子窗口，可传递参数并获取返回值。
gdip.bitmap子窗体
✨ 视觉增强
淡入淡出动画 (fadeDuration) · 透明度 (transparent) · 鼠标穿透 (layered) · 圆角 · 边框 · 标题栏 · 拖拽移动。
动画透明圆角
📦 右下角组 (group)
消息队列在屏幕右下角依次排列，自动避让，支持 closeAll / close(index)，适合通知中心场景。
队列多屏自动排列
📌 版本迭代 · 关键里程碑
| 版本 | 日期 | 核心更新 |
|---|
| 3.3.2 | — | select 增加选中值数组参数 |
| 3.3.5 | — | 进度条增加 getPlus() |
| 3.3.6 | — | 窗口最前、透明度、鼠标穿透 |
| 3.3.7 | — | 增加 右下角弹出提示框组 (group) |
| 3.3.8 | — | 增加 escClose 属性 |
| 3.4.0 | — | 修正 trasparent 初始值 |
| 3.4.1 | — | 修复 topmost 启动闪烁 |
| 3.4.3 | — | 信息框实例可操作 winform |
| 3.6 | — | 修复 fadeInterval=0 不关闭的问题 |
| 3.7 | — | group().message 智能提示匹配整体设置 |
| 3.9 | — | 修复 title 导致鼠标事件失效 |
| 4.0 | — | 增加 wait()，优化淡入淡出及窗口等待 |
| 4.2 | — | 优化 wait 提示框，增加 setInfo() |
| 4.5 | — | 增加 getScreenByWinform() / getScreenByMouse() |
| 4.6 | — | 增加 pop() (Win10+ 原生样式) |
| 4.7 | 2026-03-30 | 优化部分智能提示 |
🌟 亮点与设计优势
- 零依赖接入 —— 仅需 import godking.message，自动为所有 winform 注入 msgInfo、msgAsk 等系列方法。
- 链式配置与构建 —— 通过属性直接修改样式（如 message.bgcolor = 0xF0F0F0），无需重写窗口。
- 完整的模态/非模态支持 —— modalMode 控制是否阻塞，doModal() / endModal() 灵活交互。
- 智能多屏适配 —— group 自动识别屏幕，支持指定屏幕序号，鼠标/窗口定位准确。
- FontAwesome 深度集成 —— 所有图标、按钮文本均可使用图标字体，视觉统一且丰富。
- 动画与体验 —— 淡入淡出平滑，超时关闭可配置上移消失，细节精致。
- 扩展性强 —— form() 可加载任意子窗体，实现复杂交互；img() 支持内存/文件图片。
📘 典型调用示例
winform.msgInfo("操作成功", 2000);
winform.msgErr("文件未找到", 0, true);
if ( winform.msgAsk("确认删除？") ) {
}
var name = winform.msgInput("请输入姓名", false);
var prog = winform.msgProgress("处理中", 0, "0%");
prog.getPlus().progressPos = 50;
prog.getPlus().text = "50%";
var g = godking.message.group(winform);
g.info("新消息1", 3000);
g.warn("新消息2", 4000);
g.closeAll();
var msg = godking.message(winform);
msg.bgcolor = 0x2C3E50;
msg.textColor = 0xFFFFFF;
msg.iconColor = 0xF1C40F;
msg.fadeDuration = 500;
msg.info("自定义风格", 3000);
⚙️ 可配置属性一览
title · 标题
icon · FontAwesome 图标
iconColor · 图标颜色
textColor · 文本颜色
bgcolor · 背景色
btnBgColor · 按钮区底色
fadeInterval · 动画间隔
fadeDuration · 动画时长
transparent · 透明度 0-100
topmost · 总在最前
modalMode · 模态阻塞
escClose · ESC 关闭
borderWidth · 边框宽度
round · 圆角大小
okLabel / cancelLabel · 按钮文字
progressBgColor / foreColor · 进度条配色
🎯 典型应用场景
🖥️ 桌面软件提示
📋 表单验证反馈
⏳ 长时间任务进度
🔔 通知中心 (group)
📝 快速输入/选择
🖼️ 图片预览
🧩 插件/工具弹窗
📊 数据导入导出提示
📌
综合评价
godking.message 是 Aardio 生态中 功能最全面、体验最精致 的信息框库之一。
它不仅覆盖了从简单提示到复杂交互的全部场景，更在 动画、多屏适配、扩展性 上做了深度优化。
代码风格统一，配置灵活，且与 winform 无缝集成，极大提升了桌面应用的开发效率与用户体验。
无论是快速原型还是企业级软件，它都能提供可靠、美观的交互解决方案。
👍 开箱即用
👍 高度可定制
👍 持续迭代 4年+
👍 社区验证