Topic       : The GFA-Basic Compendium
Author      : GFA Systemtechnik GmbH
Version     : GFABasic.HYP v2.98 (12/31/2023)
Subject     : Documentation/Programming
Nodes       : 899
Index Size  : 28056
HCP-Version : 3
Compiled on : Atari
@charset    : atarist
@lang       : 
@default    : Document not found
@help       : Help
@options    : +g -i -s +z
@width      : 75
@hostname   : STRNGSRV
@hostname   : CAB     
@hostname   : HIGHWIRE
@hostname   : THING   
View Ref-FileFORM_ALERT(button,string$)

button: iexp
string$: sexp

Creates a general-purpose Alert box (see ALERT command).

Returns the number of the clicked button which caused the function to
terminate.

    button  - Number of the default (thick-bordered) button:
              0: None
              1: First
              2: Second
              3: Third
    string$ - A string defining the contents of the Alert box. The string has
              the following format (note that the square brackets are part of
              the string):
              [i][Message][Buttons]
              The meaning of the sections inside the brackets is as follows:
              'i'       The required symbol in the Alert box:
                        0: None


                        1: Exclamation mark


                        2: Question mark


                        3: Stop sign


                        4: Information                      AES => v4.1


                        5: Floppy disk                      AES => v4.1


                        6: Bomb                             XaAES


                        7: Floppy disk/question mark        XaAES


              'Message' Can be at the most 5 lines of text, with a maximum of
                        30 characters per line, with the lines separated with
                        the pipe '|' character.
              'Buttons' Can be a maximum of 3 button names, separated by the
                        pipe '|' character.

Example:

    a$="[1][This is the first line|+|+|+|This is the fifth line][One|Two|Three]"
    DO
      PRINT FORM_ALERT(1,a$)
    LOOP

--> Prints 1, 2, or 3 depending on which button is clicked, or pressing Return
    selects the highlighted button. The program can be exited by pressing the
    break keys (Shift-Control-Alternate) but this will only take effect after
    the next click.

Memo: FORM_ALERT() can be fatal on some AES versions if the default button
      exceeds the actual button count.

form_alert()+