Window Class

The Window class is the abstract superclass of all Form and Control classes. The Window class provides properties and methods that apply to all forms and controls; for example, all graphical properties and methods are defined at the Window class level and therefore apply to any form or control. You cannot add a subclass to the Window class.

The backColor and borderStyle properties may have no effect in certain controls but are defined for internal reasons; for example, showing three-dimensional effects. For example, the borderStyle property has no meaning for a scroll bar control, as that control always has a border.

A local variable can be described as a window in logic and access all properties and methods of the Window class.

Window, Form, and Control methods and events cannot be invoked from a server method.

JADE supports mouse wheel requests, as follows.

If the window under the mouse has a vertical scroll bar, the mouse wheel request is treated the same as a scroll bar line up or line down, depending on the way that the wheel is turned (that is, the scroll wheel is treated the same as clicking on the up or down arrow of the scroll bar).
If the window under the mouse has no vertical scroll bar but has a horizontal scroll bar, the mouse wheel request is treated the same as a scroll bar line left or line right, depending on the way that the wheel is turned (that is, the scroll wheel is treated the same as clicking on the left or right arrow of the scroll bar).
If the window under the mouse does not have scroll bars, the window that has focus or the first parent of that window with a scroll bar is scrolled.

If the window has a vertical scroll bar, the mouse wheel request is treated the same as a scroll bar line up or line down, depending on the way that the wheel is turned. If the window (or its parent) has no vertical scroll bar but has a horizontal scroll bar, the mouse wheel request is treated the same as a scroll bar line left or line right, depending on the way that the wheel is turned.

When a control receives focus and it is not within the visible region of a container (or containers) control that has scroll bars (for example, a BaseControl or Picture control), the container is automatically scrolled to bring the control into view. The scroll events for the container (or containers) are also called for this process. The position of children within a ListBox, Table, or TextBox control remains absolute and is not affected by any scrolling within those controls.

The automatic scrolling of a control into view does not occur if the focus is received as result of a mouse click (that is, if the window is only partially visible, clicking on it does not cause the window to move to show more of the window).

When multiple monitors are running on one workstation, the following points apply. (For details about terminating GUI applications with no visible forms when running multiple desktops, see "Showing an Invisible Form", in Chapter 1 of the JADE Runtime Application Guide.)

JADE handles only the first nine monitors running on one workstation. Additional monitors are ignored.
The Window::getDeskTopWorkArea method returns the available desktop area of the primary monitor.
When a form is created, it is created in the monitor area of the control with the current focus. If no control has focus, the form is created in the same monitor as the mouse.

If the control that has focus spans multiple monitors, the monitor containing the greater area of the control that has focus is used. If the window does not fall within the bounds of any monitor, the primary monitor is used.

By default, Microsoft Windows displays a message box on the monitor where the application last had focus.
The Form::centreWindow method centers a non-MDI form within the monitor on which the form resides. An MDI child form continues to be centered within the client area of its parent MDI frame.
The Window::getMonitorArea method returns the full area of the current monitor on which the window resides and the Window::getMonitorWorkArea method returns the position of the available desktop area of the monitor on which the window resides.
When a form is saved in the JADE Painter, the values of the left and top properties are converted to be relative to the top and left positions of the primary monitor.

For the arrays associated with control and menu item children (for example, the Window class allControlChildren and MenuItem class children properties), the only methods that are implemented are at (which allows the use of square brackets to access the elements), createIterator (which allows logic to do a foreach over the array), size, and size64.

For a summary of the constants, properties, and methods defined in the Window class, see "Window Class Constants", "Window Properties", and "Window Methods", in the following subsections. For details about the graphics properties and methods defined in the Window class, see "Graphics Properties and Methods", later in this document.

For details of system classes and their associated constants, properties, methods, and events, see "System Classes", in Chapter 1. For details about primitive types and their associated methods, see "Primitive Types", in Chapter 1 of the JADE Encyclopaedia of Primitive Types.

Object

Control, Form