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-File7.7.17  vrq_locator                                                TOS

 Name:         »Input Locator, Request Mode« - ermittel die 
               Mausposition, wenn eine Taste gedrückt wurde.

 VDI-Nummer:   28

 Deklaration:  void vrq_locator ( int16_t handle, int16_t x, int16_t 
               y, int16_t *xout, int16_t *yout, int16_t *term );

 Beschreibung: Die Funktion ermittelt bzw. setzt die Position des 
               Grafik-Cursors. Es gilt:

                Parameter  Bedeutung

                handle     Kennung der Workstation
                x          x-Koordinate
                y          y-Koordinate des Grafikcursors
                xout       x-Koordinate
                yout       y-Koordinate des Grafikcursors bei der 
                           Rückgabe
                term       im Low-Byte wird der Code der Abbruch-Taste 
                           eingetragen. Dies ist normalerweise der 
                           ASCII-Code. Spezielle Werte wie z.B. die 
                           Maustasten erhalten jedoch Werte ab 32 und 
                           können so nicht direkt von Tasten der 
                           Tastatur unterschieden werden.

               Das Ergebnis erhält der Benutzer erst, wenn eine Taste 
               gedrückt wird. Der Grafikcursor wird stets an der 
               angegebenen Position in der aktuellen Form auf dem 
               Bildschirm sichtbar. Zu beachten ist, daß jede 
               beliebige Taste (also auch die Maustasten) gedrückt 
               werden darf.

               Normalerweise erfolgt eine Bewegung des Grafikcursors 
               in großen Schritten, wenn die Cursortasten gedrückt 
               werden, bzw. in kleinen Schritten, wenn diese in 
               Verbindung mit der Shift-Taste gedrückt werden. Auf dem 
               Atari wird jedoch zusätzlich die Alternate-Taste 
               benötigt.

 Ergebnis:     Die Funktion liefert kein Ergebnis.

 Verfügbar:    Die Funktion wird nicht von allen Gerätetreibern 
               unterstützt. Die Eingabefunktionen des VDI arbeiten nur 
               auf der physikalischen Workstation, die im Normalfall 
               von den AES benutzt wird.

 Gruppe:       Eingabefunktionen

 Querverweis:  Binding   vsm_locator   vsin_mode