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.11.11  form_xdial                                                TOS

 Name:         »Form XDialog Space« - reserviert oder gibt 
               Speicherplatz frei für ein Dialogobjekt.

 AES-Nummer:   51

 Deklaration:  int16_t form_xdial ( int16_t fo_diflag, int16_t 
               fo_dilittlx, int16_t fo_dilittly, int16_t fo_dilittlw, 
               int16_t fo_dilittlh, int16_t fo_dibigx, int16_t 
               fo_dibigy, int16_t fo_dibigw, int16_t fo_dibigh, void 
               **flydial );

 Beschreibung: Die Funktion übernimmt abhängig von den übergebenen 
               Parametern verschiedene Aufgaben. Es gilt:

                Parameter    Bedeutung

                fo_diflag    0 = FMD_START reserviert 
                             Bildschirmspeicher für den Dialog.
                             3 = FMD_FINISH restauriert den Bildschirm 
                             und gibt den Puffer mit dem geretteten 
                             Hintergrund wieder frei.
                fo_dilittlx  x und y Koordinate,
                fo_dilittly  Breite und Höhe,
                fo_dilittlw  des kleinsten sich ausdehnenden bzw.
                fo_dilittlh  schließenden Rechtecks.
                fo_dibigx    x und y Koordinate,
                fo_dibigy    Breite und Höhe,
                fo_dibigw    des größten sich ausdehnenden bzw.
                fo_dibigh    schließenden Rechtecks.
                flydial      siehe unten

               Hinweis: Wenn flydial ungleich 0 ist, wird getestet, ob 
               genügend Speicher zur Verfügung steht, um den 
               Hintergrund der Dialogbox zu retten. Ein Zeiger auf die 
               geretteten Daten wird dann in dieser Variablen 
               vermerkt. Falls nicht genügend Speicher zur Verfügung 
               steht, um den Hintergrund zu retten, ist die per 
               form_xdo zu bearbeitende Dialogbox nicht verschiebbar; 
               in diesem Fall wird auch keine 'Flugecke' im Dialog 
               angezeigt.

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

 Verfügbar:    Das Vorhandensein der Flydials kann per appl_getinfo 
               (Opcode 14) abgefragt werden.

 Gruppe:       Formulare

 Querverweis:  Binding   evnt_mesag   form_dial   graf_growbox 
               graf_shrinkbox