Progress
Language Reference


FRAME Widget

A frame is a display area within a window that can group together (contain) a set of field-level widgets and child frames. In addition to default frames set up by Progress, you can set up static frames with the FRAME phrase or DEFINE FRAME statement. You can create a dynamic one-down frame with the CREATE WIDGET statement.

Related field-level widgets and child frames are actually parented by a single field group widget, which is owned, in turn, by the parenting frame. You parent static field-level widgets to a static frame using a DEFINE FRAME, FORM, or FRAME I/O statement. You parent dynamic field-level widgets to any frame by setting the FRAME attribute of each field-level widget to the handle of the parent frame. You can parent frame widgets to any frame by setting the FRAME attribute of each child frame to the handle of its parent frame.

Frames in a parent and child relationship form a frame family, which is a hierarchy of parent and child frames ultimately parented by a window. The top parent frame that is parented by the window is the root frame of the frame family.

The following figure shows a frame family with four frames, including three child frames titled Contact Information, Account Information, and PREVIOUS/NEXT.

ATTRIBUTES

Attributes

Attributes
 
 
  1. Can be set only before the frame widget is realized.
  2. Windows only.
  3. If the frame does not have a title when Progress realizes it, you cannot add one, but you can change the existing title.
  4. Character interfaces only.
  5. Graphical interfaces only.
  6. Readable only.
   

METHODS

Methods

EVENTS

Event Type
Supported
DDE-NOTIFY1
  1. Windows only. This event occurs only in dynamic data exchange (DDE) conversations. For more information, see the chapter on DDE in the Progress External Program Interfaces manual.

NOTES

SEE ALSO

DIALOG-BOX Widget, DEFINE FRAME Statement, Frame Phrase, and the chapter on frames in the Progress Programming Handbook .


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