Other object functions



dispose ()
     Description:
       Finishes and frees the memory for an object and all
       its sub-objects.

     Syntax:
       t_object*  dispose ( t_object *o );

     Parameters:
       o           The object to dispose.

     Returns:
       The empty object.



dispose_all ()
     Description:
       Finishes an object and all its sub-objects but only frees
       the memory for the sub-object.

     Syntax:
       void  dispose_all ( t_object *o );

     Parameters:
       o           The object to dispose.

     Returns:
       -



init_stillprocess ()
     Description:
       Sets object to call a callback function with a defined frequency.

     Syntax:
       void  init_stillprocess ( p_object o, l_int milis );

     Parameters:
       o           Object to set.
       milis       Sets the time in milliseconds between the calls to
                   your "o->func_callback()" function. Options of this
                   object is set to OB_OF_STILLPROCESS. 

     Returns:
       -



done_stillprocess ()
     Description:
       Turns of the calls to the callback function set with the
       init_stillprocess() function and resets the object to its
       old status.

     Syntax:
       void  done_stillprocess ( p_object o );

     Parameters:
       o           Object to set.

     Returns:
       -



set_event ()
     Description:
       Sets an event.

     Syntax:
       void  set_event ( t_event *event, l_dword type, 
                         l_dword message, p_object obj );

     Parameters:
       event       Event to set.
       type        Type of the event.
       message     The message to send.
       obj         Object to set the event from.

     Returns:
       -



set_event_info ()
     Description:
       Sets an event.

     Syntax:
       void  set_event_info ( t_event *event, l_dword type, 
                              l_dword message, p_object obj, void *rec );

     Parameters:
       event       Event to set.
       type        Type of the event.
       message     The message to send.
       obj         Object to set the event from.
       rec         "event->info" will be set to this value.

     Returns:
       -



message_all_info ()
     Description:
       Sets an event and calls all the objects in the hierarchy
       with this from the top object (the program).

     Syntax:
       void  message_all_info ( l_dword type, l_dword message, 
                                p_object obj, void *info );

     Parameters:
       type        Type of the event.
       message     The message to send.
       obj         Object to set the event from.
       info        Info to send.

     Returns:
       -



message_info ()
     Description:
       Sets an event and calls only the object and its sub-objects.

     Syntax:
       void  message_info ( p_object o, l_dword type, l_dword message,
                            p_object obj, void *info );

     Parameters:
       o           Object with sub-objects to call.
       type        Type of the event.
       message     The message to send.
       obj         Object to set the event from.
       info        Info to send.

     Returns:
       -



message ()
     Description:
       Sets an event and calls only the object and its sub-objects.
       Same as message_info() but with "info" set to ZERO.

     Syntax:
       void  message ( p_object o, l_dword type, l_dword message, 
                       p_object obj);

     Parameters:
       o           Object with sub-objects to call.
       type        Type of the event.
       message     The message to send.
       obj         Object to set the event from.

     Returns:
       -



message_all ()
     Description:
       Sets an event and calls all the objects in the hierarchy
       with this from the top object (the program). Same as 
       message_all_info() but with "info" set to ZERO.

     Syntax:
       void    message_all ( l_dword type, l_dword message, 
                             p_object obj );

     Parameters:
       type        Type of the event.
       message     The message to send.
       obj         Object to set the event from.

     Returns:
       -



obj_exist ()
     Description:
       Determines wether an object exists or not.

     Syntax:
       l_int  obj_exist ( p_object o );

     Parameters:
       o           The object to check.

     Returns:
       Zero if the object is disposed, -1 if object is NULL
       and any other value if it exists.