YStudio Y++

界面支持库

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

路径：支持库 → 界面支持库。

硬约束

  1. 扁平命令；用设计器组件名称（文本）操作控件。
  2. 组件名须与窗口 XML「名称」一致。
  3. 置组件可见：1=显示，0=隐藏（兼容真/假）。
  4. 消息条贴窗顶/底，与浮动 Toast「成功通知」不同。
  5. 时长 -1 表示使用默认/不自动关（以实现为准）；0 常表示常驻。

快速开始

置组件文本(标签1, "你好")
置组件可见(按钮_高级, 0)
成功消息条("已提交")
显示消息条("请检查输入", 2, 3000)

组件文本

本分类共 2 条。

取组件文本

  • 签名：文本 取组件文本(文本 组件名)
  • 说明：读取窗口上指定组件当前显示的文本。
  • 参数一│文本 组件名: 设计器中的名称，如 文本框1、标签1、按钮_确认

置组件文本

  • 签名：无 置组件文本(文本 组件名, [通用 内容=""])
  • 说明：修改指定组件上显示的文字。
  • 参数一│文本 组件名: 设计器中的名称
  • 参数二│[通用 内容=”“]: 文本或任意可转文本的表达式，省略则清空

组件状态

本分类共 4 条。

取组件可用

  • 签名：逻辑 取组件可用(文本 组件名)
  • 说明：读取指定组件当前是否可用（可交互）。
  • 参数一│文本 组件名: 设计器中的名称

取组件可见

  • 签名：逻辑 取组件可见(文本 组件名)
  • 说明：读取指定组件当前是否显示。
  • 参数一│文本 组件名: 设计器中的名称

置组件可用

  • 签名：无 置组件可用(文本 组件名, [整数 状态=1])
  • 说明：启用或禁用指定组件。
  • 参数一│文本 组件名: 设计器中的名称
  • 参数二│[整数 状态=1]: 1=可用，0=禁用；兼容 真/假

置组件可见

  • 签名：无 置组件可见(文本 组件名, [整数 状态=1])
  • 说明：显示或隐藏指定组件。
  • 参数一│文本 组件名: 设计器中的名称
  • 参数二│[整数 状态=1]: 1=显示，0=隐藏；兼容 真/假

消息条

本分类共 16 条。

信息消息条

  • 签名：无 信息消息条(文本 内容, [整数 时长=-1], [整数 位置=-1], [整数 样式=-1])
  • 说明：信息级别消息条。
  • 参数一│文本 内容
  • 参数二│[整数 时长=-1]
  • 参数三│[整数 位置=-1]
  • 参数四│[整数 样式=-1]

取消息条可见

  • 签名：逻辑 取消息条可见()
  • 说明：返回当前窗口消息条是否正在显示。
  • 参数│无（仍须写括号）

取消息条级别

  • 签名：整数 取消息条级别()
  • 说明：返回当前消息条级别（0~3）。
  • 参数│无（仍须写括号）

成功消息条

  • 签名：无 成功消息条(文本 内容, [整数 时长=-1], [整数 位置=-1], [整数 样式=-1])
  • 说明：成功级别消息条。
  • 参数一│文本 内容
  • 参数二│[整数 时长=-1]
  • 参数三│[整数 位置=-1]
  • 参数四│[整数 样式=-1]

显示消息条

  • 签名：无 显示消息条(文本 内容, [整数 级别=0], [整数 时长=-1], [整数 位置=-1], [整数 样式=-1], [文本 标题=""])
  • 说明：在当前窗口显示顶/底横条提示（无需拖入组件）。
  • 参数一│文本 内容: 正文
  • 参数二│[整数 级别=0]: 0信息 1成功 2警告 3错误
  • 参数三│[整数 时长=-1]: 毫秒；-1=默认(3000)；0=常驻
  • 参数四│[整数 位置=-1]: %1
  • 参数五│[整数 样式=-1]: %1
  • 参数六│[文本 标题=”“]: 可选标题，与正文并排

