YStudio Y++

对话框（基础支持库）

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

扁平命令式支持库（不是类）。路径：支持库 → 基础支持库 → 对话框 / 文件对话框。

硬约束

  1. 扁平命令，阻塞至用户关闭对话框。
  2. 信息框 返回整数：常见 1=是/确定，0=否，-1=取消（随按钮组合变化）。
  3. 确认框：1=确定，-1=取消；询问框：1=是，0=否。
  4. 输入框 取消返回空文本；用 取输入框返回码 区分确定(1)/取消(0)。
  5. 文件对话框取消：单路径命令返回空文本；多选文件对话框 返回空数组。
  6. 选择颜色对话框 取消返回 -1（不是 0）。

快速开始

整数 r = 信息框("要保存吗？", "退出", #是否取消, #询问)
如果 (r == 1) {
    文本 路径 = 保存文件对话框("保存", "", "文本 (*.txt)|*.txt|所有文件 (*.*)|*.*")
    如果 (路径 != "") {
        写文件(路径, "内容")
        提示框("已保存")
    }
} 否则如果 (r == -1) {
    输出("用户取消")
}
文本 名 = 输入框("名称", "请输入昵称", "访客")
如果 (取输入框返回码() == 1) {
    输出("你好, " + 名)
}

对话框

本分类共 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++”]: 提示框正文；可省略用默认

文件对话框

本分类共 7 条。

保存文件对话框

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

多选文件对话框

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

打开文件对话框

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

选择字体对话框

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

选择目录对话框

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

选择颜色对话框

  • 签名：整数 选择颜色对话框([整数 初始颜色=0xFFFFFF])
  • 说明：弹出系统颜色对话框，返回所选 RGB 颜色值；取消返回 -1。
  • 参数一│[整数 初始颜色=0xFFFFFF]: 与返回值相同：低 8 位红、中 8 位绿、高 8 位蓝；红=255

颜色值_到文本

  • 签名：文本 颜色值_到文本(整数 颜色值)
  • 说明：把「选择颜色对话框」返回的整数转为 “#RRGGBB” 文本，可直接赋给 背景色 / 当前颜色。取消值 -1 返回空文本。
  • 参数一│整数 颜色值: 选择颜色对话框的返回值（低 8 位红、中绿、高蓝）

易错对照

错误 正确
输入框取消当有内容 取消返回空；务必看 取输入框返回码
颜色取消当 0 取消是 -1
信息框返回值当布尔 按 1/0/-1 分支，不要直接当真假混用取消
筛选器格式写错 用 | 分隔：说明 (*.ext)|*.ext|…

相关

文件操作 · 窗口操作 · 系统操作