Topic       : TOS - das Betriebssystem
Author      : 
Version     : tos.hyp (5. März 2013)
Subject     : Programmieren/Atari
Nodes       : 3001
Index Size  : 93602
HCP-Version : 5
Compiled on : Atari
@charset    : atarist
@lang       : 
@default    : Titel
@help       : 
@options    : +g -i -s +x +zz -t4
@width      : 70
View Ref-File8.12.8  graf_rubberbox                                             TOS

 Name:         »Graphics Rubberbox« - zeichnet eine 'Rubberbox' 
               (Gummirechteck) auf den Bildschirm.

 AES-Nummer:   70

 Deklaration:  int16_t graf_rubberbox ( int16_t gr_rx, int16_t gr_ry, 
               int16_t gr_minwidth, int16_t gr_minheight, int16_t 
               *gr_rlastwidth, int16_t *gr_rlastheight );

               oder

               int16_t graf_rubbox ( ... );

 Beschreibung: Die Funktion stellt ein Gummiband in Form eines 
               Rechtecks auf dem Bildschirm dar, dessen obere linke 
               Ecke festbleibt und dessen untere rechte Ecke solange 
               bewegt werden kann, wie die linke Maustaste gedrückt 
               wird.

                Parameter       Bedeutung

                gr_rx           x-Koordinate
                gr_ry           y-Koordinate der linken, oberen Ecke
                gr_minwidth     kleinste Breite des Gummibandes
                gr_minheight    kleinste Höhe des Gummibandes
                gr_rlastwidth   Breite
                gr_rlastheight  Höhe des Gummibandes bei Loslassen des 
                                Mausknopfs

               Hinweis: Die Funktion sollte aus den o.g. Gründen nur 
               bei bereits gedrückter Maustaste aufgerufen werden. 
               Interessant ist, daß bei der Angabe der minimalen 
               Breite und Höhe auch negative Werte zugelassen sind; 
               das Gummiband läßt sich dann von rechts unten nach 
               links oben ziehen.

               In älteren GEM-Dokumentationen auch häufig als 
               "graf_rubbox" bezeichnet!

 Ergebnis:     Ein Fehler ist nur dann aufgetreten, wenn als Ergebnis 
               0 zurückgegeben wird.

 Verfügbar:    All AES versions.

 Gruppe:       Grafikfunktionen

 Querverweis:  Binding