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.6  form_error                                                 TOS

 Name:         »Form Error« - stellt eine Fehlerbox für TOS-Fehler 
               dar.

 AES-Nummer:   53

 Deklaration:  int16_t form_error ( int16_t fo_enum );

 Beschreibung: Die Funktion gibt eine MS-DOS Fehlernummer im Klartext 
               (d.h. in einer Alertbox) aus.

               Der Parameter fo_enum ist dabei die entsprechende 
               Fehlernummer.

               Hinweis: Diese Funktion ist aus Kompatibilitätsgründen 
               zum PC-GEM vorhanden. Auf TOS-Systemen muß daher 
               zunächst die GEMDOS-Fehlernummer auf die MS-DOS 
               Codierung umgerechnet werden. Für die Umrechnung 
               (GEMDOS -> MS-DOS) kann z.B. die folgende Formel 
               benutzt werden: ( fo_enum) - 30.

               In N.AES gibt es einer erweiterte Form von form_error 
               mit allen GEMDOS-Fehlercodes. Deren vorhandensein kann 
               mit appl_getinfo (Opcode 64) festgestellt werden.

               Geneva interpreted a negative number as a GEMDOS/BIOS 
               error code, and an appropriate error message is 
               displayed. For instance, the call:
               form_error(-33);
               produces an alert with the text "There is no file with 
               this name".

 Ergebnis:     Als Ergebnis wird die Nummer (1-3) der ausgewählten 
               Option zurückgegeben. Bei jetzigen GEM-Versionen steht 
               jedoch nur eine Option zur Verfügung.

 Verfügbar:    In allen AES Versionen.

 Gruppe:       Formulare

 Querverweis:  Binding   form_xerr   form_error in N.AES