ProgressDialog 属性

控制进度对话框的外观和行为

进度对话框通过显示动画进度条指示操作正在进行中。uiprogressdlg 函数创建一个进度对话框并在显示它之前设置所有必需的属性。通过更改进度对话框的属性值，您可以对其外观和行为的某些方面进行修改。使用圆点表示法引用特定的对象和属性：

fig = uifigure;
d = uiprogressdlg(fig);
d.Value = .25;

文本和样式

全部展开

`Message` — 消息
`''` (默认) | 字符向量 | 字符向量元胞数组 | 字符串数组

消息，指定为字符向量、字符向量元胞数组或字符串数组。消息显示在对话框中进度条的上方。

要显示多行文本，请指定字符向量元胞数组或字符串数组。数组中的每个元素对应一行文本。每个元素中的硬分行（例如 '\n'）会创建额外的文本行。

示例: d = uiprogressdlg(uifigure,'Message','Calculating result.');

`Title` — 标题
`''` (默认) | 字符向量 | 字符串标量

标题，指定为字符向量或字符串标量。标题显示在对话框的标题栏中。

示例: d = uiprogressdlg(uifigure,'Title','Calculating');

`Icon` — 预定义或自定义图标
`''` (默认) | 字符向量 | 字符串标量 | 真彩色图像数组

预定义或自定义图标，指定为字符向量、字符串标量或真彩色图像数组。

预定义图标

下表列出了用于指定预定义图标的值。

值	图标
`''`（默认值）	不添加图标。
`'question'`
`'info'`
`'success'`
`'warning'`
`'error'`

自定义图标

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

字符向量或字符串标量，指定 MATLAB^® 路径中的 SVG、JPEG、GIF 或 PNG 图像的文件名。也可以指定图像文件的完整路径。
真彩色图像数组。有关详细信息，请参阅图像类型。

`Interpreter` — 对话框文本解释器
`'none'` (默认) | `'tex'` | `'latex'` | `'html'`

对话框文本解释器，指定为：

'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{specifier}`	字体名称 - 将 `specifier` 替换为字体系列的名称。您可以将此说明符与其他修饰符结合使用。	`'\fontname{Courier} text'`
`\fontsize{specifier}`	字体大小 - 将 `specifier` 替换为以磅为单位的数值标量值。	`'\fontsize{15} text'`
`\color{specifier}`	字体颜色 - 将 `specifier` 替换为以下颜色之一：`red`、`green`、`yellow`、`magenta`、`blue`、`black`、`white`、`gray`、`darkGreen`、`orange` 或 `lightBlue`。	`'\color{magenta} text'`
`\color[rgb]{specifier}`	自定义字体颜色 - 将 `specifier` 替换为三元素 RGB 三元组。	`'\color[rgb]{0,0.5,0.5} text'`

下表列出了 'tex' 解释器所支持的特殊字符。

字符序列	符号	字符序列	符号	字符序列	符号
`\alpha`	α	`\upsilon`	υ	`\sim`	~
`\angle`	∠	`\phi`	ϕ	`\leq`	≤
`\ast`	`*`	`\chi`	χ	`\infty`	∞
`\beta`	β	`\psi`	ψ	`\clubsuit`	♣
`\gamma`	γ	`\omega`	ω	`\diamondsuit`	♦
`\delta`	δ	`\Gamma`	Γ	`\heartsuit`	♥
`\epsilon`	ϵ	`\Delta`	Δ	`\spadesuit`	♠
`\zeta`	ζ	`\Theta`	Θ	`\leftrightarrow`	↔
`\eta`	η	`\Lambda`	Λ	`\leftarrow`	←
`\theta`	θ	`\Xi`	Ξ	`\Leftarrow`	⇐
`\vartheta`	ϑ	`\Pi`	Π	`\uparrow`	↑
`\iota`	ι	`\Sigma`	Σ	`\rightarrow`	→
`\kappa`	κ	`\Upsilon`	ϒ	`\Rightarrow`	⇒
`\lambda`	λ	`\Phi`	Φ	`\downarrow`	↓
`\mu`	µ	`\Psi`	Ψ	`\circ`	º
`\nu`	ν	`\Omega`	Ω	`\pm`	±
`\xi`	ξ	`\forall`	∀	`\geq`	≥
`\pi`	π	`\exists`	∃	`\propto`	∝
`\rho`	ρ	`\ni`	∍	`\partial`	∂
`\sigma`	σ	`\cong`	≅	`\bullet`	•
`\varsigma`	ς	`\approx`	≈	`\div`	÷
`\tau`	τ	`\Re`	ℜ	`\neq`	≠
`\equiv`	≡	`\oplus`	⊕	`\aleph`	ℵ
`\Im`	ℑ	`\cup`	∪	`\wp`	℘
`\otimes`	⊗	`\subseteq`	⊆	`\oslash`	∅
`\cap`	∩	`\in`	∈	`\supseteq`	⊇
`\supset`	⊃	`\lceil`	⌈	`\subset`	⊂
`\int`	∫	`\cdot`	·	`\o`	ο
`\rfloor`	⌋	`\neg`	¬	`\nabla`	∇
`\lfloor`	⌊	`\times`	x	`\ldots`	...
`\perp`	⊥	`\surd`	√	`\prime`	´
`\wedge`	∧	`\varpi`	ϖ	`\0`	∅
`\rceil`	⌉	`\rangle`	〉	`\mid`	\|
`\vee`	∨	`\langle`	〈	`\copyright`	©

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-color
border-bottom
border-bottom-color
border-bottom-left-radius
border-bottom-right-radius
border-bottom-style
border-bottom-width
border-left
border-left-color
border-left-style
border-left-width
border-radius
border-right
border-right-color
border-right-style
border-right-width
border-spacing
border-style
border-top
border-top-color
border-top-left-radius
border-top-right-radius
border-top-style
border-top-width
border-width
color
direction
font-family
font-size
font-style
font-weight
height
hidden
line-height
margin
margin-bottom
margin-left
margin-right
margin-top
max-height
max-width
min-height
min-width
overflow
overflow-wrap
overflow-x
overflow-y
padding
padding-bottom
padding-left
padding-right
padding-top
text-align
text-anchor
text-decoration
text-indent
text-overflow
text-shadow
text-transform
title
translate
white-space
width

