Contents Previous Next

Easy Dialog Layout Argument
Syntax easydlg(caption, buttons, message, layout)
See Also controls

Description
The layout argument is a character matrix that specifies the initial value and position of fields where the user can input information into the dialog. Each row of layout corresponds to a line in the dialog and contains the information for one or two fields. If a row of layout contains a semicolon, the semicolon separates the information for two fields which are placed in the left and right columns of the dialog. If a row of layout does not contain a semicolon, the row contains information for one field which is placed in the center column of the dialog. Each field must contain a type, name, width, and setting which are described below.

Field Type
The first piece of information for a field is its type. It is terminated by a comma and must be one of the following:
     "textfield"
     "label" 
     "checkbox"
     "popupmenu" 
     "slider"
     "spinbox"
     "labelbutton" 
     "textbutton"
 Each of the options is described in the corresponding section listed below:
textfield Easy Dialog Text Fields
label Easy Dialog Label Fields
checkbox Easy Dialog Check Box Fields
popupmenu Easy Dialog Popup Menu Fields
slider Easy Dialog Slider Fields
spinbox Easy Dialog Spinbox Fields
labelbutton Easy Dialog Label Button Fields
textbutton Easy Dialog Text Button Fields

Field Name
The second piece of information for a field is its name. It is terminated by a comma and can be any sequence of characters not including a semicolon or comma. The value of a dialog field can be retrieved using this name .

Field Width
The third piece of information for a field is a positive integer that specifies its width. It is terminated by a comma. The value of width specifies the number of characters that the field can display where each character is assumed to have the same width as the character A.

Field Setting
The fourth piece of information for a field is its setting. Each field type has its own section in the help file and the corresponding meaning of the field setting is specified there.

Obtaining Field Values
After the dialog is dismissed the field values can be obtained by calling easydlg(name) where name is equal to the name of the field. The return value is a character row vector equal to the current value of the field.