主要内容

uigetpref

创建根据用户首选项打开的对话框

描述

pval= uigetpref (优先股标题探索pbtns创建一个nonmodal使用指定的组名和首选项名称打开的对话框。组名称和首选项名称组合起来唯一标识对话框。该对话框包含:

  • 指定的问题(探索)和一个或多个按钮(pbtns)使对话框用户能够回答问题。单击的按钮值返回为pval

  • 默认情况下,该复选框被标记不再显示此对话框

如果用户选中该复选框,则单击MATLAB®存储并返回单击按钮的值作为首选项值(pval).随后的调用uigetpref对于同一个对话框,检测是否存储了首选项值并应用该选择,而不需要打开对话框。

如果用户未选中该复选框,则MATLAB返回,但不存储单击按钮的值。相反,MATLAB存储该值“问”.MATLAB在随后的调用中打开指定的对话框uigetpref

例子

pvaltf]=uigetpref(优先股标题探索pbtns返回指示对话框是否打开的逻辑值。如果对话框打开,则tf1(真正的)。否则,为tf0(错)。

例子

___]=uigetpref(___名称,值指定一个或多个可选名称-值对,使您能够执行以下任一操作。

  • 自定义复选框标签。

  • 指定对话框打开时是否选中该复选框。

  • 提供帮助按钮和帮助按钮回调。

  • 指定没有映射到首选项值的按钮。

  • 指定uigetpref回报pval如果用户关闭对话框而没有单击首选项按钮。例如,如果用户单击对话框关闭按钮(X),按下键盘,则返回此值Esc键,或单击未映射到首选项值的按钮。

将此选项与前面语法中的任何输出参数组合一起使用。

例子

全部折叠

定义每一个必需的uigetpref输入参数,然后将其传递给uigetpref

组=“更新”;优先=“转换”; 头衔=“转换”;追求= {'确实要转换此代码吗?'...“无法撤消转换。”};pbtns = {“是的”“不”};[pval, tf] = uigetpref(集团、参照、标题、追求pbtns)

点击.MATLAB命令窗口显示pval“是的”这个值tf1,表示已显示该对话框。

运行uigetpref命令,但这次选择不再显示此对话框,然后单击

[pval, tf] = uigetpref(集团、参照、标题、追求pbtns)

MATLAB命令窗口显示pval“不”这个值tf1

运行uigetpref再次指挥。

[pval, tf] = uigetpref(集团、参照、标题、追求pbtns)

如预期的那样,该对话框不会显示。MATLAB命令窗口显示pval“不”这个值tf0

通过将首选项值设置为,重新启用对话框显示“问”

setpref(“更新”“转换”“问”);

运行uigetpref命令。对话框打开。

[pval, tf] = uigetpref(集团、参照、标题、追求pbtns)

具体说明“ExtraOptions”,“取消”作为名称-值对向对话框中添加取消按钮。如果用户单击取消, MATLAB返回按钮标签pval

组=“更新”;优先=“转换”; 头衔=“转换”;追求= {'确实要转换此代码吗?'...“无法撤消转换。”};pbtns = {“是的”“不”};[pval] = uigetpref(集团、参照、标题、追求pbtns,...“额外选择”“取消”);

创建一个函数,用于创建“首选项”对话框。该对话框要求用户在关闭图形之前保存图形。根据用户单击的按钮值,该函数将打开“保存”对话框或关闭图形而不保存。

函数savefigconditional FIG = gcf;组=“我的图形”;优先=“SaveFigBeforRecosing”; 头衔=“收盘数字”;追求= {“是否要在关闭前保存您的数字?”'''如果不保存图形,所有更改将丢失'};pbtns = {“是的”“不”};[pval,tf]=uigetpref(组,pref,标题,任务,pbtns);转换pval案例“是的”(文件、路径indx) = uiputfile (“无花果”...“保存当前数字”...“无名小卒”);如果indx==0删除(图);其他的saveas(图,路径、文件)删除(图);结束案例“不”删除(图);返回结束

要运行此示例,请将代码复制并粘贴到新的程序文件中savefigconditionally.m并保存在您的搜索路径。将函数作为关闭请求FCN回调,创建一个图形,并可以选择打印一些数据。

图(“CloseRequestFcn”“savefigconditionally”);X = [1 2 3 4 5];Y = [10 50 25 75 25];情节(x, y);
每次运行前面的命令块并单击图形标题栏中的关闭按钮(X)时,除非进行选择,否则对话框就会打开不再显示此对话框

输入参数

全部折叠

首选项组名称,指定为字符向量或字符串标量。该组包括优先股输入参数。如果该组不存在,MATLAB将创建它。

例子:“我的图形”

首选项名称,指定为字符向量或字符串标量。

此首选项将按钮的值存储在指定的范围内pbtns如果首选项名称不存在,则MATLAB将创建它。

例子:“保存图片”

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

例子:“保存首选项”

对话框问题,指定为字符向量、字符向量单元数组或字符串数组。问题文本中出现的换行符如下:

  • 如果问题被指定为字符向量,则换行出现在竖线(|)字符或用新线函数。

  • 如果问题被指定为字符向量的单元格数组,则在每个单元格数组元素之后都会出现换行。

例子:{“确实要转换此代码吗?”,“转换无法撤消”。}

例子:'是否要在关闭前保存此文件?'

首选项按钮标签,指定为字符向量、字符向量的单元格数组、垂直条分隔的字符向量或字符串数组。

如果要指定与按钮标签不同的内部首选项值,则指定pbtns值作为一个2-x-n单元格数组或字符串数组。第一行包含首选项名称,第二行包含关联的按钮标签。例如,如果您打算本地化各种语言的对话框,请考虑使用此方法。您可以使用外语指定按钮标签,而无需更改代码逻辑(例如,转换案例语句)。

什么时候pbtns这不是一辆双人自行车-n单元格数组中,MATLAB将标签名称存储为首选值。

例子:“是的”

例子:{‘是的’,‘不’}

例子:[“是|否”]

例子:{'Oui','Non';'yes','no'}将按钮标签设置为“是的”“非”以及相应的偏好值“是的”“不”

名称-值参数

指定可选的逗号分隔的对名称,值论据。名称参数名和价值是对应的值。名称必须出现在引号内。可以以任意顺序指定多个名称和值对参数名称1,值1,…,名称,值

例子:线条(x,y,'Color','red','LineWidth',3)创建一条3点宽的红线。 例子:“CheckboxSting”,“不要再问了。”

对话框打开时复选框的初始状态,指定为逗号分隔对,由“CheckboxState”10符合事实的

  • 当值为时,选中复选框符合事实的1

  • 当值为时,复选框未被选中0

例子:“CheckboxState”,0

复选框标签,指定为逗号分隔对,由“CheckboxString”以及字符向量或字符串标量。

帮助按钮标签,指定为逗号分隔对,由“救命”和字符向量或字符串标量。如果未指定此名称-值对,则对话框中不会显示任何帮助按钮。如果指定此名称-值对,但不指定帮助名称-值对,然后MATLAB使用“HelpFcn”、“doc(uigetpref)”默认情况下。

例子:“帮助字符串”,“信息”

帮助按钮回调,指定为逗号分隔对,由“HelpFcn”函数句柄、字符串数组或字符向量(不推荐)。当用户单击“帮助”按钮时,将执行回调。指定此名称-值对时,还必须指定“帮助字符串”名称-值对。

另见,为以编程方式创建的应用编写回调

例子:HelpFcn, @myfunc指定了帮助回调函数作为函数句柄。

额外按钮的标签,指定为逗号分隔对,由“额外选择”和字符向量、字符向量的单元格数组或字符串数组。附加按钮未映射到任何首选项。如果用户单击其中任何按钮,对话框将关闭并返回按钮标签作为输出参数pval

例子:“ExtraOptions”,“取消”

默认按钮选择,指定为逗号分隔对,由“默认按钮”和字符向量或字符串标量。默认按钮选择将返回到p如果用户未单击任何按钮而关闭对话框。此值不必与任何首选项按钮或ExtraOption按钮。

例子:“nobtn”

输出参数

全部折叠

所选的首选项按钮作为字符串标量返回。返回值是下列值之一:

  • 按下的首选项按钮的标签(pbtns

  • 单击的首选项按钮的内部值

True或false结果,返回为1或0。函数返回1(true)如果对话框打开。否则,它将返回0。此值对应于上次打开对话框时存储的复选框选择,并且用户选择了复选框(标有'不再显示此对话框'默认情况下)。

更多关于

全部折叠

非模态对话框

非模态对话框使用户能够在响应对话框之前与其他MATLAB窗口进行交互。非模态对话框也称为普通对话框。

首选项

通过首选项,您可以指定应用程序的行为方式以及用户与应用程序的交互方式。首选项在会话中保持不变,并存储在首选项数据库中。

uigetpref函数使用与MATLAB内置产品相同的首选项数据库。但是,下载188bet金宝搏uigetpref将其设置的首选项注册为单独的列表,以便uisetpref您可以管理这些首选项。

要修改已注册的首选项,请执行以下操作:uigetpref使用uisetprefsetpref.例如,使用setpref将首选项值更改为“问”

提示

  • uigetpref创建指定的组和首选项(如果它们当前不存在)。要删除不再需要的首选项组,请使用rmpref

  • 要获得先前创建的组和首选项的结构,请使用getpref函数。

  • 用户选中复选框后不再显示此对话框并关闭对话框,则不会再次打开同一组和首选项的对话框。要重新启用被抑制的对话框,请将首选项值设置为“问”使用setpref

  • 对话框的用户不知道在创建对话框时指定的组和首选项名称。因此,要重新启用被首选项抑制的对话框,用户可以调用uisetpref命令

    uisetpref('clearall')
    执行uisetpref如图所示允许所有使用定义的首选项对话框uigetpref,而不仅仅是最近的一次。

在R2006a之前引入