Progress
Language Tutorial
for Character


Using the Frame Phrase

The frame phrase is the major structure for defining the characteristics of a frame. However, some of the frame phrase options affect the contents of the frame. In this respect, the frame phrase is also a structure for defining the characteristics of widgets. In some cases, it may be more convenient to use a frame phrase option rather than specifying a similar option for each individual widget. The partial syntax below shows the most frequently used options of the frame phrase that affect widget characteristics.

SYNTAX
WITH
  [ SIDE-LABELS ]
  [ NO-LABELS ]
  [ n COLUMNS ]
  [ USE-TEXT ] 

Table 7–3 describes these options.

Table 7–3: Frame Phrase Options 
Option
Use
Example
SIDE-LABELS
Puts the frame in side label mode. The widget labels then appear on the left sides of the widgets. The default mode, column label mode, positions all labels above the widgets.
WITH FRAME Frame1 SIDE-LABELS 
n COLUMNS
Puts the frame in side label mode and uses the COLON option to create (n) number of neat columns.
WITH FRAME Frame1 2 COLUMNS 
NO-LABELS
Suppresses all widget labels in the frame.
WITH FRAME Frame1 NO-LABELS 
USE-TEXT
Makes all fill-in fields in the frame text widgets. Use this option to display read-only data.
WITH FRAME Frame1 USE-TEXT 

You can specify a frame phrase at these points:

  1. DEFINE FRAME statement
  2. Screen I/O statement
  3. Control blocks (FOR, DO, REPEAT)

A frame phrase that occurs later in the execution of a procedure overrides one that occurs earlier.


Copyright © 2004 Progress Software Corporation
www.progress.com
Voice: (781) 280-4000
Fax: (781) 280-4095