VA FileMan V. 22.0 Programmer Manual Banner


Main Chapter Getting Started Manual Advanced User Manual

ScreenMan Form Editor

Editing Field Properties

To edit the properties of a field, select the field with <SpaceBar> or , and press <PF4>. The Form Editor invokes a ScreenMan form where the properties of the field can be edited.

The specific form that is invoked depends on the type of the selected field. For example, the form for editing data dictionary fields looks like this:

Example of the Form for Editing Data Dictionary Fields.

When you enter a value at the "FIELD:" prompt for data dictionary fields, the Form Editor automatically defines the Caption as the field's label. If the field is a multiple field, the Form Editor adds the word "Select" before the field's label. If the field is a word processing field, the Form Editor adds the characters "(WP)" after the field's label. At the "CAPTION:" prompt, you can accept the Form Editor's default, enter a new caption, or enter one of the following:

Shortcuts at the CAPTION Prompt
To define the caption as Enter at the CAPTION prompt
Field label !L
Field title !T
Unique name of field !U
Duplicated string !DUP(string,number of occurrences) For example, !DUP("-",79)

The "OTHER PARAMETERS:" prompt is followed by an ellipsis (...) to indicate that this field leads to a new page. To view that page, navigate to the Other Parameters field and press the Enter/Return key. A "pop-up" window appears where you can edit additional properties of the field.

Example of the Form Popup Window to Edit Additional Properties of a Field.

To close the Other Parameters "pop-up" window, press <PF1>C. To return to the Form Editor's Main Screen, press <PF1>E to exit and save your changes, or press <PF1>Q to quit the form without saving your changes.

Editing Field Captions and Data Length

As described above, you can press <PF4> to invoke a ScreenMan form to edit the caption and data length of fields. You can also edit these properties directly from the Form Editor's Main Screen.

To change the caption of a field, position the cursor over the caption, and press <PF3>. You can then edit the caption with the same editing keys available in ScreenMan's Field Editor. Press the Enter/Return key when you are finished editing the caption.

To change the data length of a field, position the cursor over the data portion of the field, and press <PF3>. You can then increase and decrease the data length by pressing <ARROW RIGHT> and <ARROW LEFT>. An indicator (L=n) at the lower right portion of the Main Screen indicates the current data length. Press the Enter/Return key when you are finished editing the data length.

Reordering All Fields on a Block

After creating and arranging all the fields on a block, you can quickly make the Field Orders of all the fields equivalent to the tab order by doing the following:

  1. Go to the Block Viewer Screen (<PF1>V)

  2. Select the block (<SpaceBar> or over the block name)

  3. Press <PF1>O

Remember that the Field Order is the order in which the elements on the block are traversed when the user presses the Enter/Return key. The <PF1>O key sequence reassigns Field Order numbers to all the elements on the block, so that the Enter/Return key takes the user from field to field in the same order as the Tab key (left to right, top to bottom).

Note that if you refer to fields by Field Order in places such as Branching logic and Pre and Post Actions, reordering the fields on the block could cause that code to refer to the wrong fields. You must then modify the code to either reflect the new Field Order numbers, or refer to those fields by Caption or Unique Name instead.


Reviewed/Updated: March 10, 2007