主要内容

uiconfirm

创建确认对话框

描述

uiconfirm(无花果消息标题在指定的目标地物中显示模式应用内确认对话框。必须使用uifigure函数。此语法显示两个选项供用户选择,好啊取消.当对话框显示时,对话框后面的图形是不可访问的,但MATLAB®命令提示符可以访问。

例子

uiconfirm(无花果消息标题名称、值显示一个或多个确认对话框名称、值对自定义对话框的外观和行为的参数进行配对。例如,您可以在对话框中指定自定义的选项集,而不是默认的,好啊取消

例子

选择=ui确认(___返回用户选择的字符向量。指定选择输出参数使用任何前面的语法。当您使用此语法时,当对话框显示时,MATLAB命令提示符是不可访问的。

例子

全部崩溃

创建一个显示警告图标而不是默认问题图标的对话框。

无花果= uifigure;选择= uiconfirm(无花果,“结束文档?”确认关闭的...“图标”“警告”);

当用户选择一个选项时,uiconfirm以字符向量的形式返回该选择。

创建一个包含三个选项的确认对话框:覆盖另存为新,及取消.指定另存为新作为默认选项,并指定取消作为映射到取消行为的选项。

图=uifigure;msg='保存这些更改将覆盖以前的更改。';头衔=“确认保存”;选择=uiconfirm(图、消息、标题、,...“选项”,{“覆盖”“另存为新”“取消”},...“默认选项”2.“取消选项”3);

当用户选择一个选项时,uiconfirm返回他们选择的字符向量。

CloseFcn名称-值对参数对于在对话框关闭时执行特定任务很有用。

在MATLAB编辑器中,创建一个名为mycallback.m它包含以下代码。这个回调函数显示选择选项田野结构打电话事件.MATLAB会自动通过此测试结构作为回调函数的第二个参数。

功能mycallback(src,event)显示(event.SelectedOption);结束

在MATLAB命令窗口中,执行以下代码以创建一个确认对话框,其中指定mycallback作为价值CloseFcn

无花果= uifigure;uiconfirm(图,“结束文档?”确认关闭的...“CloseFcn”, @mycallback);

当用户选择一个选项时选择选项显示在命令窗口中。

要在App Designer中创建一个确认对话框,该对话框具有CloseFcn回调函数,在App Designer中把回调函数写为私有函数。

从选择开始代码视图.然后通过选择创建私有函数作用>私人职能

接下来,编写私有函数,使其与下面的代码匹配:

功能mycallback(应用程序、src、事件)显示(event.SelectedOption);结束

将此命令添加到要显示对话框的回调函数中。在本例中,目标图是app.UIFigure,这是App Designer中图形的默认名称。

uiconfirm(app.UIFigure,“结束文档?”确认关闭的...“CloseFcn”@ (src、事件)mycallback(应用程序、src、事件));

保存并运行应用程序。当用户触发创建对话框的回调时,对话框就会显示在应用程序中。

输入参数

全部崩溃

目标图,指定为数字对象。图形必须使用uifigure函数。

要显示的消息,指定为字符向量、字符向量的单元格数组或字符串数组。当消息有多行文本时,请指定单元格数组或字符串数组。数组中的每个元素对应于不同的文本行。

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

名称-值对参数

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

例子:选择= uiconfirm(无花果、消息、标题“选项”,{“保存”,“删除”,“退出”})为对话框指定三个自定义选项。

自定义选项,指定为字符向量单元格数组或字符串数组。

图标,指定为预定义图标或自定义图标。

预定义的图标

此表列出了预定义图标的值。例如,要显示复选标记图标,请指定名称-值对“图标”,“成功”

价值 图标
“问题”(默认)

“信息”

“成功”

“警告”

“错误”

'' 没有图标显示。

自定义图标

将自定义图标指定为以下值之一:

  • 一个字符向量,指定MATLAB路径上的SVG、JPEG、GIF或PNG图像的文件名。或者,您可以指定图像文件的完整路径。

  • truecolor图像阵列。请参阅图像类型了解更多信息。

默认选项,指定为字符向量、字符串标量或整数。默认选项对应于对话框中默认具有焦点的按钮。

指定字符向量或字符串标量时,它必须与选项数组中。但是,如果你正在打电话uiconfirm没有选项参数,然后默认选项必须是“好吧”“取消”

指定整数时,它必须在[1,n]范围内,其中n是整数的长度选项数组。如果您正在呼叫uiconfirm没有选项参数,然后默认选项必须是12

选项,指定为字符向量、字符串标量或整数。取消选项指定对话框中哪个选项映射到取消操作。

指定字符向量或字符串标量时,它必须与选项数组中。但是,如果你正在打电话uiconfirm没有选项参数,然后取消选项必须是“好吧”“取消”

指定整数时,它必须在[1,n]范围内,其中n是整数的长度选项数组。如果您正在呼叫uiconfirm没有选项参数,然后取消选项必须是12

关闭回调函数,指定为以下值之一:

  • 一个处理函数。

  • 单元格数组,其中第一个元素是函数句柄。cell数组中的后续元素是要传递给回调函数的参数。

  • 包含有效MATLAB表达式的字符向量(不推荐)。MATLAB在基本工作空间中计算这个表达式。

此回调用于在对话框关闭时执行特定任务。

当你指定CloseFcn作为函数句柄(或包含函数句柄的单元格数组),MATLAB通过结构包含事件数据作为回调函数的输入参数。这结构包含下表中描述的字段。

结构域 价值
来源 数字与对话框关联的对象。
事件名 “ConfirmDialogClosed”
对话标题 对话框的标题。
选择选项索引 所选选项的索引。为n选项时,索引可以是以下任意整数:1n
选择选项 所选选项的按钮标签,作为字符向量返回。

介绍了R2017b