YStudio Y++

对话框（基础支持库）

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

路径：支持库 → 基础支持库 → 对话框。

硬约束

  1. 扁平命令：信息框/询问框/输入框/文件与目录选择等。
  2. 阻塞 UI，直至用户关闭对话框。

快速开始

提示框("你好")
如果 (询问框("是否继续？") == 真) {
    文本 f = 打开文件对话框("选择文件")
    输出(f)
}

对话框

本分类共 8 条。

信息框

  • 签名：整数 信息框(文本 内容, [文本 标题="信息"], [整数 按钮=0], [整数 图标=0])
  • 说明：显示自定义信息框，可指定按钮和图标。；返回：整数: 1=是/确定, 0=否, -1=取消
  • 参数一│文本 内容: 显示的消息内容
  • 参数二│[文本 标题=”信息”]: 对话框标题
  • 参数三│[整数 按钮=0]: 0/#确定 1/#确定取消 2/#中止重试忽略 3/#是否 4/#是否取消 5/#重试取消
  • 参数四│[整数 图标=0]: 0/#无图标 16/#手型 32/#警告 48/#错误 64/#信息 128/#询问

取输入框返回码

  • 签名：整数 取输入框返回码()
  • 说明：获取最后一次输入框的返回码：1表示点击了确定，0表示点击了取消。

提示框

  • 签名：无 提示框([文本 内容="Y++"])
  • 说明：显示带信息图标的提示框，用于通知用户操作结果。
  • 参数一│[文本 内容=”Y++”]: 显示内容

确认框

  • 签名：整数 确认框([文本 内容="Y++"])
  • 说明：显示确定/取消确认框，带询问图标。；返回：整数: 1=确定, -1=取消
  • 参数一│[文本 内容=”Y++”]: 显示内容

警告框

  • 签名：无 警告框([文本 内容="Y++"])
  • 说明：显示带警告图标的警告框，用于提醒用户注意事项。
  • 参数一│[文本 内容=”Y++”]: 显示内容

询问框

  • 签名：整数 询问框([文本 内容="Y++"])
  • 说明：显示是/否询问框，带询问图标。；返回：整数: 1=是, 0=否
  • 参数一│[文本 内容=”Y++”]: 显示内容

输入框

  • 签名：文本 输入框([文本 标题="输入"], [文本 提示内容=""], [文本 默认显示内容=""])
  • 说明：显示带输入框的对话框，让用户输入文本。点击确定返回输入内容，点击取消返回空文本。
  • 参数一│[文本 标题=”输入”]: 显示在输入框的标题
  • 参数二│[文本 提示内容=”“]: 解释需要输入什么内容
  • 参数三│[文本 默认显示内容=”“]: 输入框默认显示的文本

错误框

  • 签名：无 错误框([文本 内容="Y++"])
  • 说明：显示带错误图标的错误框，用于报告错误信息。
  • 参数一│[文本 内容=”Y++”]: 显示内容

文件对话框

本分类共 6 条。

保存文件对话框

  • 签名：文本 保存文件对话框([文本 标题="保存文件"], [文本 初始目录=""], [文本 筛选器="所有文件 (*.*)|*.*"], [文本 默认文件名=""], [逻辑 确认覆盖=真])
  • 说明：弹出「另存为」对话框，返回用户确认的保存路径；取消则为空文本。本命令只返回路径，不会自动写入文件内容——拿到路径后请再用写文件/写文件字节集等写入。
  • 参数一│[文本 标题=”保存文件”]: 对话框标题
  • 参数二│[文本 初始目录=”“]: 初始目录
  • 参数三│[文本 筛选器=”所有文件 (.)|.”]: 同打开文件对话框，用 | 分隔
  • 参数四│[文本 默认文件名=”“]: 预填文件名
  • 参数五│[逻辑 确认覆盖=真]: 真=目标已存在时提示覆盖

多选文件对话框

  • 签名：数组 多选文件对话框([文本 标题="选择文件"], [文本 初始目录=""], [文本 筛选器="所有文件 (*.*)|*.*"])
  • 说明：弹出可多选的打开文件对话框，返回所选文件路径数组；取消为空数组。
  • 参数一│[文本 标题=”选择文件”]: 对话框标题
  • 参数二│[文本 初始目录=”“]: 初始目录
  • 参数三│[文本 筛选器=”所有文件 (.)|.”]: 同打开文件对话框，用 | 分隔

打开文件对话框

  • 签名：文本 打开文件对话框([文本 标题="打开文件"], [文本 初始目录=""], [文本 筛选器="所有文件 (*.*)|*.*"], [整数 默认筛选索引=0])
  • 说明：弹出「打开文件」对话框，返回用户所选文件的完整路径；取消则为空文本。短时间内重复调用会复用上次结果（约 500ms 防抖，避免同一次事件链弹两次）。
  • 参数一│[文本 标题=”打开文件”]: 对话框标题
  • 参数二│[文本 初始目录=”“]: 初始浏览目录，空则由系统决定
  • 参数三│[文本 筛选器=”所有文件 (.)|.”]: 用 | 分隔说明与通配
  • 参数四│[整数 默认筛选索引=0]: 从 0 起选中第几个筛选组

选择字体对话框

  • 签名：文本 选择字体对话框([文本 初始字体名=""], [整数 初始字号=12], [文本 标题="选择字体"])
  • 说明：弹出系统字体对话框，返回所选字体名称；取消则为空文本。注意：当前实现只返回字体名，不返回字号。
  • 参数一│[文本 初始字体名=”“]: 初始选中的字体名
  • 参数二│[整数 初始字号=12]: 用于初始化对话框显示；返回值不含字号
  • 参数三│[文本 标题=”选择字体”]: 参数保留；系统 ChooseFont 对话框标题能力有限

选择目录对话框

  • 签名：文本 选择目录对话框([文本 标题="选择目录"], [文本 初始目录=""], [逻辑 显示新建按钮=真])
  • 说明：弹出选择文件夹对话框，返回所选目录路径；取消则为空文本。
  • 参数一│[文本 标题=”选择目录”]: 提示文字
  • 参数二│[文本 初始目录=”“]: 当前实现中标题/新建按钮生效；初始目录参数保留兼容
  • 参数三│[逻辑 显示新建按钮=真]: 真=显示「新建文件夹」，假则隐藏

选择颜色对话框

  • 签名：整数 选择颜色对话框([整数 初始颜色=0xFFFFFF])
  • 说明：弹出系统颜色对话框，返回所选 RGB 颜色值；取消返回 -1。
  • 参数一│[整数 初始颜色=0xFFFFFF]: 初始 RGB，可用颜色常量如 #红色

易错对照

错误 正确
在定时器/热键里狂弹框 会卡住交互
返回值当路径必有 取消时常为空文本

相关

剪贴板 · 文件操作