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-FileObject Library
objc_order()                                                            AES

Syntax

WORD objc_order( tree, obj, pos )
OBJECT *tree;
WORD obj, pos;

Function       objc_order() changes the position of an object relative to
               other child objects of the same parent.

Opcode         45 (0x2D)

Availability   All AES versions.

Parameters     tree specifies the object tree of object obj which is to be
               moved. pos specifies the new position of the object as
               follows:

                Name      Pos   Meaning

                OO_LAST    -1   Make object the last child.

                OO_FIRST   0    Make object the first child.

                -          1    Make object the second child.

                -          2-   etc...

Binding        intin[0] = obj;
               intin[1] = pos;

               addrin[0] = tree;

               return crys_if(0x2D);

Return Value   objc_order() returns 0 if an error occurred or non-zero
               otherwise.

Comments       objc_order() does not actually move structure elements in
               memory. It works by updating the OBJECT tree's ob_head,
               ob_tail, and ob_next fields to 'move' the OBJECT in the tree
               hierarchy.

Group          Object Library