errordlg

创建错误对话框

全页折叠

语法

f = errordlg(msg)

f = errordlg(msg,title)

f = errordlg(msg,title,opts)

f = errordlg

说明

注意

在 App 设计工具和使用 uifigure 函数创建的 App 中，推荐使用 uialert 而不是 errordlg，因为它提供额外的自定义选项。

f = errordlg(msg) 用指定的错误消息创建非模态错误对话框并返回对话框 Figure 对象 f。消息文本会换行以适应对话框大小。

如果您要在多个 App 窗口、MATLAB^® 桌面或 Simulink^® 上显示错误对话框，并且在响应对话框之前仍能与它们进行交互，请使用 errordlg 函数。

f = errordlg(msg,title) 指定自定义对话框标题。

示例

f = errordlg(msg,title,opts) 根据 opts 的设置（'non-modal'、'modal' 或 'replace'）指定窗口样式。如果 opts 是结构体数组，则该函数会为 msg 参量指定窗口样式和解释器。

示例

f = errordlg 创建一个错误对话框，包含如下所示的默认标题和消息。

默认标题：错误对话框
默认消息：这是默认错误。

示例

全部折叠

指定错误对话框的消息和标题

f = errordlg('File not found','File Error');

Error dialog box. The dialog box title is "File Error". The content of the dialog box consists of an alert icon, the text "File not found", and a button labeled "OK".

解释模态错误对话框的消息

创建结构体 opts，以指定模态窗口样式和 TeX 解释器。然后创建一个错误对话框，指定 opts 结构体作为输入参量。TeX 解释器将消息文本中的 ^2 字符显示为上标。

opts = struct('WindowStyle','modal',... 
              'Interpreter','tex');
f = errordlg('Try this equation instead: f(x) = x^2',...
             'Equation Error', opts);

Error dialog box. The dialog box title is "Equation Error". The content of the dialog box consists of an alert icon, the text "Try this equation instead:" followed by formatted equation text, and a button labeled "OK".

输入参数

全部折叠

`msg` — 错误消息
`'这是默认错误。'` (默认) | 字符向量 | 字符向量元胞数组 | 字符串数组

错误消息，指定为字符向量、字符向量元胞数组或字符串数组。

如果您将错误消息指定为字符向量，则 MATLAB 将对文本进行换行以适应对话框大小。
如果您将错误消息指定为元胞数组，则 MATLAB 将在每个元胞数组元素后对文本进行换行。对于较长的元胞数组元素，MATLAB 将对其文本进行换行以适应对话框大小。

示例: 'Input must be a scalar value.'

`title` — 对话框标题
`'Error Dialog'` (默认) | 字符向量 | 字符串标量

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

示例: 'Input Error'

`opts` — 对话框设置
`'non-modal'` | `'modal'` | `'replace'` | 结构体数组

对话框设置，指定为仅窗口样式或指定为结构体。结构体为 msg 参量指定窗口样式和解释器。

要仅指定窗口样式，请将 opts 设置为下表中的值之一。

值描述

值	描述
`'non-modal'`	创建非模态错误对话框。此对话框不影响其他打开的对话框。
`'modal'`	指定模态错误对话框。如果其他错误对话框具有相同的标题，MATLAB 将用当前设定修改最近激活的错误对话框。MATLAB 将删除与最近激活的错误对话框具有相同标题的其他所有打开的错误、消息和警告对话框。受影响的对话框可以是模态对话框，也可以是非模态对话框。消息和警告对话框分别使用 `msgbox` 和 `warndlg` 函数创建。
`'replace'`	指定非模态错误对话框。如果其他错误对话框具有相同的标题，MATLAB 将用当前设定修改最近激活的错误对话框。MATLAB 将删除与最近激活的错误对话框具有相同标题的其他所有打开的错误、消息或警告对话框。受影响的对话框可以是模态对话框，也可以是非模态对话框。消息和警告对话框分别使用 `msgbox` 和 `warndlg` 函数创建。

'non-modal'

创建非模态错误对话框。此对话框不影响其他打开的对话框。

'modal'

指定模态错误对话框。

如果其他错误对话框具有相同的标题，MATLAB 将用当前设定修改最近激活的错误对话框。MATLAB 将删除与最近激活的错误对话框具有相同标题的其他所有打开的错误、消息和警告对话框。受影响的对话框可以是模态对话框，也可以是非模态对话框。

消息和警告对话框分别使用 msgbox 和 warndlg 函数创建。

'replace'

指定非模态错误对话框。

如果其他错误对话框具有相同的标题，MATLAB 将用当前设定修改最近激活的错误对话框。MATLAB 将删除与最近激活的错误对话框具有相同标题的其他所有打开的错误、消息或警告对话框。受影响的对话框可以是模态对话框，也可以是非模态对话框。

消息和警告对话框分别使用 msgbox 和 warndlg 函数创建。

要为错误对话框消息指定窗口样式和解释器，请创建包含字段 WindowStyle 和 Interpreter 的 opts 结构体。下表显示了这两个字段的有效值。结构体必须包含这两个字段。

字段	值
`WindowStyle`	`'non-modal'`、`'modal'` 或 `'replace'`。
`Interpreter`	`'none'` 或 `'tex'`。如果设置为 `'tex'`，则 MATLAB 使用 TeX 解释器来显示消息。使用 TeX 标记可添加上标和下标、修改字体类型和颜色，以及在消息文本中包含特殊字符。

字段

值

WindowStyle

'non-modal'、'modal' 或 'replace'。

Interpreter

'none' 或 'tex'。如果设置为 'tex'，则 MATLAB 使用 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`	©