最新のリリースでは、このページがまだ翻訳されていません。 このページの最新版は英語でご覧になれます。

errordlg

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

App Designer を使用しているか、関数 uifigure でアプリを作成している場合は、代わりに uialert を使用してください。詳細については、GUIDE の移行策を参照してください。

説明

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

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');

モーダル ウィンドウ スタイルと TeX インタープリターを指定する構造体 opts を作成します。次に、opts 構造体を入力引数として指定するエラー ダイアログ ボックスを作成します。TeX インタープリターは、メッセージ テキスト内の ^2 文字を上付き文字としてレンダリングします。

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

入力引数

すべて折りたたむ

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

  • メッセージを文字ベクトルとして指定した場合、MATLAB® によりテキストがダイアログ ボックスに収まるように折り返されます。

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

例: '入力はスカラー値でなければなりません。'

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

例: '入力エラー'

ダイアログ ボックスの設定。ウィンドウ スタイルのみまたは構造体として指定します。構造体は、ウィンドウ スタイルと msg 引数のインタープリターを指定します。

ウィンドウ スタイルのみを指定するには、opts を次の表のいずれかの値に設定します。

説明
'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 マークアップを使用して、上付き文字や下付き文字の追加、フォントのタイプや色の変更、メッセージ テキストへの特殊文字の挿入を行うことができます。

修飾子の効果はテキストの末尾まで適用されます。上付き文字と下付き文字は例外であり、次の 1 文字または中かっこで囲まれた文字にのみ適用されます。Interpreter プロパティを '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 を、redgreenyellowmagentablueblackwhitegraydarkGreenorangelightBlue の色のいずれかに置き換えます。'\color{magenta} text'
\color[rgb]{specifier}フォントのカスタムの色 — specifier を RGB 3 成分に置き換えます。'\color[rgb]{0,0.5,0.5} text'

次の表に、Interpreter プロパティが '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 ウィンドウを操作できます。非モーダル ダイアログ ボックスは normal とも呼ばれます。

ヒント

  • MATLAB プログラムの実行は、モーダル エラー ダイアログ ボックスがアクティブであっても続行されます。ユーザーがダイアログ ボックスを閉じるまでプログラムの実行をブロックする場合は、関数 uiwait を使用します。

R2006a より前に導入