主要内容

listdlg

创建列表选择对话框

所有的页面崩溃

语法

[indx, tf] = listdlg (ListString,列表)
[indx, tf] = listdlg (ListString,列表,名称,值)

描述

例子

(indx,特遣部队)= listdlg (“ListString”,列表)创建一个模态对话框,允许用户从指定的列表中选择一个或多个项目。

的列表值的列表条目出现在对话框。

函数返回两个输出参数,indx和特遣部队包含哪些项目用户选择的信息。

对话框包括选择所有,取消,好吧按钮。你可以选择限制在单个项目通过使用名称-值对,“SelectionMode”、“单”。

例子

(indx,特遣部队)= listdlg (“ListString”,列表,名称,值)使用一个或多个指定附加选项名称-值对参数。例如,“PromptString”、“选择颜色”礼物选择一个颜色以上列表中。

例子

全部折叠

={列表“红色”,“黄色”,“蓝”,…“绿色”,“橙”,“紫色”};[indx, tf] = listdlg (“ListString”列表);

d = dir;fn = {d.name};[indx, tf] = listdlg (“PromptString”,{选择一个文件。,…“一次只可以选择一个文件。,”},…“SelectionMode”,“单一”,“ListString”、fn);

输入参数

全部折叠

项目列表对话框中,指定为一个特征向量,单元阵列的特征向量,或字符串数组。通常细胞数组和字符串数组,每个元素对应一个单独的列表项。如果您使用的插入换行符sprintf,它导致更多的列表项。例如,下面的代码导致四个列表项,尽管只有三个单元阵列元素。

f = listdlg (“ListString”,…{“约翰·史密斯”…sprintf (“Cecelia \ nPayne-Gaposchkin”)…吉娜·彼得斯的});

例子:{“艾伦”、“Varun”,“子”,“罗杰”}

名称-值参数

指定可选的双参数作为Name1 = Value1,…,以=家,在那里的名字参数名称和吗价值相应的价值。名称-值参数必须出现在其他参数,但对的顺序无关紧要。

R2021a之前,用逗号来分隔每一个名称和值,并附上的名字在报价。

例子:“SelectionMode”,单”、“InitialValue”4指定用户可以从列表中选择一项,当对话框打开时,第四项列表中被选中。

列表框提示,指定为一个特征向量,单元阵列的特征向量,或字符串数组。列表框上方的提示出现。

如果您指定提示作为特征向量的时间比对话框的宽度,提示剪辑。创建一个多行列表框提示,提示指定为一个细胞数组或字符串数组。每个数组元素间发生的换行符。长元素包装以适应对话框。

例子:“PromptString”、“选择目录数量:

模式指定为逗号分隔列表选择组成的“SelectionMode”,要么“多”或“单一”。

  • 如果选择模式设置“多”,然后用户可以选择多个列表项选择所有按钮显示在对话框。

  • 如果选择模式设置“单一”,然后用户可以仅选择一个列表项,选择所有按钮是否不在对话框中显示。

例子:“SelectionMode”、“单”

列表框大小(以像素为单位),指定为逗号分隔组成的“ListSize”和一个双元素向量,(宽高)。

例子:“ListSize”, [150250]

选择列表框项,指定为一个标量指数价值“SelectionMode”被设置为“单一”和指标时指定为一个向量“SelectionMode”被设置为“多”。指标显示在列表框行对话框打开时被选中。例如:

  • 如果“InitialValue”被设置为3,然后第三项从列表的顶部时选择对话框打开。

  • 如果“InitialValue”被设置为[3 - 4],然后第三和第四项从列表的顶部选择对话框打开。

例子:InitialValue, 5

例子:InitialValue, (2 - 5)

对话框标题,指定为一个特征向量或字符串标量。

例子:“名称”、“文件选择”

好吧按钮标签,指定为一个特征向量或字符串标量。

例子:“OKString”、“应用”

取消按钮标签,指定为一个特征向量或字符串标量。

例子:“CancelString”、“不选择”

输出参数

全部折叠

索引选择行,作为一个数组返回的索引。行指标对应于从列表中选择的用户。如果用户单击取消,按Esc,或者点击关闭按钮在对话框标题栏,然后indx返回值为一个空数组。

选择逻辑返回1或0。

选择逻辑值表示用户是否做了一个选择。如果用户单击好吧双击一个列表项,或按下返回,那么特遣部队返回值是1。

如果用户单击取消,按Esc,或者点击关闭按钮在对话框标题栏(X),然后特遣部队返回值是0。

更多关于

全部折叠

模态对话框

一个模态对话框可以防止用户与其他MATLAB交互®窗户前响应。有关更多信息,请参见WindowStyle在图的属性。

版本历史

之前介绍过的R2006a

另请参阅

|