outline

Class

The class of an outline control.

Control

Instance of the outline class. This control acts as a multiple-item
list, with added functionality to display its items in a hierarchy and
to display only selected subtrees of the hierarchy. The items
displayed are instances of the outline-item class.

The outline can be navigated via the arrow keys and the PAGE UP/PAGE
DOWN keys. Scrollbars appear along the length of the control when the
list exceeds the size of the frame.

Adding an outline control to your form

Click the outline tool on the Component toolbar. Move the mouse cursor
to the part of the form where you want to place the control, and click
again. The control will appear with colored resizing handles.

Resizing and moving the control

Controls can only be resized and moved on forms during the design
stage; the size and location of everything is fixed on a running form.

Resize the control by clicking the mouse cursor and dragging one of
the handles to the new size-point. Release the mouse key when you are
satisfied with the new size. Note: resizing the outline won't mean
proportional changes in the size of the characters inside the
list. Change the font property if you want to change
the size of the actual characters displayed.

Move the control by clicking anywhere on it except a resizing handle
and dragging it to a new location on the form. Release the mouse key
when you are ready to place the control.

Creating an outline widget programmatically

Here is an example of writing code from scratch to create an outline
widget, rather than building one interactively on a form. The keyword
arguments here such as :range correspond to
properties such as the range
property that would be displayed in the inspector for an outline on a
form, and which you can modify by calling (setf range).

The nested tree of :range arguments shown here
demonstrates how to specify the whole tree of outline-items at once; an alternative is to
write range-on-open methods
that create each item's child items lazily when the item is opened by
the user. Another alternative would be to call (setf range) on
individual outline-item objects. For more complete examples, see the
"Outline Widget" examples in the Navigator Dialog.