WINDOW widget

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-MAXIMIZED1	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