本稿为扩展类库 API,不是 YSS 选择器。 无
tiplayer { … };外观由下方方法控制。
D2D 自绘提示层,可绑定任意组件或主窗口。与组件属性「提示」(Win32 Tooltip)并存。
声明:提示层类 tips;亦可用 创建提示层()。
硬约束
- 方法调用必须带括号:
tips.文本("…")。 绑定填组件名(可无引号的标识符,或逗号分隔字符串);悬停锚定当前悬停目标。- 显隐回调用
置显示事件/置隐藏事件,回调形参为无参函数;传0清除。 - 不要套用控件「硬约束与叠画」模板去绑绘制类——提示层本身即浮层。
快速开始
提示层类 tips
tips.文本("第一行\n第二行")
tips.类型(2)
tips.主题(3)
tips.图标(":/img/ok.png")
tips.可关闭(1)
tips.动画(1)
tips.绑定("按钮1,编辑框1")
常量
| 项 | 取值 |
|---|---|
| 类型 | 1普通 · 2气泡 · 3浮层角标 · 4脉冲角标 |
| 浮层模式 | 1悬停 · 2常驻(类型 3;类型 4 默认常驻) |
| 方位 | -1自动 · 1上 · 2下 · 3左 · 4右 |
| 主题 | 0默认 · 1暗 · 2亮 · 3成功 · 4警告 · 5危险 · 6信息 |
| 可关闭 | 1显示 · 0隐藏 |
| 动画 | 0–67(0无;1淡入淡出;2放大…;过大钳制) |
默认悬停:显示延迟 300 ms,隐藏延迟 100 ms(绑定 后)。
方法签名
| 方法 | 签名 | 返回 | 说明 |
|---|---|---|---|
文本 |
无 tips.文本([文本 内容=""]) |
无 | 支持 \n |
类型 |
无 tips.类型([整数 样式=1]) |
无 | |
动画 |
无 tips.动画([整数 预设=0]) |
无 | 0–67 |
浮层模式 |
无 tips.浮层模式([整数 模式=1]) |
无 | |
背景色 |
无 tips.背景色([文本 颜色="#333333"]) |
无 | |
文字色 |
无 tips.文字色([文本 颜色="#FFFFFF"]) |
无 | |
圆角 |
无 tips.圆角([整数 半径=8]) |
无 | |
最大宽度 |
无 tips.最大宽度([整数 宽度=280]) |
无 | |
偏移 |
无 tips.偏移([整数 X=0], [整数 Y=0]) |
无 | |
显示延迟 |
无 tips.显示延迟([整数 毫秒=300]) |
无 | |
隐藏延迟 |
无 tips.隐藏延迟([整数 毫秒=100]) |
无 | |
方位 |
无 tips.方位([整数 方向=-1]) |
无 | |
字号 |
无 tips.字号([整数 像素=12]) |
无 | 最小 6 |
内边距 |
无 tips.内边距([整数 水平=12], [整数 垂直=8]) |
无 | |
图标 |
无 tips.图标([文本 路径=""]) |
无 | :/ 或文件 |
可关闭 |
无 tips.可关闭([整数 开关=1]) |
无 | |
主题 |
无 tips.主题([整数 编号=0]) |
无 | |
绑定 |
无 tips.绑定(…) |
无 | 组件名;亦 "a,b" |
显示 |
无 tips.显示() |
无 | |
隐藏 |
无 tips.隐藏() |
无 | |
置显示事件 |
无 tips.置显示事件([子程序指针 回调]) |
无 | 0 清除 |
置隐藏事件 |
无 tips.置隐藏事件([子程序指针 回调]) |
无 | 0 清除 |
事件(回调)
| 注册 | 回调签名 | 触发 |
|---|---|---|
置显示事件(&fn) |
函数 fn() |
变为可见 |
置隐藏事件(&fn) |
函数 fn() |
变为隐藏 |
tips.置显示事件(&提示已显示)
函数 提示已显示() {
输出("tips shown")
}