有关这些属性的详细信息，请参阅 https://developer.mozilla.org/en-US/docs/Web/CSS/Reference。

进度

全部展开

`Value` — 完成的部分
`0` (默认) | 介于 `0` 和 `1` 之间的数字

完成的部分，指定为 0 和 1 之间的数字。当值为 1 时，进度条达到其全长。在代码中的不同位置更改 Value，以直观指示正在运行的 App 的进度。

数据类型: double

`ShowPercentage` — 显示百分比
`'off'` (默认) | on/off 逻辑值

显示百分比，指定为 'off' 或 'on'，或者指定为数值或逻辑值 1 (true) 或 0 (false)。值 'on' 等效于 true，'off' 等效于 false。因此，您可以使用此属性的值作为逻辑值。该值存储为 matlab.lang.OnOffSwitchState 类型的 on/off 逻辑值。

将此属性设置为 'on'，以在对话框中以百分比形式显示完成的部分。

`Indeterminate` — 不确定进度
`'off'` (默认) | on/off 逻辑值

不确定进度，指定为 'off' 或 'on'，或者指定为数值或逻辑值 1 (true) 或 0 (false)。值 'on' 等效于 true，'off' 等效于 false。因此，您可以使用此属性的值作为逻辑值。该值存储为 matlab.lang.OnOffSwitchState 类型的 on/off 逻辑值。

将此属性设置为 'on' 以显示动画进度条但不提供具体进度信息。此动画适用于计算时长未知的情形。

为防止不确定进度条无限期显示，请在完成计算后调用 close 函数。

交互性

全部展开

`Cancelable` — 允许取消
`'off'` (默认) | on/off 逻辑值

允许取消，指定为 'off' 或 'on'，或者指定为数值或逻辑值 1 (true) 或 0 (false)。值 'on' 等效于 true，'off' 等效于 false。因此，您可以使用此属性的值作为逻辑值。该值存储为 matlab.lang.OnOffSwitchState 类型的 on/off 逻辑值。

值为 'on' 表示在对话框中显示取消按钮。您可以通过指定 CancelText 属性来自定义按钮标签。

当您允许取消时，您必须检查 CancelRequested 属性的值，并在值为 true 时调用 close 函数。否则，对话框将无限期显示。

`CancelText` — 取消按钮文本
`'取消'` (默认) | 字符向量 | 字符串标量

取消按钮文本，指定为字符向量或字符串标量。仅当 Cancelable 属性设置为 'on' 时，此属性才起作用。

示例: d = uiprogressdlg(uifigure,'Cancelable','on','CancelText','Stop')

`CancelRequested` — 已请求取消
`true` | `false`

已请求取消，指定为 true 或 false。当 Cancelable 为 'on' 且您想知道用户是否点击了取消按钮时，使用此属性。此属性最初为 false，直到用户点击取消按钮，然后该值变为 true。

版本历史记录

在 R2018a 中推出

全部展开

R2021b: 设置文本和显示方程的样式

使用 Interpreter 属性在对话框文本中启用标记。将解释器指定为 'html'、'latex'、'tex' 或 'none'。

另请参阅

uiprogressdlg

ProgressDialog 属性

文本和样式

Message — 消息 '' (默认) | 字符向量 | 字符向量元胞数组 | 字符串数组

Title — 标题 '' (默认) | 字符向量 | 字符串标量

Icon — 预定义或自定义图标 '' (默认) | 字符向量 | 字符串标量 | 真彩色图像数组

预定义图标

自定义图标

Interpreter — 对话框文本解释器 'none' (默认) | 'tex' | 'latex' | 'html'

TeX 标记

LaTeX 标记

HTML 标记

进度

Value — 完成的部分 0 (默认) | 介于 0 和 1 之间的数字

ShowPercentage — 显示百分比 'off' (默认) | on/off 逻辑值

Indeterminate — 不确定进度 'off' (默认) | on/off 逻辑值

交互性

Cancelable — 允许取消 'off' (默认) | on/off 逻辑值

CancelText — 取消按钮文本 '取消' (默认) | 字符向量 | 字符串标量

CancelRequested — 已请求取消 true | false

版本历史记录

R2021b: 设置文本和显示方程的样式

另请参阅

WeChat

`Message` — 消息
`''` (默认) | 字符向量 | 字符向量元胞数组 | 字符串数组

`Title` — 标题
`''` (默认) | 字符向量 | 字符串标量

`Icon` — 预定义或自定义图标
`''` (默认) | 字符向量 | 字符串标量 | 真彩色图像数组

`Interpreter` — 对话框文本解释器
`'none'` (默认) | `'tex'` | `'latex'` | `'html'`

`Value` — 完成的部分
`0` (默认) | 介于 `0` 和 `1` 之间的数字

`ShowPercentage` — 显示百分比
`'off'` (默认) | on/off 逻辑值

`Indeterminate` — 不确定进度
`'off'` (默认) | on/off 逻辑值

`Cancelable` — 允许取消
`'off'` (默认) | on/off 逻辑值

`CancelText` — 取消按钮文本
`'取消'` (默认) | 字符向量 | 字符串标量

`CancelRequested` — 已请求取消
`true` | `false`