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.
Copyright © 2004 Progress Software Corporation www.progress.com Voice: (781) 280-4000 Fax: (781) 280-4095 |