Set Page Characteristics Using the Page Library Dialogs

At the developer's level, the Page Library’s Page Properties dialog enables the setting of a variety of different parameters.  An example of the Page Properties dialog is displayed below.

The following page parameters can be set when you configure a page for your application after using the Add Page dialog.

Page Name:  The Page Name is used to refer to the page in code.  Unless otherwise specified, the page title will be the same as the page name. Valid characters that may be used in page names consist of any combination of:

•      Alphanumeric characters (i.e. A through Z, and 0 through 9)

•      Spaces

•      Underscore (_)

•      Number hatch ()

•      Dollar sign ($)

•      Caret (^)

•      Asterisk (*)

•      Decimal (.)

The page file name is set when the page is first created. Depending on whether the page was created by using the New dialog, by copying an existing page, or by importing an existing page, the name may have been created by the developer or automatically by VTS.  In either case, once created, the page file name cannot be changed.

Page Title Expression: This field allows you to create a VTS expression to generate a title for the page using page parameters.  This is meant to be used in conjuction with parameterized pages where one page source is used for multiple pages in the menu.

Use Color: The Use Color checkbox enables the Set Color button.

Use Bitmap: The Use Bitmap checkbox enables the Set Bitmap button.

Set Color: When the Use Color checkbox is selected, the Set Color button opens the Select Color dialog that enables you to specify the background color for the page.

Set Bitmap: When the Use Bitmap checkbox is selected, the Set Bitmap button opens the Select Image dialog that enables you to specify an image to use as the background for the page.

Page Security Bit: The Page Security Bit drop-down list displays all of the application-specific privileges that have been defined within your application (using the Administrative Settings security dialog). When you select an application-specific privilege from the Page Security Bit drop-down list, only those users who have been granted the selected privilege will be permitted to open and view the page.

Page Window Flag: The Page Window Flag radio buttons enable you to set the behaviour of the page as follows:

•      No Restrictions: The page can be opened as a full-sized page in the Display Manager, or as a small, sizable, independent page. To open a page as a full-sized page in the Display Manager, click it in the menu. In order to open a page as a small, sizable, independent page, right-click it in the menu.

•      Always Display in Window: The page will always open as a small, sizable, independent page, regardless as to how it is launched.

•      Never Display in Window: The page will always open as a regular, full-sized page in the Display Manager's page area, regardless as to how it is launched.

The variables associated with the Page Properties dialog appear as follows in the page's source code.

[

    Title = "Overview"; 

    Color = 189; 

    Bitmap; 

    SecBit; 

    WinFlag = 0; 

]

Scale Display Content:  This configuration option applies only to windowed pages.  If not checked (i.e. “Not this page” has not been checked) then when the page’s window is resized, its contents are also resized to fit.  Note that this can often result in undesirable results as some fonts and bitmaps will not scale properly.  The variable associated with this option is ScaleDisplayContent.

Bitmap Margin:  If Use Bitmap has been checked and a bitmap image applied to the page, then this option allows you to scale the bitmap within the full screen page by adding a margin to each of its four sides.

Use Bitmap Margin in Windowed Pages:  This option extends the option just discussed (Bitmap Margin) to windowed pages in addition to full screen pages.

The section that follows provides information on other available variables that can be set within a page's source code to change its appearance and behaviour.