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 message, "This is the default error." 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 message, errorstring.

h = errordlg(errorstring,dlgname) displays a dialog box entitled, 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 for errorstring and dlgname. The createmode argument can be a character vector or a structure.

If createmode is a character vector, 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. The value of the Interpreter field can be '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 message specified by 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.

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

Introduced before R2006a

Was this topic helpful?