置消息条位置

  • 签名：无 置消息条位置(整数 位置)
  • 说明：设置后续显示默认位置：0顶 1底。
  • 参数一│整数 位置: 0顶 1底

置消息条可关闭

  • 签名：无 置消息条可关闭(逻辑 可关闭)
  • 说明：后续显示是否带关闭按钮。
  • 参数一│逻辑 可关闭

置消息条图标

  • 签名：无 置消息条图标(逻辑 显示)
  • 说明：后续显示是否画级别图标。
  • 参数一│逻辑 显示

置消息条圆角

  • 签名：无 置消息条圆角(整数 像素)
  • 说明：后续显示圆角；-1=按样式默认。
  • 参数一│整数 像素

置消息条时长

  • 签名：无 置消息条时长(整数 毫秒)
  • 说明：后续显示默认自动关闭时长；-1=3000；0=常驻。
  • 参数一│整数 毫秒

置消息条栏高

  • 签名：无 置消息条栏高(整数 像素)
  • 说明：后续显示栏高；0=按样式默认。
  • 参数一│整数 像素

置消息条样式

  • 签名：无 置消息条样式(整数 样式)
  • 说明：设置后续显示默认样式。%1
  • 参数一│整数 样式: 0~7

置消息条颜色

  • 签名：无 置消息条颜色(文本 背景, 文本 文字, 文本 强调)
  • 说明：覆盖级别默认色；某通道传空文本则该通道恢复级别色。
  • 参数一│文本 背景: 如 #1C2430，空=恢复
  • 参数二│文本 文字
  • 参数三│文本 强调

警告消息条

  • 签名：无 警告消息条(文本 内容, [整数 时长=-1], [整数 位置=-1], [整数 样式=-1])
  • 说明：警告级别消息条。
  • 参数一│文本 内容
  • 参数二│[整数 时长=-1]
  • 参数三│[整数 位置=-1]
  • 参数四│[整数 样式=-1]

错误消息条

  • 签名：无 错误消息条(文本 内容, [整数 时长=-1], [整数 位置=-1], [整数 样式=-1])
  • 说明：错误级别消息条。
  • 参数一│文本 内容
  • 参数二│[整数 时长=-1]
  • 参数三│[整数 位置=-1]
  • 参数四│[整数 样式=-1]

隐藏消息条

  • 签名：无 隐藏消息条()
  • 说明：隐藏当前窗口上的消息条。
  • 参数│无（仍须写括号）

多窗口

本分类共 2 条。

关闭

  • 签名：无 关闭(组件名 窗口名)
  • 说明：关闭已载入的窗口。窗口名直接写，无需引号；主窗口则结束程序窗口。
  • 参数一│组件名 窗口名: 工程「窗口」下的窗体名，如 窗口1（不加双引号）

载入

  • 签名：逻辑 载入(组件名 窗口名, [逻辑 模态=假])
  • 说明：载入并显示工程中的另一个窗口。窗口名直接写，无需引号。
  • 参数一│组件名 窗口名: 工程「窗口」下的窗体名，如 窗口1（不加双引号）
  • 参数二│[逻辑 模态=假]: 真=只能操作本窗，关闭后才能操作其它窗；假=可与其它窗并行

事件

本分类共 2 条。

取消

  • 签名：无 取消()
  • 说明：在可取消事件处理中拦截本次操作（如「颜色将改变」「值将改变」）。亦可写 取消事件()。
  • 参数│无（仍须写括号）

取消事件

  • 签名：无 取消事件()
  • 说明：同「取消()」：拦截当前可取消 UI 事件。
  • 参数│无（仍须写括号）

易错对照

错误 正确
组件名写错 与设计器「名称」完全一致
消息条当模态框 非阻塞；模态用对话框库
与通知类混淆 应用内条用本库；系统通知见 notify-obj

相关

窗体 XML · 对话框 · 通知类 · YSS