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.6.39  vqt_extent                                                 TOS

 Name:         »Inquire Text Extent« - ermittelt die Länge eines 
               Strings.

 VDI-Nummer:   116

 Deklaration:  void vqt_extent ( int16_t handle, int8_t *string, 
               int16_t *extent );

 Beschreibung: Die Funktion ermittelt die Ausmaße eines minimalen 
               Rechteckes, das einen Text unter Beachtung der 
               Textattribute voll umgibt.

               Beispiel:


               Der Funktion werden folgende Parameter übergeben:

                Parameter  Bedeutung

                handle     Kennung der Workstation
                string     Adresse der Zeichenkette
                extent[0]  x-Koordinate
                extent[1]  y-Koordinate der unteren linken Ecke
                extent[2]  x-Koordinate
                extent[3]  y-Koordinate der unteren rechten Ecke
                extent[4]  x-Koordinate
                extent[5]  y-Koordinate der oberen rechten Ecke
                extent[6]  x-Koordinate
                extent[7]  y-Koordinate der oberen linken Ecke

               Hinweis: Bei Vektorfonts addiert diese Funktion nur die 
               Schrittweiten, ohne Pair- oder Track-Kerning und 
               Zeichenüberhänge zu beachten. Aus diesem Grund sollte 
               ggfs. auf die Funktion vqt_real_extent zurückgegriffen 
               werden.

               In alten GEM-Versionen arbeitet die Funktion übrigens 
               nicht korrekt, falls die Zeichenkette Umlaute enthält, 
               da alte GEM-Versionen mit diesen noch nicht umgehen 
               konnten.

 Ergebnis:     Die Funktion liefert kein Ergebnis.

 Verfügbar:    Supported by all drivers.

 Gruppe:       Auskunftsfunktionen

 Querverweis:  Binding   vst_height   vst_point   vst_rotation 
               vst_font   vst_effects   vqt_f_extent   vqt_real_extent