Documentation

errordlg

Create error dialog box

Syntax

h = errordlg
h = errordlg(errorstring)
h = errordlg(errorstring,dlgname)
h = errordlg(errorstring,dlgname,createmode)

Description

h = errordlgcreates and displays a dialog box entitled, Error Dialog, that contains the message, “This is the default error.” Theerrordlgfunction returns the handle of the dialog box inh.

h = errordlg(errorstring)显示一个对话框,Error Dialog, that contains the message,errorstring.

h = errordlg(errorstring,dlgname)显示一个对话框,dlgname, that contains the message,errorstring.

h = errordlg(errorstring,dlgname,createmode)specifies whether the error dialog box is modal or nonmodal. Optionally, it can also specify an interpreter forerrorstringanddlgname. Thecreatemodeargument can be a character vector or a structure.

Ifcreatemodeis a character vector, it must be one of the values shown in the following table.

createmode Value Description
'modal'

Replaces the error dialog box having the specifiedTitle, that was last created or clicked on, with a modal error dialog box as specified. All other error dialog boxes with the same title are deleted. The dialog box which is replaced can be either modal or nonmodal.
'non-modal'(default)

Creates a new nonmodal error dialog box with the specified parameters. Existing error dialog boxes with the same title are not deleted.
'replace'

Replaces the error dialog box having the specifiedTitle, that was last created or clicked on, with a nonmodal error dialog box as specified. All other error dialog boxes with the same title are deleted. The dialog box which is replaced can be either modal or nonmodal.

Note

A modal dialog box prevents the user from interacting with other windows before responding. To block MATLAB®program execution as well, use theuiwaitfunction.

Modal dialogs (created usingerrordlg,msgbox, orwarndlg) replace any existing dialogs created with these functions that also have the same name.

For more information about modal dialog boxes, seeWindowStyleinFigure Properties.

IfCreateModeis a structure, it can have fieldsWindowStyleandInterpreter.WindowStylemust be one of the options shown in the table above. The value of theInterpreterfield can be'tex'or'none'. The default value forInterpreteris'none'.

Examples

This code,

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

displays this dialog box:

This code,

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

displays this dialog box:

Tips

MATLAB sizes the dialog box to fit the message specified byerrorstring. The error dialog box has anOKpush button and remains on the screen until you press theOKbutton or theReturnkey.

The appearance of the dialog box depends on the platform you use.

See Also

|||||||||

Introduced before R2006a

Was this topic helpful?
MATLAB Documentation
Other Documentation
金宝app

Try MATLAB, Simulink, and Other Products

Get trial now