Syntax of the INPUT instruction
The INPUT
statement supports data entry in fields of the current
form.
Syntax
INPUT { BY NAME { variable | record.* } [,...]
[ WITHOUT DEFAULTS ]
| variable | record.* } [,...]
[ WITHOUT DEFAULTS ]
FROM field-list
}
[ ATTRIBUTES (
{ display-attribute
| control-attribute
} [,...] ) ]
[ HELP help-number ]
[ dialog-control-block
[...]
END INPUT ]
where dialog-control-block is one
of:
{ BEFORE INPUT
| AFTER INPUT
| BEFORE FIELD field-spec [,...]
| AFTER FIELD field-spec [,...]
| ON CHANGE field-spec [,...]
| ON IDLE seconds
| ON TIMER seconds
| ON ACTION action-name
[ INFIELD field-spec ]
[ ATTRIBUTES ( action-attributes-input ) ]
| ON KEY ( key-name [,...] )
}
dialog-statement
[...]
where action-attributes-input
is:
{ TEXT = string
| COMMENT = string
| IMAGE = string
| ACCELERATOR = string
| DEFAULTVIEW = { YES | NO | AUTO }
| VALIDATE = NO
| CONTEXTMENU = { YES | NO | AUTO }
[,...] }
where dialog-statement is one
of:
{ statement
| ACCEPT INPUT
| CONTINUE INPUT
| EXIT INPUT
| NEXT FIELD
{ CURRENT
| NEXT
| PREVIOUS
| field-spec
}
}
where field-list defines a list of fields with one or more
of:
{ field-name
| table-name.*
| table-name.field-name
| screen-array[line].*
| screen-array[line].field-name
| screen-record.*
| screen-record.field-name
} [,...]
where field-spec identifies a unique field with one
of:
{ field-name
| table-name.field-name
| screen-array.field-name
| screen-record.field-name
}
where display-attribute is:
{ BLACK | BLUE | CYAN | GREEN
| MAGENTA | RED | WHITE | YELLOW
| BOLD | DIM | INVISIBLE | NORMAL
| REVERSE | BLINK | UNDERLINE
}
where control-attribute is:
{ ACCEPT [ = boolean ]
| CANCEL [ = boolean ]
| FIELD ORDER FORM
| HELP = help-number
| NAME = "dialog-name"
| UNBUFFERED [ = boolean ]
| WITHOUT DEFAULTS [ = boolean ]
}
- variable is a program variable that will be filled by the
INPUT
statement. - record.* is a record variable that will be filled by the
INPUT
statement. - help-number is an integer that allows you to associate a help message number with the instruction.
- field-name is the identifier of a field of the current form.
- table-name is the identifier of a database table of the current form.
- screen-record is the identifier of a screen record of the current form.
- screen-array is the screen array that will be used in the form.
- line is a screen array line in the form.
- key-name is a hot-key identifier (like
F11
orControl-z
). - dialog-name is the identifier of the dialog.
- seconds is an integer literal or variable that defines a number of seconds.
- action-name identifies an action that can be executed by the user.
- statement is any instruction supported by the language.
- boolean is a boolean expression evaluated when the dialog starts.
- action-attributes are dialog-specific action attributes.