Topic       : The GFA-Basic Compendium
Author      : GFA Systemtechnik GmbH
Version     : GFABasic.HYP v2.98 (12/31/2023)
Subject     : Documentation/Programming
Nodes       : 899
Index Size  : 28056
HCP-Version : 3
Compiled on : Atari
@charset    : atarist
@lang       : 
@default    : Document not found
@help       : Help
@options    : +g -i -s +z
@width      : 75
@hostname   : STRNGSRV
@hostname   : CAB     
@hostname   : HIGHWIRE
@hostname   : THING   
View Ref-FileOBJC_CHANGE(tree,obj,res,cx,cy,cw,ch,new_status,re_draw)

tree, obj, res, cx, cy, cw, ch, new_status, re_draw: iexp

This function changes the status of an object (OB_STATE) and, if necessary,
inverts (displays in inverse video) that section of the object lying inside the
clipping rectangle. (Normally OB_STATE would be changed directly and the object
redrawn with OBJC_DRAW().)

Returns 0 if an error occured.

    tree       - Address of the object tree.
    obj        - Number of the object to be changed.
    res        - Reserved (always 0).
    cx         - x-coordinate of the top left corner of clipping rectangle
    cy         - y-coordinate of the top left corner of clipping rectangle
    cw         - Width of clipping rectangle
    ch         - Height of clipping rectangle.
    new_status - New object status (see OB_STATE())
    re_draw    - 0: Do not redraw object
                 1: Redraw object

Memo: This call only updates the state. This will appear to fail:
      CHAR{OB_SPEC(tree%,obj&}="blah..." !this change won't be seen
      ~OB_CHANGE(tree%,obj&,0,x&,y&,w&,h&,&X1,1) !object will be selected
      ' however, if you call objc_draw() the new text string will be seen
      ' tested under SingleTOS and N.Aes

objc_change()+