Documentation

This is machine translation

Translated by Microsoft
Mouse over text to see original. Click the button below to return to the English verison of the page.

errordlg

Create error dialog box

Syntax

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

Description

h = errordlg creates and displays a dialog box entitled, Error Dialog, that contains the string, "This is the default error string." The errordlg function returns the handle of the dialog box in h.

h = errordlg(errorstring) displays a dialog box entitled, Error Dialog, that contains the string, errorstring.

h = errordlg(errorstring,dlgname) displays a dialog box entitled, dlgname, that contains the string, errorstring.

h = errordlg(errorstring,dlgname,createmode) specifies whether the error dialog box is modal or nonmodal. Optionally, it can also specify an interpreter for errorstring and dlgname. The createmode argument can be a string or a structure.

If createmode is a string, it must be one of the values shown in the following table.

createmode ValueDescription
'modal'

Replaces the error dialog box having the specified Title, 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.

'nonmodal' (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 specified Title, 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 the uiwait function.

    Modal dialogs (created using errordlg, msgbox, or warndlg) replace any existing dialogs created with these functions that also have the same name.

    For more information about modal dialog boxes, see WindowStyle in Figure Properties.

If CreateMode is a structure, it can have fields WindowStyle and Interpreter. WindowStyle must be one of the options shown in the table above. Interpreter is one of the strings 'tex' or 'none'. The default value for Interpreter is 'none'.

Examples

This code,

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

displays this dialog box:

This code,

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

displays this dialog box:

More About

collapse all

Tips

MATLAB sizes the dialog box to fit the string 'errorstring'. The error dialog box has an OK push button and remains on the screen until you press the OK button or the Return key. After pressing the button, the error dialog box disappears.

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

Introduced before R2006a

Was this topic helpful?