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.16  x_form_error                                              TOS

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

 AES-Nummer:   28945

 Deklaration:  int16_t x_form_error ( uint8_t *fmt, int16_t errnum );

 Beschreibung: This function takes the error code specified by errnum 
               and finds an appropriate error message string. It then 
               inserts this text into a program-defined alert string 
               and displays an alert.

               The fmt should be in standard form_alert format, with a 
               "%s" to indicate the location where the error message 
               should be inserted. Since an alert can contain no more 
               than five lines of 30 characters each, and the pre- 
               defined error messages can take up to three lines, 
               there should be no more than two lines of text 
               surrounding the inserted error text.

               Example:

               if( x_form_error( "[1][Error!|%s][Continue|Quit]", -33 ) == 1 )
                 continue...
               else quit...

 Ergebnis:     Als Ergebnis wird die Nummer (1-3) der ausgewählten 
               Option zurückgegeben.

 Verfügbar:    Die Funktion steht nur unter Geneva zur Verfügung.

 Gruppe:       Formulare

 Querverweis:  Binding   form_error   form_xerr   form_err in N.AES