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-FileALERT icon,message$,default,button$,choice

icon, default: iexp
message$, button$: sexp
choice: avar

The command ALERT creates an Alert box. The expression 'icon' determines which
icon is to appear in the box. The following are valid:

    icon  Image
    ----  -------------------------
    0     None


    1     Exclamation mark


    2     Question mark


    3     Stop sign


    =>4   See FORM_ALERT()

The text to appear in the box is given by the expression 'message$'. A maximum
of 4 lines is permitted, with a maximum of 30 characters per line, separated
by 'pipe' (|) characters. Lines which are longer than 30 characters are
truncated.

The expression 'default' specifies which of the box's buttons is to be the one
with a bold border, selectable by pressing Return or Enter. As no more than
three buttons are allowed, 'default' can take a value from 0 to 3, 0 indicating
that there will be no default button and selection can only be made by clicking
with the mouse.

The string expression 'button$' contains the text for the buttons, with a
maximum of 8 characters per button. The individual button are separated by
'pipe' (|) characters. Buttons which are longer than 8 characters are
truncated.

On exiting from the Alert box, the variable 'choice' contains the number (1 to
3) of the selected button (see FORM_ALERT()).

Example:

    ALERT 1,"Pick a|button",1,"Left|Right",a%
    ALERT 0,"You pressed|button "+STR$(a%),0,"Ok",a%

--> A box with two buttons appears. After the selection has been made a second
    box materialises stating which button in the first box was chosen. The
    second Alert box has no icon and no default button.

Memo: Values larger than 3 for parameter 'icon' do not work.
      To use the newer alert icons one must call FORM_ALERT() instead. ALERT
      can be fatal on some AES versions if the default button exceeds the
      actual button count.

      ALERT doesn't throw any errors for anything out of range.
      It also crops all strings that exceed the set limits.

form_alert()+