Main Content

本页的翻译已过时。点击此处可查看最新英文版本。

uialert

显示警报对话框

说明

示例

uialert(fig,message,title) 在指定图窗窗口的前面显示一个模态对话框。图窗必须使用 uifigure 函数创建。此对话框中显示指定的消息,并在标题栏中显示指定的标题。默认情况下,此对话框还包含一个错误图标和一个确定按钮。

示例

uialert(___,Name,Value) 显示一个对话框,此对话框的属性由一个或多个 Name,Value 对组参数指定。

示例

全部折叠

创建一个模态警告对话框。在您关闭此对话框后,才能访问后面的图窗。

fig = uifigure;
uialert(fig,'File not found','Invalid File');

fig = uifigure;
message = sprintf('Fire hazard! \n Consider reducing temperature.');
uialert(fig,message,'Warning',...
'Icon','warning');

输入参数

全部折叠

目标图窗,指定为 Figure 对象。图窗必须使用 uifigure 函数创建。

消息,指定为字符向量、字符向量元胞数组或字符串数组。消息可以为任意长度。

允许使用格式字符(例如换行符 \n)。要显示多行文本,请使用字符向量元胞数组或字符串数组。

示例: 'Invalid value'

标题,指定为字符向量或字符串标量。长标题将被截断,后面用省略号表示。标题截断的确切长度取决于您的系统设置。

标题中的格式字符(例如换行符 \n)会替换为空格。

名称-值对组参数

指定可选的、以逗号分隔的 Name,Value 对组参数。Name 为参数名称,Value 为对应的值。Name 必须放在引号中。您可采用任意顺序指定多个名称-值对组参数,如 Name1,Value1,...,NameN,ValueN 所示。

示例: 'Icon','warning'

警报对话框关闭请求回调函数,指定为下列值之一:

  • 函数句柄。

  • 第一个元素是函数句柄的元胞数组。元胞数组中的后续元素是传递到回调函数的参数。

  • 作为有效 MATLAB® 表达式的字符向量。MATLAB 在基础工作区中计算此表达式。

当 App 用户通过点击标题栏上的关闭按钮或点击确定按钮消除警告对话框时,将执行 CloseFcn 回调。当 App 用户从 MATLAB 命令行中关闭显示警告对话框的图窗窗口时,也会执行 CloseFcn 函数。您可以使用 close 函数从命令行中关闭图窗窗口。

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

预定义图标

下表列出了预定义图标的值。例如,要显示对勾图标,请指定名称-值对组 'Icon','success'

图标
'error'(默认值)

'warning'

'info'

'success'

''

不显示任何图标。

自定义图标

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

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

  • 真彩色图像数组。有关详细信息,请参阅 图像类型

模态,指定为 truefalse

模态对话框有一个特点:若不关闭它,将无法访问图窗。但是,它不会阻止其他对话框出现。

在 R2016a 中推出