uigetpref
创建根据用户预设项打开的对话框
语法
说明
创建一个使用指定组名称和预设项名称打开的非模态对话框。组名称和预设项名称结合起来可以唯一标识该对话框。对话框中包含以下内容: pval
= uigetpref(group
,pref
,title
,quest
,pbtns
)
指定的问题 (
quest
) 以及供对话框用户回答该问题的一个或多个按钮 (pbtns
)。以pval
形式返回所点击按钮的值。一个复选框,默认情况标记为不再显示此对话框。
如果用户选中该复选框,MATLAB® 将存储并返回所点击按钮的值作为预设项值 (pval
)。以后再调用 uigetpref
操作同一个对话框时,系统会检测到已经存储了预设项值,并应用该选择,而不再打开对话框。
如果用户没有选中该复选框,MATLAB 将返回所点击按钮的值,但不会存储该值。相反,MATLAB 会存储值 'ask'
。这样以后再调用 uigetpref
时,MATLAB 还会打开指定的对话框。
[___] = uigetpref(___,
指定一个或多个可选的名称-值参量,您可以使用这些对组来执行以下任意操作。Name,Value
)
自定义复选框标签。
指定打开对话框时是否选中复选框。
提供帮助按钮以及帮助按钮的回调。
指定未关联预设项值的按钮。
指定当用户在不点击预设项按钮的情况下关闭对话框时
uigetpref
为pval
返回的值。例如,如果用户点击对话框关闭按钮 (X)、按键盘上的 Esc 键或者点击未关联预设项值的按钮,则会返回此值。
可以将此选项与上述语法中的任何输出参量结合使用。
示例
输入参数
输出参量
详细信息
提示
uigetpref
创建指定的组和预设项(如果当前不存在)。要删除您不再需要的预设项组,请使用rmpref
函数。要获得以前创建的组和预设项的结构体,请使用
getpref
函数。当用户选中不再显示此对话框复选框并关闭对话框之后,将不再为同一个组和预设项打开该对话框。要重新启用被取消的对话框,请使用
setpref
函数将预设项值设置为'ask'
。对话框的用户并不知道您在创建对话框时指定的组和预设项的名称。因此,要重新启用被预设项抑制的对话框,用户可以调用
uisetpref
命令。按如上所示执行uisetpref('clearall')
uisetpref
将重新启用使用uigetpref
定义的所有预设项对话框,而不仅仅是最新的预设项对话框。
版本历史记录
在 R2006a 之前推出