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-File9.1.3.17  Xform_do                                                 TOS

 Name:          »Xform_do« - Verwaltung eines Formulars

 Deklaration:   int16_t cdecl (*Xform_do) (OBJECT *tree, int16_t 
                startob, int16_t *puntmsg);

 Beschreibung:  Die Funktion übernimmt die Verwaltung eines Formulars, 
                sowie (in geringem Umfang) die Bearbeitung von AES 
                Nachrichten. Es gilt:

                 Parameter  Bedeutung 
                 tree       Adresse des Objektbaumes 
                 startob    Startobjekt 
                 puntmsg    Mitteilungs-Puffer 

                Hinweis: Unter COPS kann die CPX einen bis zu 512*384 
                Pixel großen Objektbaum zeichnen und an diese Funktion 
                übergeben.

 Ergebnis:      Die Funktion liefert einen der folgenden Werte zurück:

                 -1: puntmsg enthält eine Nachricht, die auszuwerten 
                   ist:

                    WM_REDRAW:  die CPX muß solche Objekte selbst 
                                neuzeichnen, die nicht zum Objektbaum 
                                gehören. Die Rechteckliste kann über 
                                die Funktionen GetFirstRect und 
                                GetNextRect ermittelt werden.

                    AC_CLOSE:

                    WM_CLOSE:   Die CPX wurde beendet; reservierter 
                                Speicher ist sofort freizugeben. 
                                AC_CLOSE ist als 'Abbruch', WM_CLOSE 
                                als 'Ok' zu werten.

                    CT_KEY:     spezielle Nachricht, die das Auswerten 
                                von Tastendrücken erlaubt, sofern 
                                diese keine Auswirkungen auf EDIT- 
                                Felder haben können.

                                 puntmsg[3]  Highbyte  :  Scan-Code der Taste 
                                 puntmsg[3]  Lowbyte   :  ASCII-Code der Taste 

                    sonst:      Nummer des angeklickten Objektes (ein 
                                Doppelklick wird im oberen Bit 
                                gekennzeichnet).

 Gruppe:        XCONTROL-Funktionen

 Querverweis:   form_do   form_xdo   Rechteckliste eines Fensters