YStudio Y++

提示层类(扩展类库)

Y++ / YStudio 开发文档 · 一点滴

本稿为扩展类库 API,不是 YSS 选择器。 无 tiplayer { … };外观由下方方法控制。

D2D 自绘提示层,可绑定任意组件或主窗口。与组件属性「提示」(Win32 Tooltip)并存。

声明:提示层类 tips;亦可用 创建提示层()。

硬约束

  1. 方法调用必须带括号:tips.文本("…")。
  2. 绑定 填组件名(可无引号的标识符,或逗号分隔字符串);悬停锚定当前悬停目标。
  3. 显隐回调用 置显示事件 / 置隐藏事件,回调形参为无参函数;传 0 清除。
  4. 不要套用控件「硬约束与叠画」模板去绑绘制类——提示层本身即浮层。

快速开始

提示层类 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")
}