主要内容

listdlg

创建列表选择对话框

描述

例子

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,…,的家

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

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

如果您将提示符指定为字符向量,长度超过对话框的宽度,提示符将被剪辑。若要创建多行列表框提示符,请将提示符指定为单元格数组或字符串数组。换行出现在每个数组元素之间。长元素会自动换行以适应对话框。

例子:'PromptString','Select a catalog number:'

列表选择模式指定为逗号分隔对,由“SelectionMode”,要么“多”“单一”

  • 如果选择模式为“多”,则用户可以选择多个列表项和选择所有按钮显示在对话框中。

  • 如果选择模式为“单一”,则用户只能选择一个列表项选择所有按钮是否显示在对话框中。

例子:“SelectionMode”、“单”

列表框大小(以像素为单位),由逗号分隔的对组成“ListSize”一个二元向量,(宽高)

例子:“ListSize”,[150250]

选中的列表框项,指定为标量索引值时“SelectionMode”被设置为“单一”并指定为带有索引的向量“SelectionMode”被设置为“多”.索引指示在对话框打开时列表框中的哪些行被选中。例如:

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

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

例子:InitialValue, 5

例子:InitialValue, (2 - 5)

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

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

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

例子:“OKString”、“应用”

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

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

输出参数

全部折叠

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

选择逻辑返回为10

选择逻辑值指示用户是否进行了选择。如果用户点击好吧,双击列表项或按下返回,那么特遣部队返回值为1。

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

更多关于

全部折叠

模态对话框

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

另请参阅

|

之前介绍过的R2006a