Progress
Programming
Handbook


Becoming Realized

In general, a widget becomes realized when the application needs to make it visible on the screen. This happens, for example, when a field-level widget is referenced in a screen I/O statement such as DISPLAY or UPDATE, or when the VISIBLE attribute of a frame is set to TRUE. Also, widgets typically become realized when a parent, owner, or child widget becomes realized. References to specific attributes and methods can also cause realization.

Table 16–2 lists the specific actions that cause realization for each type of widget.

Table 16–2: Realizing Widgets
Widget Type
Action that
Causes Realization
Browse
The browse becomes visible on the screen.
Button
The button becomes visible on the screen.
 
The frame that contains the button becomes visible on the screen.
Combo box
The combo box becomes visible on the screen.
 
The frame that contains the combo box becomes visible on the screen.
 
An application references any method of the combo box.
Dialog box
See the information for frames.
Editor
The editor becomes visible on the screen.
 
The frame that contains the editor becomes visible on the screen.
 
An application references any method of the editor.
 
An application queries any of the following attributes: CURSOR–CHAR, CURSOR–LINE, CURSOR–OFFSET, MODIFIED, LENGTH, SELECTION–END, SELECTION–START, SELECTION–TEXT.
Field group
The frame that contains the field group becomes realized.
Fill-in field
The fill-in becomes visible on the screen.
 
The frame that contains the fill-in becomes visible on the screen.
Frame1
The frame becomes visible on the screen. (This happens anytime the frame’s VISIBLE attribute is set to TRUE.)
 
Any field-level widget within the frame becomes realized.
 
An UPDATE or CHOOSE statement is executed that references the frame or any field in the frame.
 
An application reads any of the following attributes: BORDER–BOTTOM, BORDER–LEFT, BORDER–RIGHT, BORDER–TOP, MAX–COLUMNS, MAX–HEIGHT, MAX–ROWS, MAX–WIDTH.
Image
The image becomes visible on the screen.
Menu bar
The window that owns the menu bar becomes realized.
 
The menu bar is attached to a window that is already realized.
Menu item
The parent menu becomes realized.
 
The menu item is added to a menu that is already realized.
Pop-up menu
The owner of the pop-up menu becomes realized.
 
The pop-up menu is attached to a widget that is already realized.
Radio set
The radio set becomes visible on the screen.
 
The frame that contains the radio set becomes visible on the screen.
 
An application sets any of the following attributes: HEIGHT, HEIGHT–ROWS, WIDTH, WIDTH–COLUMNS.
Rectangle
The rectangle becomes visible on the screen.
 
The frame that contains the rectangle becomes visible on the screen.
Selection list
The selection list becomes visible on the screen.
 
The frame that contains the selection list becomes visible on the screen.
 
An application references any method of the selection list.
 
An application reads the selection list’s MULTIPLE or VALUE attribute.
 
An application reads or sets the selection list’s INNER–CHARS or INNER–LINES attribute.
Slider
The slider becomes visible on the screen.
 
The frame that contains the slider becomes visible on the screen.
Submenu
The parent menu is realized.
 
The submenu is attached to a parent menu that is already realized.
Text
The text widget becomes visible on the screen.
 
The frame that contains the text widget becomes visible on the screen.
Toggle box
The toggle box becomes visible on the screen.
 
The frame that contains the toggle box becomes visible on the screen.
Window2
Any frame in the window is realized.
  1. If a frame is shared, it is realized in all procedures as soon as it is realized in any procedure.
  2. In batch mode, the window is realized as soon as it is created.


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