drawWindow

Type: Integer

Availability: Read or write at run time only

By default, any drawing on a control or window is done within the client area of the form or control. The client area is that part of the area inside the borders, scroll bars, and so on. The coordinates for the drawing are relative to the left, top, width, and height of this client area.

Change the value of the drawWindow property of the Window class to 1, so that the entire surface of the form or control can be drawn on. The coordinates for the drawing are then relative to the left, top, width, and height of the entire window.

The default setting of zero (0) indicates a client area window.

A setting of 1 indicates that drawing is to cover the entire form or control window. Drawing on the entire surface, however, has the following limitations.

• The clipControls property has no effect on the drawing process. The drawing covers any other window at the drawn positions.

• The drawing coordinates are not affected by the scroll bar positions of the window.

• Scrolling the window still scrolls any drawing present on that window, as the scrolling process causes only a repaint of any uncovered area.

• Non-client areas (for example, borders or scroll bars) are drawn by a separate window event, which is not available to the Jade developer. Redrawing the non-client area is not necessarily accompanied by a normal paint event.