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.16.8  objc_order                                                 TOS

 Name:         »Object order« - Alter order of object in object tree.

 Opcode:       45

 Syntax:       int16_t objc_order ( OBJECT *ob_ortree, int16_t 
               ob_orobject, int16_t ob_ornewpos );

 Description:  The call objc_order alters the position of an object 
               relative to other child objects of the same parent 
               within a sub-tree. The following apply:

                Parameter    Meaning

                ob_ortree    Address of the object tree
                ob_orobject  Index of the relevant object
                ob_ornewpos  New position in tree, namely:
                              -1  =  At the end (last child) 
                               0  =  At the start (first child) 
                               1  =  In the second position (2nd child) 
                               2  =  In the third position (etc.) 


               Note: This call does not move the structure elements in 
               memory, but updates the OBJECT tree's ob_head, ob_tail 
               and ob_next fields, thus 'moving' the OBJECT in the 
               tree hierarchy.

 Return value: An error has arisen only if the value 0 is returned.

 Availability: All AES versions.

 Group:        Object library

 Querverweise: Binding   OBJECT