Topic       : The ATARI Compendium
Author      : Scott Sanders / JAY Software
Version     : 1.25 (20/6/2003)
Subject     : Documentation
Nodes       : 1117
Index Size  : 32614
HCP-Version : 6
Compiled on : Atari
@charset    : UTF-8
@lang       : en
@default    : 
@help       : %About
@options    : +g -i -t4 +y +z
@width      : 100
View Ref-File
                                 Toolboxes


Toolboxes are groups of buttons (usually G_IMAGE or G_ICON) which
either select between editing modes (often in graphic editors or DTP
applications) or choose object properties. A toolboxes may be contained
in its own window or appear 'attached' in the document window aligned
with the upper-left corner of the work area. A toolbox in its own
window should have its 'un-toppable' characteristic set under MultiTOS
(see wind_set()) to prevent the user from having to click twice to
select a button.

Buttons on these specialized dialog/window combinations fall into
three categories, exclusive buttons (such as a pointer tool and
rectangle tool), non-exclusive buttons (such as zoom on/off), and style
buttons (such as fill style and line style).

Buttons should reflect their state by appearing either inverted or
depressed. The currently selected exclusive button as well as any
selected non-exclusive button retains this state until a new object is
chosen or it is deselected. Style buttons are only selected until the
user has completed the operation. When available, toolbox buttons
should appear in color using a G_CICON. An example of a toolbox window
follows: