A window is a rectangular area on the screen that can contain frame widgets, parent dialog boxes, and parent other windows. It is surrounded by a standard border and affordances provided by your window system to manipulate the window's size, location, and appearance on the screen.

The AVM automatically creates one default window for each session. You can create additional dynamic windows with the CREATE widget statement. Each additional window can be parented by the window system, creating siblings (the default) or by another window, creating child and parent window relationships. You create a parent and child relationship between two windows by setting the PARENT attribute of one (the child) to the handle of the other (the parent).

Windows in a parent and child relationship form a window family, which is a hierarchy of parent and child windows ultimately parented by the window system. The top parent window that is parented by the window system is the root window of the window family.

The following figure shows a window family consisting of a root window and its child window:





Attributes

ALWAYS-ON-TOP attribute BGCOLOR attribute COLUMN attribute
CONTEXT-HELP attribute CONTEXT-HELP-FILE attribute CONTROL-BOX attribute
DCOLOR attribute DROP-TARGET attribute DYNAMIC attribute
FGCOLOR attribute FIRST-CHILD attribute FONT attribute
FULL-HEIGHT-CHARS attribute FULL-HEIGHT-PIXELS attribute FULL-WIDTH-CHARS attribute
FULL-WIDTH-PIXELS attribute HANDLE attribute HEIGHT-CHARS attribute
HEIGHT-PIXELS attribute HIDDEN attribute HWND attribute
ICON attribute INSTANTIATING-PROCEDURE attribute KEEP-FRAME-Z-ORDER attribute
LAST-CHILD attribute MAX-BUTTON attribute MAX-HEIGHT-CHARS attribute
MAX-HEIGHT-PIXELS attribute MAX-WIDTH-CHARS attribute MAX-WIDTH-PIXELS attribute
MENU-BAR attribute MENU-KEY attribute MENU-MOUSE attribute
MESSAGE-AREA attribute MESSAGE-AREA-FONT attribute MIN-BUTTON attribute
MIN-HEIGHT-CHARS attribute MIN-HEIGHT-PIXELS attribute MIN-WIDTH-CHARS attribute
MIN-WIDTH-PIXELS attribute MOUSE-POINTER attribute NAME attribute
NEXT-SIBLING attribute NUM-DROPPED-FILES attribute NUM-SELECTED-WIDGETS attribute
PARENT attribute PFCOLOR attribute POPUP-MENU attribute
PREV-SIBLING attribute PRIVATE-DATA attribute RESIZE attribute
ROW attribute SCREEN-LINES attribute SCROLL-BARS attribute
SENSITIVE attribute SHOW-IN-TASKBAR attribute SMALL-ICON attribute
SMALL-TITLE attribute STATUS-AREA attribute STATUS-AREA-FONT attribute
THREE-D attribute TITLE attribute TOP-ONLY attribute
TYPE attribute VIRTUAL-HEIGHT-CHARS attribute VIRTUAL-HEIGHT-PIXELS attribute
VIRTUAL-WIDTH-CHARS attribute VIRTUAL-WIDTH-PIXELS attribute VISIBLE attribute
WIDTH-CHARS attribute WIDTH-PIXELS attribute WINDOW attribute
WINDOW-STATE attribute X attribute Y attribute

Methods

END-FILE-DROP( ) method GET-DROPPED-FILE( ) method
GET-SELECTED-WIDGET( ) method LOAD-ICON( ) method
LOAD-MOUSE-POINTER( ) method LOAD-SMALL-ICON( ) method
MOVE-TO-BOTTOM( ) method MOVE-TO-TOP( ) method

Events

Developer events Mouse events
Universal key function events DROP-FILE-NOTIFY
ENTRY LEAVE
PARENT-WINDOW-CLOSE WINDOW-CLOSE
WINDOW-MAXIMIZED WINDOW-MINIMIZED
WINDOW-RESIZED WINDOW-RESTORED

Notes

  • In character user interfaces, you can have only one window (the default window).
  • Certain manipulations of a parent window have a default effect on its child windows and their descendants. You cannot modify the following effects:
    • Iconifying a window (triggered by a WINDOW-MINIMIZED event or by setting the WINDOW-STATE attribute to WINDOW-MINIMIZED) causes any of its descendant windows that are not already iconified to be hidden. Any child windows that are already iconified remain iconified along with their parents. Restoring the parent window (triggered by a WINDOW-RESTORED event) causes all of its descendant windows to receive a WINDOW-RESTORED event, restoring them to their visual state prior to the parent window being minimized.
    • When a window receives a WINDOW-MINIMIZED event, all of its descendant windows receive WINDOW-MINIMIZED events. When a window receives a WINDOW-RESTORED event, all of its descendant windows receive WINDOW-RESTORED events.
    • Applying a WINDOW-CLOSE event to a window causes all of its descendant windows to receive a PARENT-WINDOW-CLOSE event. However, any ancestor windows remain unaffected.
  • A WINDOW-MINIMIZED or WINDOW-RESTORED event applied to a child window has no effect on its parent or ancestor windows.
  • Resizing or changing the position of a window has no affect on the size or position of any descendants or ancestors of that window.
  • The following attributes have the Unknown value (?) until the window is realized:
    • FULL-HEIGHT-CHARS attribute
    • FULL-HEIGHT-PIXELS attribute
    • FULL-WIDTH-CHARS attribute
    • FULL-WIDTH-PIXELS attribute
  • If you embed the window in an OpenEdge .NET form, by setting the form's EmbeddedWindow property to the ABL window handle, some attributes and methods of the window are either ignored or change function. For more information, see the EmbeddedWindow property reference entry.

See also

CREATE widget statement, DIALOG-BOX widget