选择文件
弹出系统文件对话框,让用户选一个(或多个)要打开的文件,或指定保存位置。要选文件夹,用 选择文件夹。
当前模块定义
sys:selectFile输入 8 · 输出 3 · 枚举 1
输入参数
- 操作类型
typeEnum必填打开文件:选择一个已存在的文件。保存文件:选择文件要保存的目标位置。
打开单个文件默认openFile打开多个文件openMultiFile保存文件saveFile - 文件类型筛选器
filterText可选文件类型筛选器,格式为:类型1|扩展名1|类型2|扩展名2。如:文本文件(*.txt)|*.txt|C#文件|*.cs|所有文件|*.*
- 默认扩展名
defaultExtText可选默认的文件扩展名,应该是筛选器里的一种
- 初始文件名
initFileNameText可选预选选择或设置的文件名
- 初始路径
initDirText可选初始文件夹路径
- 对话框标题
titleText可选选择窗口的标题
- 置顶显示
topMostBoolean可选是否置置顶显示窗口。
- 失败后停止
stopIfFailBoolean可选失败后是否停止动作
输出参数
- 是否成功
isSuccessBoolean是否成功选择了路径。
- 路径
pathText选择的文件路径。
- 路径列表
pathListList选择的文件路径列表。
概述
0.12.3 起提供。三种操作类型对应不同的对话框和输出。
选择文件
用文件选择对话框选择要打开或保存的文件
参数说明
操作类型:
- 打开单个文件:打开文件对话框,输出一条路径(文本)。
- 打开多个文件:可多选,输出路径列表。
- 保存文件:保存文件对话框,输出要写入的路径。
文件类型筛选器:限定可选类型。格式为 类型1|扩展名1|类型2|扩展名2。多种扩展名用分号:图片文件|*.jpg;*.png;*.bmp;*.gif。默认 文本文件|*.txt|所有文件|*.*。
默认扩展名:对话框预选的扩展名,应是筛选器里的一种,如 .txt。
初始文件名:预先填进文件名框,可留空。
初始路径:对话框打开时的文件夹,可留空。
对话框标题:窗口标题,可留空。
置顶显示:对话框是否总在最前。默认开启。
失败后停止:用户点取消后是否中止动作。默认开启。
输出
- 是否成功:是否选了文件。取消则为 False。若未输出到变量且用户取消,动作会停止。
- 路径:单个文件路径。仅「打开单个文件」「保存文件」。
- 路径列表:多条路径。仅「打开多个文件」。
相关链接
更新于