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 ABL, 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

BACKGROUND attribute BGCOLOR attribute BLOCK-ITERATION-DISPLAY attribute
BORDER-BOTTOM-CHARS attribute BORDER-BOTTOM-PIXELS attribute BORDER-LEFT-CHARS attribute
BORDER-LEFT-PIXELS attribute BORDER-RIGHT-CHARS attribute BORDER-RIGHT-PIXELS attribute
BORDER-TOP-CHARS attribute BORDER-TOP-PIXELS attribute BOX attribute
BOX-SELECTABLE attribute CANCEL-BUTTON attribute CAREFUL-PAINT attribute
CENTERED attribute COLUMN attribute FIRST-CHILD attribute
FRAME attribute GRID-FACTOR-HORIZONTAL attribute GRID-FACTOR-VERTICAL attribute
GRID-SNAP attribute GRID-UNIT-HEIGHT-CHARS attribute GRID-UNIT-HEIGHT-PIXELS attribute
GRID-UNIT-WIDTH-CHARS attribute GRID-UNIT-WIDTH-PIXELS attribute GRID-VISIBLE attribute
HANDLE attribute HEIGHT-CHARS attribute HEIGHT-PIXELS attribute
HIDDEN attribute HTML-CHARSET attribute INHERIT-BGCOLOR attribute
INHERIT-FGCOLOR attribute INSTANTIATING-PROCEDURE attribute LABELS attribute
LAST-CHILD attribute LINE attribute MANUAL-HIGHLIGHT attribute
PARENT attribute PFCOLOR attribute PIXELS-PER-COLUMN attribute
PIXELS-PER-ROW attribute POPUP-MENU attribute PREV-SIBLING attribute
PREV-TAB-ITEM attribute PRIVATE-DATA attribute RESIZABLE attribute
ROW attribute SCROLLABLE attribute SELECTABLE attribute
SELECTED attribute SENSITIVE attribute SIDE-LABELS attribute
TAB-POSITION attribute TAB-STOP attribute THREE-D attribute
TITLE attribute TITLE-BGCOLOR attribute TITLE-DCOLOR attribute
TITLE-FGCOLOR attribute TITLE-FONT attribute TOP-ONLY attribute
TYPE attribute WIDGET-ID attribute

Methods

Events

Notes

See also

CREATE widget statement, DIALOG-BOX widget, DEFINE FRAME statement, Frame phrase