errordlg

エラーダイアログボックスの作成

ページ内をすべて折りたたむ

構文

f = errordlg(msg)

f = errordlg(msg,title)

f = errordlg(msg,title,opts)

f = errordlg

説明

メモ

App Designer 内および関数 uifigure で作成されたアプリ内では、errordlg よりも uialert の方が、追加のカスタマイズオプションを使用できるため推奨されます。

f = errordlg(msg) は指定されたエラーメッセージをもつ非モーダルエラーダイアログボックスを作成し、ダイアログボックスの Figure オブジェクト f を返します。メッセージテキストはダイアログボックスに収まるように折り返されます。

複数のアプリウィンドウ、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".

モーダルエラーダイアログボックスのメッセージの解釈

モーダルウィンドウスタイルと TeX インタープリターを指定する構造体 opts を作成します。次に、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` — エラーメッセージ
`'これは既定のエラーです。'` (既定値) | 文字ベクトル | 文字ベクトルの cell 配列 | string 配列

エラーメッセージ。文字ベクトル、文字ベクトルの cell 配列または string 配列として指定します。

メッセージを文字ベクトルとして指定した場合、MATLAB によりテキストがダイアログボックスに収まるように折り返されます。
メッセージを cell 配列として指定した場合、MATLAB によりテキストが cell 配列の各要素の後で折り返されます。cell 配列の長いテキスト要素は、MATLAB によりダイアログボックスに収まるように折り返されます。

例: 'Input must be a scalar value.'

`title` — ダイアログボックスのタイトル
`'エラーダイアログ'` (既定値) | 文字ベクトル | string スカラー

ダイアログボックスのタイトル。文字ベクトルまたは string スカラーとして指定します。

例: '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'

非モーダルのエラーダイアログボックスを指定します。

メッセージダイアログボックスと警告ダイアログボックスは、それぞれ関数 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 マークアップを使用して、上付き文字や下付き文字の追加、フォントのタイプや色の変更、メッセージテキストへの特殊文字の挿入を行うことができます。

修飾子の効果はテキストの末尾まで適用されます。上付き文字と下付き文字は例外であり、次の 1 文字または中かっこで囲まれた文字にのみ適用されます。インタープリターを '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 3 成分に置き換えます。	`'\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`	©

例: opts = 'modal'

例: opts.WindowStyle = 'non-modal'; opts.Interpreter = 'tex';

詳細

すべて折りたたむ

モーダルダイアログボックス

モーダルダイアログボックスでは、モーダルダイアログボックスに応答する前に他の MATLAB ウィンドウを操作することができません。

非モーダルダイアログボックス

非モーダルダイアログボックスでは、非モーダルダイアログボックスに応答する前に他の MATLAB ウィンドウを操作できます。非モーダルダイアログボックスはノーマルダイアログボックスとも呼ばれます。

ヒント

モーダルダイアログ (errordlg、msgbox または warndlg で作成) は、これらの関数で作成された同名の既存のダイアログを置き換えます。
MATLAB プログラムの実行は、モーダルエラーダイアログボックスがアクティブであっても続行されます。ユーザーがダイアログボックスを閉じるまでプログラムの実行をブロックする場合は、関数 uiwait を使用します。
単一ウィンドウの App Designer または uifigure ベースのアプリ向けにモーダル警告ダイアログボックスを作成するには、代わりに関数 uialert を使用します。

バージョン履歴

R2006a より前に導入

参考

dialog | helpdlg | msgbox | warndlg

errordlg

構文

説明

例

エラー ダイアログ ボックスのメッセージとタイトルの指定

モーダル エラー ダイアログ ボックスのメッセージの解釈

入力引数

msg — エラー メッセージ 'これは既定のエラーです。' (既定値) | 文字ベクトル | 文字ベクトルの cell 配列 | string 配列

title — ダイアログ ボックスのタイトル 'エラー ダイアログ' (既定値) | 文字ベクトル | string スカラー

opts — ダイアログ ボックスの設定 'non-modal' | 'modal' | 'replace' | 構造体配列

詳細

モーダル ダイアログ ボックス

非モーダル ダイアログ ボックス

ヒント

バージョン履歴

参考

エラーダイアログボックスのメッセージとタイトルの指定

モーダルエラーダイアログボックスのメッセージの解釈

`msg` — エラーメッセージ
`'これは既定のエラーです。'` (既定値) | 文字ベクトル | 文字ベクトルの cell 配列 | string 配列

`title` — ダイアログボックスのタイトル
`'エラーダイアログ'` (既定値) | 文字ベクトル | string スカラー

`opts` — ダイアログボックスの設定
`'non-modal'` | `'modal'` | `'replace'` | 構造体配列

モーダルダイアログボックス

非モーダルダイアログボックス