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

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

Remarks

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.

Examples

The function

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

displays this dialog box:

See Also

dialog, helpdlg, inputdlg, listdlg, msgbox, questdlg, warndlg

figure, uiwait, uiresume

Predefined Dialog Boxes for related functions

  


 © 1984-2008- The MathWorks, Inc.    -   Site Help   -   Patents   -   Trademarks   -   Privacy Policy   -   Preventing Piracy   -   RSS