主要内容

uigetfile

打开文件选择对话框

折叠所有页面

语法

文件= uigetfile
[file,path] = uigetfile
[file,path,indx] = uigetfile .[文件，路径，indx] = uigetfile .
___= uigetfile(过滤器)
___= uigetfile(过滤器、标题)
___= uigetfile(过滤器、标题、defname)
___= uigetfile (___、“多选”模式)

描述

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

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

例子

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

例子

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

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

例子

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

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

例子

___= uigetfile (过滤器，标题，defname）属性的默认文件名文件名称字段或对话框打开到的默认文件夹。

例子

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

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

请注意

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

例子

全部折叠

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

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

文件选择对话框。可见的文件是.m文件，文件筛选器下拉读取(*.m)。

用户选择H:\Documents\MyCode\surf.m

在命令窗口中显示带有解释性文本的筛选器索引选择。使用num2str函数转换数值筛选器索引值(indx)到字符数组。方法的有效输入disp函数。

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

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

用户选择H:\Documents\MyCode\peaks。图及滤波指数:3

只显示带有．m在对话框中指定扩展' *。米的随着过滤器输入参数。

[file,path] = uigetfile(“* m”）;

文件选择对话框。可见的文件是.m文件，文件筛选器下拉读取(*.m)。

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

[file,path] = uigetfile({“* m”；‘* .slx‘；‘* .mat‘；“* *”。}，.．.的文件选择器）;

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

创建文件扩展名列表，并通过传入过滤器输入参数作为字符向量的单元格数组。单元格数组的第一列包含文件扩展名，第二列包含文件类型的自定义描述。属性关联多种文件类型“MATLAB文件”而且“模型”描述。

[file,path,indx] = uigetfile(.．.｛‘* 00;* .mlx; * .fig; * .mat; * .slx; * . mdl’，.．.的MATLAB文件(* . m * .mlx, * .fig, * .mat, * .slx, * . mdl)”；“* 00;* .mlx”，代码文件(*.m，*.mlx)；.．.‘* .fig‘，“数据(* .fig)”；.．.‘* .mat‘，“mat文件(* .mat)”；.．.‘* . mdl; * .slx，”模型(*。基金,* . mdl)”；.．.“* *”。，“所有文件(*.*)”}，.．.“选择文件”）;

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

方法中显示默认文件名文件名称字段时，将文件名作为defname输入参数

[file,path] = uigetfile(‘* . png”，.．.“选择图标文件”，“程序”）

文件选择对话框。说明对话框的标题为“选择图标文件”，默认文件名为“icon.png”。可见文件为。png格式。

方法中显示默认路径和文件名文件名称字段时，将完整文件名作为过滤器输入参数。

[file,path] = uigetfile(“文件C: \ \ \程序工作”，.．.“选择一个图像文件”）

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

参数创建文件扩展名列表过滤器输入参数作为字符向量的单元格数组。指定打开对话框的文件夹。

[file,path] = uigetfile({‘* . png”；“* m”}，.．.“选择文件”，“文件C: \ \ AppBuildingFiles \”）

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

属性启用多文件选择“多选”选项“上”．，用户可以选择多个文件转变或Ctrl键并单击文件名。

[file,path] = uigetfile(“* m”，.．.“选择一个或多个文件”，.．.“多选”，“上”）;

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

输入参数

全部折叠

文件筛选器，指定为字符向量、字符向量的单元格数组或字符串数组。类的输入类型如下表所示过滤器参数和对话框的相应行为。

输入 行为 例子
文件名称

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

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

  • “程序”

  • “C: \ \程序文件”

  • “. . \程序”
文件夹

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

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

  • '文件C: \ \ '
文件扩展名过滤器

对话框只显示与文件扩展名匹配的文件。

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

若要创建具有多个文件扩展名的筛选器，请在单个字符向量或字符串中指定扩展名，并以分号(；）.

  • “* m”

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

  • {* 00; * .mlx,‘* . png, * . jpeg}
带有描述的文件扩展名过滤器

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

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

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

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

  • ．

  • ．．

  • ＼

  • /

  • ～

例如,“. . / * m”号列出所有代码文件．m在当前文件夹上方的文件夹中的扩展名。

若要使用默认的文件筛选器，请为筛选器值指定空引号。例如，要使用默认的文件过滤器并指定自定义标题，请使用以下语法:

uigetfile(”,“选择文件”)

请注意

如果您或用户包含星号(＊)或问号(?)的文件名称，然后uigetfile点击没有反应开放．该对话框一直打开，直到用户单击为止取消或从名称中删除通配符。此限制适用于所有平台，甚至适用于允许在文件名中使用这些字符的文件系统。

对话框标题，指定为字符向量或字符串标量。

若要使用默认对话框标题，请为标题值使用空引号。例如，要指定文件筛选器、默认标题和文件名称字段值，使用以下语法:

uigetfile(‘* m’,”、“myFile.m”)

例子:“选择文件”

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

  • 如果你指定了路径，它可以包含以下字符:

    • ．

    • ．．

    • ＼

    • /

    • ～

  • 属性的最后一个字符可指定文件夹名defname取值为反斜杠(＼)或斜线(/）.

例子:“myfile.mat”

例子:“文件C: \ \ my_MATLAB_files”

例子:“. . \ myfile.mat”

例子:“. . \ \文件”

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

输出参数

全部折叠

用户在对话框中指定的文件名，以字符向量或字符向量单元格数组的形式返回。

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

如果用户单击取消按钮或窗口关闭按钮(X)，则MATLAB返回文件值为0．

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

如果用户单击取消按钮或窗口关闭按钮(X)，则MATLAB返回文件值为0．

所选筛选器索引，以整数形式返回。

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

文件名字段和下拉列表。下拉列表中包含多个文件扩展名过滤器选项。

如果用户单击取消按钮或窗口关闭按钮(X)，则MATLAB返回的索引值0．

更多关于

全部折叠

模式对话框

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

提示

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

    • imread用于读取图像。

    • xlsread用于读取微软Excel文件。

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

      [file,path] = uigetfile('*.m');Selectedfile = fullfile(路径，文件);运行(selectedfile);

选择功能

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

版本历史

R2006a之前介绍

另请参阅

||