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.8.9  wdlg_open                                                   TOS

 Name:         »WindowDialog Open« - öffnet einen Fensterdialog.

 AES-Nummer:   161

 Deklaration:  int16_t wdlg_open ( DIALOG *dialog, int8_t *title, 
               int16_t kind, int16_t x, int16_t y, int16_t code, void 
               *data );

 Beschreibung: Die Funktion öffnet einen Fensterdialog auf dem 
               Bildschirm. Es gilt:

                Parameter  Bedeutung 
                dialog     Zeiger auf den Dialog 
                title      Fenstername oder NULL 
                kind       Komponenten des Fensters 
                x          x-Koordinate 
                y          y-Koordinate des Dialogs 
                code       wird handle_exit in der Komponente clicks übergeben 
                data       wird handle_exit in der Komponente data übergeben 

               Hinweis: Bevor die Funktion zum Aufrufer zurückkehrt, 
               wird noch die Serviceroutine handle_exit mit der 
               Funktionsnummer HNDL_OPEN aufgerufen. Bei Koordinaten 
               von (-1,-1) wird der Dialog zentriert dargestellt.

 Ergebnis:     Die Funktion liefert die Fensterkennung des Dialogs 
               zurück, bzw. im Fehlerfall den Wert 0.

 Verfügbar:    Das Vorhandensein dieser Funktion kann per appl_getinfo 
               (Opcode 7) festgestellt werden.

 Gruppe:       Fensterdialoge

 Querverweis:  Binding   wdlg_close   wdlg_delete