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.11.3  form_center                                                TOS

 Name:         »Form centered object« - Centre an object on the 
               screen.

 Opcode:       54

 Syntax:       int16_t form_center ( OBJECT *fo_ctree, int16_t *fo_cx, 
               int16_t *fo_cy, int16_t *fo_cw, int16_t *fo_ch );

 Description:  The call form_center modifies an object's coordinates 
               so that it will appear at the centre of the display 
               screen, and returns the actual position of the object. 
               The following apply:

                Parameter  Meaning

                fo_ctree   Address of the object tree
                fo_cx      X-coordinate, and
                fo_cy      Y-coordinate of top left of object
                fo_cw      Width, and
                fo_ch      Height of object (each centred)

               Note: The function also takes special attributes of the 
               object into account, such as OUTLINED, for instance 
               (but not SHADOWED).

               As of PC-GEM/3 the object tree is no longer centred in 
               the Y-direction on the whole screen. The reason given 
               for this is that users of large screen monitors would 
               otherwise have to cover too large a distance from the 
               menu bar to the object (perhaps a dialog box).

 Return value: The return value is always 1.

 Availability: All AES versions.

 Group:        Form library

 See Also:     Binding   x_form_center   OBJECT   objc_offset