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.1 form_alert TOS Name: »Form alert box« - zeichnet eine Alarmbox.
AES-Nummer: 52
Deklaration: int16_t form_alert ( int16_t fo_adefbttn, CONST int8_t
*fo_astring );
Beschreibung: Die Funktion stellt eine Alarmbox auf dem Bildschirm
dar und gibt die Nummer des Buttons zurück, mit dem die
Alarmbox verlassen wurde. Der Bildschirmhintergrund
wird dabei vom AES gesichert.
Der Parameter fo_adefbttn bestimmt die Nummer des
Defaultbuttons der darzustellenden Alarmbox. Es gilt:
Wert Bedeutung
0 kein Defaultbutton
1 erster Button
2 zweiter Button
3 dritter Button
Der Parameter fo_astring ist ein Zeiger auf den String,
der das Aussehen der Alarmbox bestimmt. Das verwendete
Format ist "[n][lines][buttons]" wobei n die Nummer des
einzublendenden Icons ist:
n Bedeutung Symbole
0 kein Icon
1 Ausrufezeichen
6 Bombe, XaAESHinweis: Die zur Verfügung stehenden Icons sollten
nicht willkürlich eingesetzt werden, sondern zur
jeweiligen Situation passen, d.h:
∙ das Ausrufezeichen sollte für alle Arten von
Mitteilungen benutzt werden, die der Benutzer nur
kurz bestätigen soll.
∙ das Fragezeichen dient für alle Abfragen, die vor
einer Aktion ausgeführt werden sollten (z.B. das
Löschen einer Datei).
∙ das Stopschild sollte bei wichtigen Problemen
eingesetzt werden, die der Benutzer unbedingt zur
Kenntnis nehmen muss.
Die Komponente lines beschreibt die einzelnen
Textzeilen. Es sind höchstens fünf Textzeilen mit
maximal 30 Zeichen, die durch das Zeichen '|' getrennt
werden, erlaubt.
Die Komponente buttons beschreibt die Texte für
höchstens drei Buttons, die durch das Zeichen '|'
getrennt werden.
MagiC: Aufgrund der Kompatibilität zu GEM/3 können
Alertboxen hier bis zu 40 Zeichen pro Textzeile,
und 20 Zeichen pro Button enthalten. Darüberhinaus
sind alle Alertboxen komplett über die Tastatur
bedienbar, mit der Funktionstaste F1 den linken,
F2 den mittleren und mit F3 den rechten Button.
ViewMAX/2 and later parse the "default button"
parameter as two bytes; the low byte is the
default button and the high byte is the cancel
button (ESC is a shortcut for it). This style of
parameter will crash earlier GEM versions.
Under Geneva, the alert string can contain left
bracket ("[") characters within the text of the
buttons. These denote the keyboard equivalents to
be used for the buttons. For example, this defines
an alert with the equivalents [Alternate][H] and
[Alternate][Y]:
form_alert( 1, "[1][Hi there!][[Hi!|B[ye!]" );
If an alert button does not contain a pre-defined
keyboard equivalent, it will be considered for an
automatic keyboard equivalent.
Note:DO NOT use this type of alert string when
running without Geneva, as this will have
unpredictable results.
Additionally, if an alert would normally not have
a default button, Geneva always forces the
rightmost button to be the default. For example:
form_alert( 2, "[1][Hi!][OK]" ); /* OK is the
default */
Ergebnis: Als Ergebnis wird die Nummer des Buttons geliefert, mit
dem die Alertbox verlassen wurde; dabei besitzt der
ganz links stehende Button den Wert 1.
Verfügbar: In allen AES Versionen.
Gruppe: Formulare Querverweis: Binding