uialert
显示警报对话框
说明
示例
创建一个模态警告对话框。在您关闭此对话框后,才能访问后面的图窗。
fig = uifigure; uialert(fig,"File not found.","Invalid File");

fig = uifigure; message = ["Fire hazard!","Consider reducing temperature."]; uialert(fig,message,"Warning", ... "Icon","warning");

创建一个图窗和两个不同大小的矩阵。
fig = uifigure; A = rand(3); B = ones(5);
尝试垂直串联矩阵。通过获取错误文本并在图窗中创建一个警报对话框来处理出现的任何错误,然后将错误文本指定为对话框消息。MATLAB® 错误文本通常包含 HTML 格式,因此请将对话框解释器指定为 'html'。显示的错误所带链接指向 vertcat 函数的文档。
try C = vertcat(A,B); catch ME report = getReport(ME); uialert(fig,report,"Error Message","Interpreter","html"); end

输入参数
目标图窗,指定为 Figure 对象。
消息,指定为字符向量、字符向量元胞数组或字符串数组。消息可以为任意长度。
要显示多行文本,请使用字符向量元胞数组或字符串数组,其中数组中的每个元素均为不同文本行。
示例: 'Invalid value'
标题,指定为字符向量或字符串标量。长标题将被截断,后面用省略号表示。标题截断的确切长度取决于您的系统设置。
标题中的格式字符(例如换行符 \n)会替换为空格。
名称-值参数
以 Name1=Value1,...,NameN=ValueN 的形式指定可选参量对组,其中 Name 是参量名称,Value 是对应的值。名称-值参量必须出现在其他参量之后,但对各个参量对组的顺序没有要求。
在 R2021a 之前,使用逗号分隔每个名称和值,并用引号将 Name 引起来。
示例: 'Icon','warning'
警报对话框关闭请求回调函数,指定为下列值之一:
函数句柄。
第一个元素是函数句柄的元胞数组。元胞数组中的后续元素是传递到回调函数的参量。
作为有效 MATLAB 表达式的字符向量。MATLAB 在基础工作区中计算此表达式。
当 App 用户通过点击标题栏上的关闭按钮或点击确定按钮消除警告对话框时,将执行 CloseFcn 回调。当 App 用户从 MATLAB 命令行中关闭显示警告对话框的图窗窗口时,也会执行 CloseFcn 函数。您可以使用 close 函数从命令行中关闭图窗窗口。
图标,指定为预定义图标或自定义图标。
预定义图标
下表列出了预定义图标的值。例如,要显示对勾图标,请指定名称-值对组 'Icon','success'。
| 值 | 图标 |
|---|---|
'error'(默认值) |
|
'warning' |
|
'info' |
|
'question' |
|
'success' |
|
'' | 不显示任何图标。 |
自定义图标
可将自定义图标指定为下列值之一:
字符向量,指定 MATLAB 路径中的 SVG、JPEG、GIF 或 PNG 图像的文件名。也可以指定图像文件的完整路径。
真彩色图像数组。有关详细信息,请参阅 在 MATLAB 中使用图像类型。
模态,指定为 true 或 false。
模态对话框有一个特点:若不关闭它,将无法访问图窗。但是,它不会阻止其他对话框出现。
对话框文本解释器,指定为:
'none'- 显示字面字符。'tex'- 使用 TeX 标记的子集解释文本。'latex'- 使用 LaTeX 标记子集解释文本。'html'- 使用 HTML 标记子集解释文本。
TeX 标记
使用 TeX 标记添加上标和下标,并在文本中包含特殊字符。
修饰符会一直作用到文本结尾,但上标和下标除外,因为它们仅修饰下一个字符或花括号中的字符。当您将解释器设置为 "tex" 时,支持的修饰符如下所示。
| 修饰符 | 描述 | 示例 |
|---|---|---|
^{ } | 上标 | "text^{superscript}" |
_{ } | 下标 | "text_{subscript}" |
\bf | 粗体 | "\bf text" |
\it | 斜体 | "\it text" |
\sl | 伪斜体(通常与斜体相同) | "\sl text" |
\rm | 常规字体 | "\rm text" |
\fontname{ | 字体名称 - 将 替换为字体系列的名称。您可以将此说明符与其他修饰符结合使用。 | "\fontname{Courier} text" |
\fontsize{ | 字体大小 - 将 替换为以磅为单位的数值标量值。 | "\fontsize{15} text" |
\color{ | 字体颜色 - 将 替换为以下颜色之一:red、green、yellow、magenta、blue、black、white、gray、darkGreen、orange 或 lightBlue。 | "\color{magenta} text" |
\color[rgb]{specifier} | 自定义字体颜色 - 将 替换为三元素 RGB 三元组。 | "\color[rgb]{0,0.5,0.5} text" |
下表列出了 "tex" 解释器所支持的特殊字符。
| 字符序列 | 符号 | 字符序列 | 符号 | 字符序列 | 符号 |
|---|---|---|---|---|---|
| α |
| υ |
| ~ |
| ∠ |
| ϕ |
| ≤ |
|
|
| χ |
| ∞ |
| β |
| ψ |
| ♣ |
| γ |
| ω |
| ♦ |
| δ |
| Γ |
| ♥ |
| ϵ |
| Δ |
| ♠ |
| ζ |
| Θ |
| ↔ |
| η |
| Λ |
| ← |
| θ |
| Ξ |
| ⇐ |
| ϑ |
| Π |
| ↑ |
| ι |
| Σ |
| → |
| κ |
| ϒ |
| ⇒ |
| λ |
| Φ |
| ↓ |
| µ |
| Ψ |
| º |
| ν |
| Ω |
| ± |
| ξ |
| ∀ |
| ≥ |
| π |
| ∃ |
| ∝ |
| ρ |
| ∍ |
| ∂ |
| σ |
| ≅ |
| • |
| ς |
| ≈ |
| ÷ |
| τ |
| ℜ |
| ≠ |
| ≡ |
| ⊕ |
| ℵ |
| ℑ |
| ∪ |
| ℘ |
| ⊗ |
| ⊆ |
| ∅ |
| ∩ |
| ∈ |
| ⊇ |
| ⊃ |
| ⌈ |
| ⊂ |
| ∫ |
| · |
| ο |
| ⌋ |
| ¬ |
| ∇ |
| ⌊ |
| x |
| ... |
| ⊥ |
| √ |
| ´ |
| ∧ |
| ϖ |
| ∅ |
| ⌉ |
| 〉 |
| | |
| ∨ |
| 〈 |
| © |
LaTeX 标记
使用 LaTeX 标记来格式化和显示数学表达式、方程和特殊字符。使用美元符号将标记的文本括起来。例如,对于行内模式,使用 '$\int_1^{20} x^2 dx$',对于显示模式,使用 '$$\int_1^{20} x^2 dx$$'。
显示的文本将使用默认的 LaTeX 字体样式。您可以使用 LaTeX 标记来更改字体样式。
MATLAB 支持大多数标准 LaTeX 数学模式命令。有关详细信息,请参阅支持的 LaTeX 命令。
HTML 标记
使用 HTML 标记显示链接和自定义字体样式。
解释器支持部分 HTML 标记。一般情况下,解释器支持与文本相关的标记和样式。不支持的标记和样式将被忽略。
下表列出了支持的元素和元素属性。
| HTML 元素 | 属性 | 描述 |
|---|---|---|
a | style, target, href, title | 超链接 |
abbr | style, title | 缩写 |
address | style | 联系信息 |
article | style | 自包含的独立内容 |
aside | style | 与主要内容间接相关的内容 |
b | style | 粗体文本 |
bdi | style, dir | 格式与周围文本方向不同的内容 |
bdo | style, dir | 格式与周围文本方向不同的内容 |
big | style | 比周围文本大一个字体大小级别的文本(在 HTML5 中已弃用) |
blockquote | style, cite | 扩展引用 |
br | 不适用 | 换行符 |
caption | style | 表标题 |
center | style | 水平居中的内容 |
cite | style | 创造性工作的标题 |
code | style | 代码片段 |
col | style, align, valign, span, width | 表中的列 |
colgroup | style, align, valign, span, width | 表中的一组列 |
dd | style | 描述列表中的项或值 |
del | style, datetime | 从文档中删除的文本 |
details | style, open | 文本仅在切换到 'open' 状态时才可见的交互式小组件 |
dl | style | 描述列表 |
dt | style | 描述列表中的项或值 |
em | style | 强调的文本(通常以粗体显示) |
font | style, color, size, face | 具有指定字体属性的文本(在 HTML5 中弃用) |
footer | style | 页脚 |
h1. h2, h3, h4, h5, h6 | style | 节标题 - <h1> 是最高级别的标题,<h6> 是最低级别的标题 |
header | style | 介绍性内容 |
hr | style | 主题换行 |
i | style | 偏离周围内容的文本 - 默认以粗体方式呈现 |
ins | style, datetime | 插入文档中的文本 |
li | style | 列表中的项 |
mark | style | 标记或突出显示的文本 |
ol | style | 有序列表 |
p | style | 段落 |
pre | style | 预设格式的文本 |
s | style | 带删除线的文本 |
strike | style | 带删除线的文本(在 HTML5 中弃用) |
section | style | 独立节 |
small | style | 比周围文本小一个字体大小级别的文本(在 HTML5 中弃用) |
sub | style | 下标 |
sup | style | 上标 |
strong | style | 非常重要的文本 |
table | style, width, border, align, valign | 表 |
tbody | style, align, valign | 表正文 |
td | style, width, rowspan, colspan, align, valign | 表数据单元格 |
tfoot | style, align, valign | 汇总表列的表行组 |
th | style, width, rowspan, colspan, align, valign | 表数据单元格,指定为一组单元格的标题 |
thead | style, align, valign | 指定列标题的表行组 |
tr | style, rowspan, align, valign | 表单元格行 |
tt | style | 等宽文本(在 HTML5 中弃用) |
u | style | 具有模糊注解的文本 - 默认带下划线显示 |
ul | style | 无序列表 |
有关这些元素的详细信息,请参阅 https://developer.mozilla.org/en-US/docs/Web/HTML/Element。
要使用 HTML 标记创建运行 MATLAB 代码的超链接,请参阅创建运行函数的超链接。
您可以使用 HTML 样式属性来格式化 HTML 内容。样式属性是一串 CSS 属性及其值。
支持下列 CSS 属性:
background-colorborder-bottomborder-bottom-colorborder-bottom-left-radiusborder-bottom-right-radiusborder-bottom-styleborder-bottom-widthborder-leftborder-left-colorborder-left-styleborder-left-widthborder-radiusborder-rightborder-right-colorborder-right-styleborder-right-widthborder-spacingborder-styleborder-topborder-top-colorborder-top-left-radiusborder-top-right-radiusborder-top-styleborder-top-widthborder-widthcolordirectionfont-familyfont-sizefont-stylefont-weightheighthiddenline-heightmarginmargin-bottommargin-leftmargin-rightmargin-topmax-heightmax-widthmin-heightmin-widthoverflowoverflow-wrapoverflow-xoverflow-ypaddingpadding-bottompadding-leftpadding-rightpadding-toptext-aligntext-anchortext-decorationtext-indenttext-overflowtext-shadowtext-transformtitletranslatewhite-spacewidth
有关这些属性的详细信息,请参阅 https://developer.mozilla.org/en-US/docs/Web/CSS/Reference。
版本历史记录
在 R2016a 中推出使用 Interpreter 名称-值参量在对话框文本中启用标记。将解释器指定为 'html'、'latex'、'tex' 或 'none'。
MATLAB Command
You clicked a link that corresponds to this MATLAB command:
Run the command by entering it in the MATLAB Command Window. Web browsers do not support MATLAB commands.
选择网站
选择网站以获取翻译的可用内容,以及查看当地活动和优惠。根据您的位置,我们建议您选择:。
您也可以从以下列表中选择网站:
如何获得最佳网站性能
选择中国网站(中文或英文)以获得最佳网站性能。其他 MathWorks 国家/地区网站并未针对您所在位置的访问进行优化。
美洲
- América Latina (Español)
- Canada (English)
- United States (English)
欧洲
- Belgium (English)
- Denmark (English)
- Deutschland (Deutsch)
- España (Español)
- Finland (English)
- France (Français)
- Ireland (English)
- Italia (Italiano)
- Luxembourg (English)
- Netherlands (English)
- Norway (English)
- Österreich (Deutsch)
- Portugal (English)
- Sweden (English)
- Switzerland
- United Kingdom (English)




