YStudio Y++

提示层类

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

类对象支持库（不是扁平命令）。路径：支持库 → 扩展类库 → 提示层类。

类型名必须写完整「提示层类」。声明时自动创建，一般无需再调 创建*。

硬约束

  1. 类型名必须写「提示层类」。
  2. 绑定目标组件后显示悬浮提示；样式/动画以方法为准。

快速开始

提示层类 tip
tip.绑定(按钮1)
tip.置内容("点这里")
tip.显示()

提示层类/创建

共 1 条。

创建提示层

  • 签名：通用 创建提示层()
  • 说明：显式创建一个提示层（一般直接写「提示层类 tips」即可，声明时自动创建）。

提示层类/方法

共 22 条。

绑定

  • 签名：无 绑定(组件名 目标名, ...)
  • 说明：绑定组件名或「主窗口」。直接写设计器中的组件名，无需引号；多目标写 绑定(按钮1, 编辑框1)；悬停任一目标显示。
  • 参数一│组件名 目标名: 如 按钮1 或 主窗口。
  • 参数二│…: 更多目标（可选）。

文本

  • 签名：无 文本([文本 内容=""])
  • 说明：设置提示层显示的文本。
  • 参数一│[文本 内容=”“]: 提示文字，省略则清空。

类型

  • 签名：无 类型([整数 样式=1])
  • 说明：设置提示层样式：1=普通提示层，2=气泡（带三角指针），3=浮层角标，4=脉冲角标（Hot）。
  • 参数一│[整数 样式=1]: 1 普通 2 气泡 3 浮层 4 脉冲。

动画

  • 签名：无 动画([整数 预设=0])
  • 说明：参数一│[整数 预设=0]: 0~67，见说明。

浮层模式

  • 签名：无 浮层模式([整数 模式=1])
  • 说明：浮层（类型 3）显示模式：1=悬停显示，2=常驻角标。
  • 参数一│[整数 模式=1]: 1 悬停显示 2 常驻角标。

背景色

  • 签名：无 背景色([文本 颜色="#333333"])
  • 说明：设置提示层背景色（#RGB / #ARGB）。
  • 参数一│[文本 颜色=”#333333”]: 如 “#333333” 或 “#FF333333”。

文字色

  • 签名：无 文字色([文本 颜色="#FFFFFF"])
  • 说明：设置提示层文字颜色。
  • 参数一│[文本 颜色=”#FFFFFF”]: 如 “#FFFFFF”。

圆角

  • 签名：无 圆角([整数 半径=8])
  • 说明：设置提示层圆角半径（像素）。
  • 参数一│[整数 半径=8]: 圆角像素。

最大宽度

  • 签名：无 最大宽度([整数 宽度=280])
  • 说明：设置普通/气泡提示的最大文本宽度。
  • 参数一│[整数 宽度=280]: 像素宽度。

偏移

  • 签名：无 偏移([整数 X=0], [整数 Y=0])
  • 说明：相对绑定目标的显示偏移（像素）。
  • 参数一│[整数 X=0]: 水平偏移。
  • 参数二│[整数 Y=0]: 垂直偏移。

显示延迟

  • 签名：无 显示延迟([整数 毫秒=300])
  • 说明：悬停后延迟多少毫秒再显示（默认 300）。
  • 参数一│[整数 毫秒=300]: 显示延迟。

隐藏延迟

  • 签名：无 隐藏延迟([整数 毫秒=100])
  • 说明：离开目标后延迟多少毫秒再隐藏（默认 100）。
  • 参数一│[整数 毫秒=100]: 隐藏延迟。

方位

  • 签名：无 方位([整数 方向=-1])
  • 说明：弹出方位：-1=自动（默认，锚定鼠标位置并优先显示在鼠标下方，放不下时自动翻转避让）；1上 2下 3左 4右（手动指定，气泡箭头随之切换）。
  • 参数一│[整数 方向=-1]: -1自动，或 1上 2下 3左 4右。

字号

  • 签名：无 字号([整数 像素=12])
  • 说明：设置提示层文字字号（像素）。
  • 参数一│[整数 像素=12]: 字号，最小 6。

内边距

  • 签名：无 内边距([整数 水平=12], [整数 垂直=8])
  • 说明：设置普通/气泡提示的内边距（像素）。
  • 参数一│[整数 水平=12]: 左右内边距。
  • 参数二│[整数 垂直=8]: 上下内边距。

图标

  • 签名：无 图标([文本 路径=""])
  • 说明：在提示文字左侧显示图标（支持 :/ 资源路径或文件路径）。
  • 参数一│[文本 路径=”“]: 如图 “img/ok.png” 或 “:/img/ok.png”。

可关闭

  • 签名：无 可关闭([整数 开关=1])
  • 说明：是否显示右上角关闭按钮；点击后隐藏提示层。
  • 参数一│[整数 开关=1]: 1 显示关闭钮，0 隐藏。

主题

  • 签名：无 主题([整数 编号=0])
  • 说明：快速套用配色：0默认 1暗色 2亮色 3成功 4警告 5危险 6信息。
  • 参数一│[整数 编号=0]: 主题编号。

显示

  • 签名：无 显示()
  • 说明：立即显示提示层（不受悬停延迟影响）。

隐藏

  • 签名：无 隐藏()
  • 说明：立即隐藏提示层。

置显示事件

  • 签名：无 置显示事件([子程序指针 回调])
  • 说明：提示层变为显示时调用无参回调。
  • 参数一│[子程序指针 回调]: 如 &提示已显示；传 0 清除。

置隐藏事件

  • 签名：无 置隐藏事件([子程序指针 回调])
  • 说明：提示层变为隐藏时调用无参回调。
  • 参数一│[子程序指针 回调]: 如 &提示已隐藏；传 0 清除。

易错对照

错误 正确
类型写成「提示层」 必须「提示层类」

相关

动画类 · 通知类