HomeStartingEnvironmentDBMSVisualPQLProceduresSQLFormsHost/APIIndex
Forms homecontents start chapter top of pagebottom of pagenext page index PAGE and GROUP

Page and Group

If record, table or menu screen contains more than one display screen, then each screen is then referred to as a page. Specify pages with the
PAGE command and end a page with an ENDPAGE command.

If fields do not fit on a screen, they are automatically split into pages. There is no difference between explicitly specified pages and automatically generated pages. Attributes and security can be specified at the page level. When a screen has multiple pages, this is indicated in the Status area during use of the Form. The user can tell which page is being displayed, as well as the total number of pages in the screen. Specify groups of fields with the GROUP command and end a group with an ENDGROUP command. A group of fields can be treated as a unit for positioning, logical control, security and for video attributes. The way users move around the screen can affect computations and the execution of other commands in the form. Commands, including computations, are performed as the flow of control "passes through" the command. If the user skips from one group to the next, the flow of control does not "pass through" the fields and other commands in the group and thus any computations are skipped.

homecontents start chapter top of pagebottom of pagenext page index

PAGE

There are no required clauses on the PAGE command. The clauses that can be specified are:

Clauses:

[NO]
AUTO LOOP | PAGE
IF (expression)

General Clauses:

ACTIVITIES permissions
AT [r][,c]
[NO]AUTOTAB
BOTTOM n
CLEAR 'c'
DATA HILITE | VIDEO options
ERROR number [ VIDEO options ] 'error text'
LABELS n
PAD [n][,m]
PAGESIZE [r][,c]
PROMPT HILITE | VIDEO options

homecontents start chapter top of pagebottom of pagenext page index

GROUP

There are no required clauses on the GROUP command. The clauses that can be specified are:

Clauses:

IF (expression)

General Clauses:

ACTIVITIES permissions
AT [r][,c]
[NO]AUTOTAB
CLEAR 'c'
DATA HILITE | VIDEO options
ERROR number [ VIDEO options ] 'error text'
LABELS n
PAD [n][,m]
PROMPT HILITE | VIDEO options

homecontents start chapter top of pagebottom of pagenext page index

AUTO

AUTO {LOOP | PAGE }
Controls the flow of control at the top or bottom of a page. AUTO LOOP specifies that control stays on the current page and loops when the user moves up from the top most field or down from the bottom most field on the page. The user must specifically move to the previous or next page of a screen when AUTO LOOP is specified for a page. AUTO PAGE is the default and causes the flow of control automatically to move to the previous or next page when the user moves up from the top most field or down from the bottom field on a page.

homecontents start chapter top of pagebottom of pagenext page index

IF

IF (expression)
IF specifies a logical expression that controls whether the PAGE or GROUP command is executed. If the expression is true, the command is executed. If it is false, the whole PAGE or GROUP is skipped.
FIELD PREGNANT IF (GENDER =2)
GROUP IF (GENDER = 2 and PREGNANT = 1)
  FIELD ....
  FIELD ....
ENDGROUP
This allows input of data into a variable PREGNANT only if GENDER equals 2. The following group of fields is skipped completely if GENDER is not 2 or PREGNANT is not 1. The fields within a group are always displayed whether or not they are executed.

homecontents start chapter top of pagebottom of pagenext page index