/*
 *  FORM_ALERT					(C) Digital Design 1990
 *
 *  Darstellen einer Warnmeldung.
 *  Es handelt sich hierbei um eine besondere Form von Formularen.
 *  Neben einem Piktogramm (optional) wird ein zu programmierender
 *  Begleittext ausgegeben. Der Benutzer kann die Meldung quittieren,
 *  indem er eins von h�chstens 3 Quittierungsfeldern anklickt bzw.
 *  Return bet�tigt (optional). Die Gr��e des Feldes f�r die Warn-
 *  meldung sowie die Position (Zentrum des Bildschirms) wird von �AES�..\AES.HLP�
 *  bestimmt und kann nicht ver�ndert werden. Die Informationen �ber die
 *  3 Komponenten werden in einem String gespeichert, wobei um jede Kom-
 *  ponente ein Paar eckige Klammern gesetzt werden mu�.
 *  Beim Aufruf dieser Funktion werden folgende Schritte automatisch von
 *  �AES�..\AES.HLP� durchgef�hrt:
 *
 *  1. Anhand des oben beschriebenen Strings wird ein passender Objekt-
 *     baum definiert.
 *
 *  2. Der Bildschirmspeicher wird teilweise in einen Puffer gerettet.
 *
 *  3. �OBJC_DRAW�..\OBJC\OBJC_DRA.C� wird aufgerufen, um die Warnmeldung darzustellen.
 *
 *  4. �FORM_DO�FORM_DO.C� wird aufgerufen, um auf die Benutzereingabe zu warten.
 *
 *  5. Wenn der Benutzer die Warnmeldung quittiert hat, wird der zer-
 *     st�rte Bildschirmbereich restauriert.
 *
 *  6. Der Applikation wird mitgeteilt, welcher Knopf angeklickt worden
 *     ist.
 */
#include <gemdefs.h>

int form_alert( int fo_adefbttn, const char *fo_astring )
{
  intin[0] = fo_adefbttn; /* Nummer des Knopfes, dessen Ausl�sen durch	*
			   * Bet�tigen von Return simuliert werden kann:*
			   *	0 = kein Knopf				*
			   *	1 = erster Knopf			*
			   *	2 = zweiter Knopf			*
			   *	3 = dritter Knopf			*/
  addrin[0] = fo_astring; /* Adresse des Strings, der das Aussehen der	*
			   * Warnmeldung bestimmt.			*
			   * Aufbau des Strings:			*
			   *	[Piktogrammnummer][Text][Text der	*
			   *	Quittierungskn�pfe]			*
			   * Folgende Syntax ist der Darstellung der	*
			   * Komponenten zugeordnet:			*
			   *						*
			   * 1. Piktogramm:				*
			   * Eine Ziffer gibt an, ob ein bzw. welches	*
			   * Piktogramm links vom Text dargestellt	*
			   * werden soll. Drei Piktogramme stehen zur	*
			   * Auswahl:					*
			   *	0 = kein Piktogramm			*
			   *	1 = NOTE-Piktogramm			*
			   *	2 = WAIT-Piktogramm			*
			   *	3 = STOP-Piktogramm			*
			   *						*
			   * 2. Text:					*
			   * Der Text darf aus maximal 5 Zeilen mit	*
			   * maximal 40 Zeichen pro Zeile bestehen. Das *
			   * Zeichen "|" (logisches Oder) trennt Zeilen *
			   * voneinander.				*
			   *						*
			   * 3. Text der Quittierungskn�pfe:		*
			   * Die Zahl der Quittierungskn�pfe mu� zwi-	*
			   * schen 1 und 3 liegen. Der Text auf jedem	*
			   * Knopf darf maximal 20 Zeichen lang sein.	*
			   * Beim Funktionsaufruf kann ein Knopf als	*
			   * Ausgangsknopf definiert werden, d.h. da�	*
			   * das Anklicken dieses Knopfes durch das Be- *
			   * t�tigen der Return-Taste simuliert werden	*
			   * kann. Dieser Knopf wird st�rker umrandet	*
			   * gezeichnet. Der Text f�r die Kn�pfe wird	*
			   * durch den gleichen Zeilentrenner wie beim	*
			   * Text (s.o.) getrennt.			*/
  AES( 52, 1, 1, 1, 0 );

  return intout[0]; /* = fo_aexbttn: Nummer des Knopfes, der vom	*
		     * Benutzer zur Quittierung bet�tigt wurde: 	*
		     *		1 = erster Knopf			*
		     *		2 = zweiter Knopf			*
		     *		3 = dritter Knopf			*/
}
/* siehe auch: �form_error�FORM_ERR.C� */