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.6  objc_find                                                  TOS

 Name:         »Object find« - Find which object lies at the specified 
               screen position.

 Opcode:       43

 Syntax:       int16_t objc_find ( OBJECT *ob_ftree, int16_t 
               ob_fstartob, int16_t ob_fdepth, int16_t ob_fmx, int16_t 
               ob_fmy );

 Description:  The call objc_find determines which object is found at 
               given screen coordinates. The following apply:

                Parameter    Meaning

                ob_ftree     Address of the relevant object tree
                ob_fstartob  Index of the object at which the search 
                             is to start
                ob_fdepth    Number of generations that are to be 
                             searched (0 = parent object only), 7 max.
                ob_fmx       X-coordinate, and
                ob_fmy       Y-coordinate of screen position to search

 Return value: The object index found at the coordinates ob_fmx, 
               ob_fmy (or -1 for 'no object found').

 Availability: All AES versions.

 Group:        Object library

 Querverweise: Binding   OBJECT   objc_xfind