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.12.4  graf_mbox/graf_movebox                                     TOS

 Name:         »Graphics move box« - Move a rectangle with the mouse.

 Opcode:       72

 Syntax:       int16_t graf_movebox ( int16_t gr_mwidth, int16_t 
               gr_mheight, int16_t gr_msourcex, int16_t gr_msourcey, 
               int16_t gr_mdestx, int16_t gr_mdesty );

               or

               int16_t graf_mbox( ... )

 Description:  The call graf_movebox draws a rectangle of constant 
               size that moves with the mouse pointer, and is used to 
               give the user a visual 'clue' to an action undertaken 
               by an application. The following apply:

                Parameter    Meaning

                gr_mwidth    Width, and
                gr_mheight   Height of the rectangle
                gr_msourcex  X-coordinate, and
                gr_msourcey  Y-coordinate of top left corner at start
                gr_mdestx    X-coordinate, and
                gr_mdesty    Y-coordinate of top left corner at end

               Note: The function can be used, for instance, when the 
               movement of an icon is not permitted (e.g. dragging the 
               printer icon onto the wastebasket icon) and so it is to 
               be placed back at its original position.

               In older GEM documentation this function is also called 
               'graf_mbox'!

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

 Availability: All AES versions.

 Group:        Graphics library

 See Also:     Binding