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.13  form_xerr                                                 TOS

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

 AES-Nummer:   136

 Deklaration:  int16_t form_xerr ( int32_t errcode, int8_t *errfile );

 Beschreibung: Gibt eine Fehlerbox auf dem Bildschirm aus, die die 
               übergebene Fehlernummer im Klartext beinhaltet. Im 
               Gegensatz zu form_error entfällt jedoch eine Umrechnung 
               vom TOS in das MSDOS Format.

                Parameter  Bedeutung

                errcode    normaler, negativer GEMDOS oder BIOS 
                           Fehlercode. Falls dieser EBREAK 
                           (Programmabbruch per Control-C) oder E_OK 
                           (kein Fehler) ist, wird keine Alertbox 
                           angezeigt.
                errfile    Pfad einer Datei, in der der Fehler 
                           aufgetreten ist. Bei einem Nullpointer wird 
                           der Parameter ignoriert; -1 bedeutet daß 
                           die Zeile "Programm gab zurück:" der 
                           Meldung vorangestellt wird.

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

 Verfügbar:    Die Funktion steht nur unter MagiC (ab Version 2.0) zur 
               Verfügung.

 Gruppe:       Formulare

 Querverweis:  Binding   form_error