# uigetfile
打开文件选择对话框
函数库: TyAppDesigner
# 语法
file = uigetfile()
file = uigetfile(filter)
file = uigetfile(filter,title)
file = uigetfile(filter,title,defname)
注意
如果该函数不是在 APP 设计工具中使用，需要 using TyAppDesigner 。
# 说明
file = uigetfile() 打开一个模态对话框，其中列出了当前文件夹中的文件。用户可以在这里选择或输入文件的名称。如果文件存在并且有效，当用户单击打开时，uigetfile 将返回文件完整路径。如果用户单击取消或窗口关闭按钮 (X)，uigetfile() 将返回空字符串 ""。示例
file = uigetfile(filter) 指定文件扩展名，根据该扩展名筛选对话框中显示的文件。示例
file = uigetfile(filter,title) 指定对话框标题。要使用默认文件筛选器进行筛选，但指定自定义标题，请使用空引号作为筛选器值。例如：
file = uigetfile("","Select a File")。
file = uigetfile(filter,title,defname) 为文件名字段指定默认文件名。示例
# 示例
显示完整文件路径
显示在对话框中选择的文件的完整文件路径。
file = uigetfile("*.jl");
"d:\\Program Files\\MWORKS\\Syslab 2025a\\Examples\\01 快速入门\\04 cylinder_data.jl"
指定默认文件名
要在对话框打开时在文件名字段中显示一个默认的文件名，请将此文件名作为 defname 输入参数进行传递。
file = uigetfile("*.jl","Select a jl file","04 cylinder_data.jl");
"d:\\Program Files\\MWORKS\\Syslab 2025a\\Examples\\01 快速入门\\04 cylinder_data.jl"
指定默认路径和文件
要在对话框打开时在文件名字段中显示默认路径下的默认文件名，请将完整文件名作为 filter 输入参数进行传递。
file = uigetfile(raw"d:\Program Files\MWORKS\Syslab 2025a\Examples\03 数据导入和分析\01 文本文件\outages.csv","Select a csv File");
"d:\\Program Files\\MWORKS\\Syslab 2025a\\Examples\\03 数据导入和分析\\01 文本文件\\outages.csv"
# 输入参数
filter - 文件筛选器字符串 | 字符串数组
文件筛选器，指定为字符串或字符串数组。
如果 filter 是文件名，该文件名将出现在文件名字段中。该文件的扩展名即为默认筛选器值。
filter 可以包含路径。该路径可以包含以下字符：
- .
- ..
- \
- /
例如，"../*.jl" 列出位于当前文件夹上一级文件夹中具有 .jl 扩展名的所有代码文件。
如果指定的路径不存在，uigetfile 将在当前文件夹中打开对话框。
示例： "myfile.jl"
示例： "../myfile.jl"
示例： "../.."
title - 对话框标题"选择要打开的文件" （默认） | 字符串
对话框标题，指定为字符串。
示例： "Select a File"
defname - “文件名”字段的默认值"" （默认） | 字符串
文件名字段的默认值，指定为字符串。defname 值可以指定路径，也可以指定路径加文件名。
如果指定路径，则可以包含以下字符：
- .
- ..
- \
- /
示例： "myfile.jl"
示例： "C:/Users"
示例： "../myfile.jl"
示例： "../Documents"
# 输出参数
file - 文件名字符串
用户在对话框中指定的文件名，以字符串方式返回。 如果用户单击取消按钮或窗口关闭按钮 (X)，将返回空字符串""。