VA FileMan V. 22.0 Programmer Manual Banner


Main Chapter Getting Started Manual Advanced User Manual

ScreenMan Forms

Displaying Multiples in Repeating Blocks

You can display more than one subrecord in a multiple simultaneously on the screen. See the "Multiples" section in the "VA FileMan Getting Started Manual." You do this by defining a repeating block, a block that has a Replication value greater 1. The Replication number defines the number of lines in the scrolling list - or, in other words, the number of times the fields on the block appear on the screen.    The DD Number of the block corresponds to the subfile number of the multiple.

22.2The fields on the repeating block can occupy one or more lines per block.

You should reserve one column to the left of the repeating block for ScreenMan to display the plus sign (+) indicator before the first and last lines of the list.

The following illustration shows two subfields of a multiple displayed in a repeating block:

Example of Fields Displayed in a Repeating Block.

The subfields are NAME MULT1 and SET OF CODES. The repeating block has a Replication value of 5; therefore, up to five subrecords can be displayed simultaneously. The coordinate of the repeating block corresponds to the position of the first line in the list.

The column headings are defined as caption-only fields on another block that is non-repeating.

The last line in the scrolling list is blank. This is where the user can add a subrecord by entering a new name or jump to a particular entry in the list by entering the name of an existing subrecord. By default, this blank line is positioned in the same column as the first editable field in the repeating block.

The following variables are available in the pre- and post-actions of fields on the repeating block, as well as in the Executable Caption code:

Variables Available in Repeating Blocks
Local Variable Description
DDSSN The sequence number in the list of the current subrecord.
DDSLN The line number in the repeating block on which the cursor is currently resting.
Block Properties that Apply Only to Repeating Blocks
Repeating Block Property Description
Replication The number of times the fields defined in this block should be replicated. This number must be greater than 1.
Index The name of the index that should be used to pick up the subrecords in the multiple. The subrecords will initially be sorted in the order defined by this index. The default Index is B. If the multiple has no B index, or if you wish to display the subentries in record number order, enter !IEN. (Optional)
Initial Position This is where the cursor should rest when the user first navigates to the repeating block. Possible values are FIRST, LAST, and NEW, where NEW indicates that the cursor should initially rest on the blank line at the end of the list. The default Initial Position is FIRST. (Optional)
Disallow LAYGO If set to YES, this prohibits the user from entering new subrecords into the multiple. (Optional)
Field for Selection This is the field order of the field that defines the column position of the blank line at the end of the list. The default is the first editable field in the block. This is also the field before which ScreenMan prints the plus sign (+) to indicate there are more entries above or below the displayed list. (Optional)


Reviewed/Updated: October 2016