Frame Class

The Frame control provides a way of grouping controls in a container, aligning the frame positionally or by size within its container, and for the use of three-dimensional effects.

Frame text is displayed in the area bounded by the three-dimensional (3D) borders. If the borders are too large, the text area of the frame may not exist and no text is displayed.

The StatusLine control is a variation on the Frame control.

The frame can be a container for groups of controls. Use a frame or a group box when multiple groups of option buttons are required on the same form. An option button toggles other option buttons within the same container.

The frame (and the status line control) has several custom properties that enable you to adjust the three-dimensional appearance of the control.

To add controls to a frame

  1. Select the frame in the Painter.

  2. Draw the new controls inside the frame.

When the frame is moved, all of the child controls move with it. The top and left position of the child controls are relative to the internal area of the frame (that is, the client area).

For details about three-dimensional effects, see "Three-Dimensional Effects in Frame Controls", in the following subsection. For details about docking frame controls, see the JadeDockBar, JadeDockBase, and JadeDockContainer classes, later in this document.

For a summary of the constants, properties, methods, and events defined in the Frame class, see "Frame Class Constants", "Frame Properties", "Frame Methods", and "Frame Events", later in this section.