VA FileMan V. 22.0 Programmer Manual Banner


 

Main Chapter Getting Started Manual Advanced User Manual

ScreenMan Forms


Page Properties


Page Number

(Required) The Page Number uniquely identifies a page on a form. You can use this number to refer to the page in ScreenMan functions and utilities. ScreenMan does not display Page Numbers to the user.


Page Name

(Required) Like the Page Number, you can use the Page Name to refer to a page in ScreenMan functions and utilities. ScreenMan displays the Page Name to the user if, during an attempt to file data, ScreenMan finds required fields with null values. ScreenMan uses the Caption of the field and the Page Name to inform the user of the location of the required field.


Page Coordinate and Lower Right Coordinate

(Required) The Page Coordinate property defines the location of the top left corner of the page on the screen. The format of a coordinate is: Row,Column. Regular pages normally have a Page Coordinate of "1,1". They do not have a Lower Right Coordinate.

The Page Coordinate of "pop-up" pages defines the position of the top left corner of the border of the "pop-up" page. "Pop-up" pages must have a Lower Right Coordinate, which defines the position of the bottom right corner of the border of the "pop-up" page.

All blocks on the page are positioned relative to the page on which they are defined. If a page is moved - that is, if the Page Coordinate is changed - all blocks and all fields on that page move with it.

The Form Editor greatly simplifies the process of assigning coordinates to "pop-up" pages. It allows you to drag and drop an entire "pop-up" page and to drag and drop the lower right corner to resize the "pop-up" page. It therefore eliminates the need for you to manually enter Page Coordinate values.


Header Block

A page can have one Header Block that contains uneditable information. ScreenMan always positions the Header Block at coordinate "1,1" relative to the page.

There is no need to place header blocks on a page. Display blocks with a coordinate of "1,1" provide the same functionality as header blocks.


Is This a "Pop-Up" Page?

If this page is a "pop-up" page, rather than a regular page, set this property to YES.


Next Page and Previous Page

The Next Page and Previous Page properties are set to Page Numbers. The user can go to the next and previous pages by pressing <PF1><ARROW DOWN> and <PF1><ARROW UP>, respectively. The user can also ^-jump to fields on other pages that are linked to the current page via the next and previous page links. See the "Linking Pages of a Form" section for more information about using these properties to link pages.

ScreenMan also uses the Next Page property during filing. Starting with the first page displayed to the user, ScreenMan follows the Next Page links, loads those pages not already loaded, and checks that all required fields on those pages have values. If any of the required fields have null values, no filing occurs; otherwise, ScreenMan files the data along with any defaults.


Parent Field

This property can be used to link a subpage to a field on the parent page. Parent Field has the following format:

Field id,Block id,Page id

where

For example:

    ZZFIELD 1,ZZBLOCK 1,ZZPAGE 1

identifies the field with Caption or Unique Name "ZZFIELD 1," on the block named "ZZBLOCK 1," on the page named "ZZPAGE 1".


Pre Action and Post Action

ScreenMan executes the M code in the Pre Action property when the user reaches the page and the M code in the Post Action property when the user leaves the page.

 


Reviewed/Updated: March 4, 2007