Documentation

我们为许可用户提供了部分翻译好的中文文档。您只需登录便可查阅这些文档

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

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?