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-Fileobjc_draw()
Form Library
form_center()                                                           AES

Syntax

WORD form_center( tree, x, y, w, h )
OBJECT *tree;
WORD *x, *y, *w, *h;

Function       form_center() is used to modify an object's coordinates so
               that it will appear in the center of the display screen.

Opcode         54 (0x36)

Availability   All AES versions.

Parameters     tree points to a valid OBJECT structure (see discussion of
               resources) which the application wishes to have centered.
               x, y, w, and h, return a clipping rectangle suitable for
               use in objc_draw().

Binding        addrin[0] = tree;

               crys_if(0x36);

               *x = intout[1];
               *y = intout[2];
               *w = intout[3];
               *h = intout[4];

               return intout[0];

Return Value   The return value is currently reserved. Currently it equals
               1.

Comments       The values that form_center() returns in x, y, w, and h,
               are not necessarily the same as the object's. These values
               take into account negative borders, outlining, and
               shadowing. This is meant to provide a suitable clipping
               rectangle for objc_draw()

See Also       objc_draw()

Group          Form Library