MATLAB中listdlg函数用法

目录

语法

说明

示例

显示颜色列表用于进行多选

显示当前文件夹文件用于进行单选

        listdlg函数的功是创建列表选择对话框。

语法

[indx,tf] = listdlg('ListString',list)
[indx,tf] = listdlg('ListString',list,Name,Value)

说明

[indx,tf] = listdlg('ListString',list) 创建一个模态对话框，允许用户从指定的列表中选择一个或多个项目。

list 值是要显示在对话框中的项目列表。

        此函数返回两个输出参数 indx 和 tf，其中包含有关用户选择了哪些项目的信息。

        对话框中包括全选、取消和 确定按钮。可以使用名称-值对组 'SelectionMode','single' 将选择限制为单个项目。

[indx,tf] = listdlg('ListString',list,Name,Value) 使用一个或多个名称-值对组参数指定其他选项。例如，'PromptString','Select a Color' 在列表上方显示 Select a Color。

示例

显示颜色列表用于进行多选

list = {'Red','Yellow','Blue',...                   
'Green','Orange','Purple'};
[indx,tf] = listdlg('ListString',list);

如图所示：

显示当前文件夹文件用于进行单选

d = dir;
fn = {d.name};
[indx,tf] = listdlg('PromptString',{'Select a file.',...
    'Only one file can be selected at a time.',''},...
    'SelectionMode','single','ListString',fn);

如图所示：

参数说明

list — 项目列表

        要显示在对话框中的项目列表，指定为字符向量、字符向量元胞数组或字符串数组。对于元胞数组和字符串数组，每个元素通常对应于一个单独的列表项。如果使用 sprintf 插入换行符，则会产生更多列表项。例如，以下代码产生四个列表项，即使只有三个元胞数组元素。

f = listdlg('ListString', ...
            {'John Smith' ...
             sprintf('Cecelia\nPayne-Gaposchkin') ...
             'Gina Peters'});

PromptString — 列表框提示

        列表框提示，指定为字符向量、字符向量元胞数组或字符串数组。提示出现在列表框上方。

        如果将提示指定为长度大于对话框宽度的字符向量，则该提示将进行裁剪。要创建一个多行列表框提示，请将该提示指定为元胞数组或字符串数组。每个数组元素之间会进行换行。长元素会换行适应对话框大小。

SelectionMode — 列表选择模式

        列表选择模式，以逗号分隔的对组形式指定，该对组由 'SelectionMode' 和 'multiple' 或 'single' 组成。

• 如果选择模式设置为 'multiple'，则用户可以选择多个列表项，并且对话框中会显示全选按钮。

• 如果选择模式设置为 'single'，则用户只能选择一个列表项，并且对话框中不会显示全选按钮。

ListSize — 列表框大小

        列表框大小（以像素为单位），以逗号分隔的对组形式指定，该对组由 'ListSize' 和一个二元素向量 [width height] 组成。

InitialValue — 选定的列表框项目

        选定的列表框项目，当 'SelectionMode' 设置为 'single' 时，指定为标量索引值，当 'SelectionMode' 设置为 'multiple' 时，指定为索引向量。索引指示当对话框打开时，列表框中的哪些行处于选中状态。例如：

• 如果 'InitialValue' 设置为 3，则当对话框打开时，列表中上起第三个项目处于选中状态。

• 如果 'InitialValue' 设置为 [3 4]，则当对话框打开时，列表中上起第三个和第四个项目处于选中状态。

Name — 对话框标题

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

OKString — “确定”按钮标签

        确定按钮标签，指定为字符向量或字符串标量。

CancelString — “取消”按钮标签

        取消按钮标签，指定为字符向量或字符串标量。

indx — 选定行的索引

        选定行的索引，以索引数组形式返回。行索引对应于用户从列表中选择的项目。如果用户点击取消、按 Esc 键或者点击对话框标题栏中的关闭按钮，则将以空数组形式返回 indx 值。

tf — 选择逻辑值

        选择逻辑值，返回为 1 或 0。

        选择逻辑值指示用户是否做出选择。如果用户点击确定、双击某个列表项或者按 Return 键，则 tf 返回值为 1。

        如果用户点击取消、按 Esc 键或者点击对话框标题栏中的关闭按钮 (X)，则 tf 返回值为 0。