主要内容

uigetfile

打开文件选择对话框

描述

文件= uigetfile打开一个模态对话框,列出当前文件夹中的文件。它允许用户选择或输入文件的名称。如果文件存在且有效,uigetfile返回用户单击时的文件名开放。如果用户单击取消或窗口关闭按钮(X),uigetfile返回0

文件路径] = uigetfile当用户单击时,返回文件的文件名和路径开放。如果用户单击取消或窗口关闭按钮(X),则uigetfile返回0对于这两个输出参数。

例子

文件路径indx] = uigetfile返回用户单击时在对话框中选择的筛选器的索引开放

例子

___=uigetfile(滤器指定筛选对话框中显示的文件的文件扩展名。将此语法与前面语法中的任何输出参数组合一起使用。

通常,只显示具有匹配文件扩展名的文件。在一些平台上,uigetfile显示不匹配过滤器的文件,但将那些文件名调暗。如果过滤器缺失或为空,uigetfile使用文件类型的默认列表(例如,所有®文件)。

例子

___=uigetfile(滤器标题指定对话框标题。若要使用默认文件筛选器进行筛选,但要指定自定义标题,请为筛选器值使用空引号。例如:

file = uigetfile(",'Select a file ')

例子

___=uigetfile(滤器标题defname指定文件的默认文件名文件名字段或对话框打开到的默认文件夹。

例子

___=uigetfile(___“多选”,模式指定用户是否可以选择多个文件。将模式设置为“上”启用多文件选择。默认设置为“关”

窗户®库可以跨越多个文件夹。

请注意

对话框的视觉特征取决于运行代码的操作系统。例如,一些操作系统不显示对话框上的标题栏。如果将对话框标题传递给uigetfile函数,这些操作系统不会显示标题。

例子

全部折叠

显示对话框中所选文件的完整文件规格。使用disp完整文件函数来添加解释性文本并连接路径文件输出值。

(文件,路径)= uigetfile (“* m”);如果isequal(文件,0)disp (“用户选择取消”);其他的disp([用户选择的fullfile(路径、文件)]);结束

文件选择对话框。可见文件是.m文件和文件过滤器下拉列表读取(*.m)。

用户选择H: \ \ MyCode \ surf.m文档

在命令窗口中显示带有解释性文本的筛选器索引选择。使用num2str函数转换数值过滤器索引值(indx)到字符数组。这样做会使值成为对disp函数。

[file,path,indx]=uigetfile;如果isequal(文件,0)disp (“用户选择取消”其他的disp([用户选择的fullfile(路径,文件),...'和过滤索引:',num2str(indx)])结束

“文件选择”对话框。该对话框显示具有各种扩展名的文件,“文件筛选器”下拉列表包含扩展名类型。

用户选择H: \ MyCode \ \文件峰值。图和滤波指标:3

仅显示带有.m在对话框中指定' *。米的随着滤器输入参数。

(文件,路径)= uigetfile (“* m”);

文件选择对话框。可见文件是.m文件和文件过滤器下拉列表读取(*.m)。

在文件过滤器下拉列表中创建文件扩展名列表。通过滤器将参数作为字符向量的单元格数组输入,并用分号分隔文件扩展名。

(文件,路径)= uigetfile ({“* m”‘* .slx‘‘* .mat‘“* *”。},...的文件选择器);

文件选择对话框。文件筛选器下拉菜单为每个指定的文件扩展名提供了一个选项,并且选择了(*.m)。可见文件是.m文件。

创建文件扩展名列表,并通过传递滤器输入参数作为字符向量的单元格数组。单元格数组的第一列包含文件扩展名,第二列包含文件类型的自定义描述。这个示例还将多个文件类型关联到“MATLAB文件”“模型”描述。

[file,path,indx]=uigetfile(...“*.m;*.mlx;*.fig;*.mat;*.slx;*.mdl”...的MATLAB文件(* . m * .mlx, * .fig, * .mat, * .slx, * . mdl)”“*.m;*.mlx”的代码文件(* . m, * .mlx)”...“*”图“数据(* .fig)”...‘* .mat‘'MAT文件(*.MAT)'...‘* . mdl; * .slx'型号(*.slx,*.mdl)'...“* *”。所有文件(* . *)”},...“选择文件”);

文件选择对话框。文件过滤器下拉列表列出了指定的文件过滤器描述。可见文件为.m和.fig文件。

中显示默认文件名文件名字段时,将文件名作为defname输入参数

(文件,路径)= uigetfile (‘* . png”...'选择图标文件'“程序”

文件选择对话框。对话框的标题为“选择图标文件”,默认文件名为“图标.png”。可见文件是.png文件。

中显示默认路径和文件名文件名字段当对话框打开时,将完整文件名作为滤器输入参数。

(文件,路径)= uigetfile ('C:\Documents\Work\icon.png'...'选择图像文件'

文件选择对话框。对话框的标题为“选择图像文件”。对话框打开到C:\Documents\Work文件夹,默认文件名为icon.png。可见文件是.png文件。

通过传递滤器输入参数作为字符向量的单元格数组。指定对话框打开到的文件夹。

(文件,路径)= uigetfile ({‘* . png”“* m”},...“选择一个文件”“文件C: \ \ AppBuildingFiles \”

文件选择对话框。对话框的标题为“选择文件”。对话框打开到C:\Documents\AppBuildingFiles文件夹,文件过滤器下拉菜单包含。png和。m过滤器。

通过设置来启用多文件选择“多选”选择“上”.用户可以通过按住键选择多个文件转变Ctrl键入并单击文件名。

(文件,路径)= uigetfile (“* m”...'选择一个或多个文件'...“多选”“上”);

“文件选择”对话框。该对话框的标题为“选择一个或多个文件”。对话框中的多个文件被选中。

输入参数

全部折叠

文件筛选器,指定为字符向量、字符向量单元格数组或字符串数组。下表列出了可以传递给的输入类型滤器参数和对话框的相应行为。

输入 行为 例子
文件名

文件名称出现在文件名对话框的字段。文件的扩展名是默认筛选器值。

如果文件名包含路径,对话框将打开到指定的文件夹。否则,它将打开到当前文件夹。如果指定的文件夹不存在,则uigetfile将对话框打开到当前文件夹。

  • “程序”

  • “C: \ \程序文件”

  • “. . \程序”

文件夹

该对话框显示文件夹的内容文件名字段为空,且不应用筛选器。的最后一个字符,以指定文件夹名称滤器必须是反斜杠()还是一条斜线(/).

如果指定的文件夹不存在,则uigetfile将对话框打开到当前文件夹。

  • 'C:\Documents'

文件扩展名的过滤器

该对话框仅显示具有匹配文件扩展名的文件。

要允许用户在多个筛选器之间进行选择,请为每个筛选器指定一个单元格数组或字符串数组,并为每个筛选器指定一个项目。筛选器显示在对话框的“筛选器字段”下拉菜单中。

要创建具有多个文件扩展名的筛选器,请在单个字符向量或字符串中指定扩展名,用分号分隔().

  • “* m”

  • {* m”;“* .mlx”}

  • {'*.m;*.mlx';'*.png;*.jpeg'}

带有描述的文件扩展名过滤器

对话框将在筛选字段中显示扩展名及其描述。用户可以选择过滤器。

要显示过滤器描述,请在单元格数组或字符串数组中指定两列。第一列包含文件扩展名列表。第二列包含相应的描述列表。这些描述替换过滤器字段中的标准描述。描述不能为空。

  • {* 00; *。mlx”、“代码文件';' * . png; * jpeg”、“图像文件”}。

如果文件过滤器包含一个路径,该路径可以包含以下字符:

  • ..

  • /

例如“../*.m”列出所有带有.m在当前文件夹上方的文件夹中扩展。

请注意

如果您或用户包含星号()或问号(),则uigetfile对点击没有反应开放.对话框将保持打开状态,直到用户单击取消或从名称中删除通配符。这个限制适用于所有平台,甚至适用于允许在文件名中使用这些字符的文件系统。

对话框标题,指定为字符向量。

例子:“选择文件”

默认的文件名字段值,指定为字符向量或字符串标量。的defname值可以指定路径,也可以指定路径和文件名。

  • 如果指定路径,可以包含以下字符:

    • ..

    • /

  • 若要仅指定文件夹名,请使用defname值可以是反斜杠()还是一条斜线(/).

例子:“myfile.mat”

例子:'C:\Documents\my\u MATLAB\u文件'

例子:“..\myfile.mat”

例子:“. . \ \文件”

多选择模式,指定为“上”“关”.如果关闭多选模式,则用户只能选择一个文件。如果开启多选模式,则用户可以选择多个文件。如果用户选择了多个文件,那么它们必须在同一个文件夹中;否则MATLAB会显示一个警告对话框。微软®Windows库可以跨多个文件夹。

输出参数

全部折叠

用户在对话框中指定的文件名,作为字符向量或字符向量的单元格数组返回。

时返回字符向量的单元格数组“多选”设置为“上”用户选择多个文件。每个数组元素包含所选文件的名称。单元格数组中的文件名按用户平台使用的顺序排序。如果用户选择多个文件,则它们必须位于同一文件夹中,否则MATLAB将显示警告对话框。

如果用户单击取消按钮或窗口关闭按钮(X),然后MATLAB将文件值返回为0

指定文件的路径,作为字符向量返回。

如果用户单击取消按钮或窗口关闭按钮(X),然后MATLAB将文件值返回为0

选定的筛选器索引,以整数形式返回。

控件右侧的未标记对话框控件文件名字段。过滤器索引值对应于过滤器下拉列表中选择的项目。第一行的下标是1。

如果用户单击取消按钮或窗口关闭按钮(X),然后MATLAB返回索引值0

更多关于

全部折叠

模态对话框

模态对话框阻止用户在响应对话框之前与其他MATLAB窗口进行交互。

提示

  • 使用的路径和文件名uigetfile返回使用MATLAB和MATLAB工具箱中的各种输入和输出函数打开、读取或分析文件。例如:此处列出。

    • imread用于读取图像。

    • xlsread用于读取Microsoft Excel文件。

    • 开放编辑,或运行用MATLAB代码文件。例如,这段代码创建一个对话框,从用户那里获取MATLAB代码文件名,从返回值构建完整的文件名,然后运行用户指定的代码文件。

      (文件,路径)= uigetfile(“* m”);selectedfile = fullfile(路径、文件);运行(selectedfile);

选择功能

使用dir函数返回当前文件夹或指定文件夹中已筛选或未筛选的文件列表。的dir函数也可以返回文件属性。

另请参阅

||

之前介绍过的R2006a