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.6.16  edit_resized                                               TOS

 Name:         »Edit Object Resized« - Alter settings: Object size

 Opcode:       217 (sub-opcode 6)

 Syntax:       int16_t edit_resized ( OBJECT *tree, int16_t obj, 
               int16_t *oldrh, int16_t *newrh );

 Description:  The call edit_resized alters the height of an editable 
               object. The following apply:

                Parameter  Meaning

                tree       RSC-tree of object
                obj        Object index
                oldrh      Old net height of object
                newrh      New net height of object

               For changes of the object size the editable object must 
               release and reserve memory. Thus it is possible that in 
               extreme circumstances the operation fails due to a 
               shortage of memory. In that case the return value is 0. 
               So that the calling program can execute a correct 
               redraw, the previous and new actual height is returned. 
               In fact it means here the number of visible lines 
               multiplied by the line height, i.e. the object height 
               without the unused bottom white border.

 Return value: 1 (OK) or 0 (error)

 Availability: As of MagiC 5.20 by means of a shared library.

 Group:        Editable object functions

 See Also:     Binding