Topic       : TOS - The Operating System
Author      : 
Version     : tos.hyp (December 19, 2008)
Subject     : Programmieren/Atari
Nodes       : 3010
Index Size  : 93790
HCP-Version : 5
Compiled on : Atari
@charset    : atarist
@lang       : 
@default    : Title
@help       : 
@options    : +g -i -s +x +zz -t4
@width      : 70
View Ref-File8.2.9.1  Redraw and updating of toolbars                           TOS

For redraws of (parts of) the toolbar, one has to pay respect to the 
rectangle-list as usual. As the previous wind_get opcodes WF_FIRSTXYWH 
and WF_NEXTXYWH only respect the working area of a window, however, 
two new parameters (WF_FTOOLBAR and WF_NTOOLBAR) were introduced, with 
whose help the rectangle-list of a toolbar can be interrogated.

A redraw of (parts of) the toolbar may be necessary in the following 
situations:

   . The toolbar contains user-defined objects (USERDEF's).
   . The status of an object in the toolbar was altered. The area to 
     be redrawn here consists of the size of the object plus the space 
     required for special effects (3D, shadowing, outlining etc.).

Redraw is not necessary in the following cases, for instance:

   . The relevant window is iconified. The application does not have 
     to take on any management of the toolbar; this is only required 
     at the restoration of the iconification, the so-called uniconify.
   . The toolbar present in the window is to be replaced by another 
     one. In this case a call of wind_set with the opcode WF_TOOLBAR 
     and the address of the new OBJECT tree will suffice.
   . The toolbar present in the window is to be removed. In this case 
     a call of wind_set with the opcode WF_TOOLBAR and NULL parameters 
     will suffice.

See also: Rectangle-list of a window   Toolbar support