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.19  vrq_string                                                 TOS

 Name:         »Input String, Request Mode« - liest einen String im 
               REQUEST-Modus ein.

 VDI-Nummer:   31

 Deklaration:  void vrq_string ( int16_t handle, int16_t max_length, 
               int16_t echo_mode, int16_t *echo_xy, int8_t *string );

 Beschreibung: Die Funktion liest einen String von der Tastatur ein, 
               wobei optional ein Echo auf dem Bildschirm erfolgen 
               kann. Es gilt:

                Parameter  Bedeutung

                handle     Kennung der Workstation
                max_length maximale Länge des Strings
                echo_mode  Modus
                            0 = kein Echo
                            1 = Echo benutzen
                echo_xy[0] x-Koordinate
                echo_xy[1] y-Koordinate für den Startpunkt der 
                           Echoausgabe
                string     Adresse der Zeichenkette

               Die Echoausgabe ist nicht auf allen Geräten verfübar; 
               im Falle eines Echos werden die Text-Attribute jedoch 
               berücksichtigt.

               Ist max_length negativ, so wird der Absolutbetrag als 
               Länge betrachtet, und statt der ASCII-Codes werden 
               Scan-Codes übergeben.

               Hinweis: Die Eingabefunktionen des VDI arbeiten nur auf 
               der physikalischen Workstation, die im Normalfall von 
               den AES benutzt wird.

 Ergebnis:     Die Funktion liefert kein Ergebnis.

 Verfügbar:    This call is not guaranteed to be available with any 
               driver and its use should therefore be restricted.

 Gruppe:       Eingabefunktionen

 Querverweis:  Binding   vswr_mode   vs_color   vst_alignment 
               vst_height   vst_point   vst_rotation   vst_font 
               vst_color   vst_effects   vsm_string