跳到主要内容

选择文件

弹出系统文件对话框,让用户选一个(或多个)要打开的文件,或指定保存位置。要选文件夹,用 选择文件夹

当前模块定义

sys:selectFile界面组件Action
标准模块
输入 8 · 输出 3 · 枚举 1

输入参数

  • 操作类型typeEnum必填

    打开文件:选择一个已存在的文件。保存文件:选择文件要保存的目标位置。

    填写 固定输入默认 openFile
    打开单个文件默认openFile
    打开多个文件openMultiFile
    保存文件saveFile
  • 文件类型筛选器filterText可选

    文件类型筛选器,格式为:类型1|扩展名1|类型2|扩展名2。如:文本文件(*.txt)|*.txt|C#文件|*.cs|所有文件|*.*

    填写 输入或变量默认 文本文件|*.txt|所有文件|*.*
  • 默认扩展名defaultExtText可选

    默认的文件扩展名,应该是筛选器里的一种

    填写 输入或变量默认 .txt
  • 初始文件名initFileNameText可选

    预选选择或设置的文件名

    填写 输入或变量
  • 初始路径initDirText可选

    初始文件夹路径

    填写 输入或变量
  • 对话框标题titleText可选

    选择窗口的标题

    填写 输入或变量
  • 置顶显示topMostBoolean可选

    是否置置顶显示窗口。

    填写 固定输入默认 true
  • 失败后停止stopIfFailBoolean可选

    失败后是否停止动作

    填写 固定输入默认 true

输出参数

  • 是否成功isSuccessBoolean

    是否成功选择了路径。

  • 路径pathText

    选择的文件路径。

    条件 仅:openFile, saveFile
  • 路径列表pathListList

    选择的文件路径列表。

    条件 仅:openMultiFile

概述

0.12.3 起提供。三种操作类型对应不同的对话框和输出。

选择文件

用文件选择对话框选择要打开或保存的文件
操作类型
打开文件:选择一个已存在的文件。保存文件:选择文件要保存的目标位置。
文件类型筛选器
文本文件|*.txt|所有文件|*.*
文件类型筛选器,格式为:类型1|扩展名1|类型2|扩展名2。如:文本文件(*.txt)|*.txt|C#文件|*.cs|所有文件|*.*
默认扩展名
.txt
默认的文件扩展名,应该是筛选器里的一种
初始文件名
 
预选选择或设置的文件名
初始路径
 
初始文件夹路径
对话框标题
 
选择窗口的标题
是否成功
-- 选择变量 --
是否成功选择了路径。
路径
-- 选择变量 --
选择的文件路径。

参数说明

操作类型

  • 打开单个文件:打开文件对话框,输出一条路径(文本)。
  • 打开多个文件:可多选,输出路径列表。
  • 保存文件:保存文件对话框,输出要写入的路径。

文件类型筛选器:限定可选类型。格式为 类型1|扩展名1|类型2|扩展名2。多种扩展名用分号:图片文件|*.jpg;*.png;*.bmp;*.gif。默认 文本文件|*.txt|所有文件|*.*

默认扩展名:对话框预选的扩展名,应是筛选器里的一种,如 .txt

初始文件名:预先填进文件名框,可留空。

初始路径:对话框打开时的文件夹,可留空。

对话框标题:窗口标题,可留空。

置顶显示:对话框是否总在最前。默认开启。

失败后停止:用户点取消后是否中止动作。默认开启。

输出

  • 是否成功:是否选了文件。取消则为 False。若未输出到变量且用户取消,动作会停止。
  • 路径:单个文件路径。仅「打开单个文件」「保存文件」。
  • 路径列表:多条路径。仅「打开多个文件」。

相关链接

更新于