Documentation Center

  • Trials
  • Product Updates

errordlg

Create and open 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 with title 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 with title Error Dialog that contains the string errorstring.

h = errordlg(errorstring,dlgname) displays a dialog box with titledlgname 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.

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 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.

    If you open a dialog with errordlg, msgbox, or warndlg using 'CreateMode','modal' and a non-modal dialog created with any of these functions is already present and has the same name as the modal dialog, the non-modal dialog closes when the modal one opens.

    For more information about modal dialog boxes, see WindowStyle in the 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','non-modal',... 
       'Interpreter','tex');
h = errordlg('Try this equation instead: f(x) = x^2',...
    'Equation Error', mode);

displays this dialog box:

More About

expand 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.

See Also

| | | | | | | | |

Was this topic helpful?