alert
alert
BUTTONS
,
TEXT

The alert statement displays a modal alert window with a message and one or more buttons.

Parameters

This statement has two parameters:

buttons – a comma separated list of buttons to include in the alert. The buttons must be listed in reverse order – the first button listed will be on the right and will be the default button if the Enter or Return key is pressed.

text – is the message to display.

Description

The alert statement displays a modal alert window with a message and one or more buttons. This example displays an alert with three buttons.

    alert "Yes,No,Maybe","Do you want to continue?"
    if info("dialogtrigger") = "No"
        stop
    endif
    if info("dialogtrigger") = "Maybe"
        if rnd() > 0.5
            stop
        endif
    endif
    ...
    ...
    ...

The procedure pauses until one of the buttons is clicked. As shown above, the procedure can use the info(“dialogtrigger”) to find out which button was clicked.

Note: Pressing the Enter or Return key is the same as clicking the first button (the button farthest to the right). If the alert contains a Cancel button, pressing the ESC button is the same as clicking on the Cancel button. If there is no Cancel button, the ESC key is ignored.

#### LEGACY RESOURCE NUMBER COMPATIBILITY

In Panorama 6.0 and earlier the first parameter of the alert statement was a resource number instead of a list of buttons. Panorama contained a number of internal resources that could be used with this statement. For compatibility with existing databases, the alert statement correctly handles resource numbers that were internal to earlier versions of Panorama (1000, 1001, etc.). Your own custom resources, however, are not supported. Code that uses custom resources must be rewritten for compatibility.

See Also

- alertcanceldelete -- displays a modal alert window with a message and two buttons: *Cancel* and *Delete*.
- alertcancelok -- displays a modal alert window with a message and two buttons: *Cancel* and *Ok*.
- alertdeletecancel -- displays a modal alert window with a message and two buttons: *Delete* and *Cancel*.
- alertmodal -- displays a modal alert sheet (not attached to any window) with a message and one or more buttons.
- alertnoyes -- displays a modal alert window with a message and two buttons: *No* and *Yes*.
- alertok -- displays a modal alert window with a message and one button: *Ok*
- alertokcancel -- displays a modal alert window with a message and two buttons: *Ok* and *Cancel*.
- alertoksmall -- displays a modal alert window with a message and one button: *Ok*
- alertrevertcancel -- displays a modal alert window with a message and two buttons: *Revert* and *Cancel*.
- alertsavecancel -- displays a modal alert window with a message and two buttons: *Save* and *Cancel*.
- alertsheet -- displays an alert sheet (attached to the current window) with a message and one or more buttons. Note: with the introduction of OS 11, Big Sur, sheets no longer appear to slide down from the title bar, but open a dialog centered on the active window.
- alertyesno -- displays a modal alert window with a message and two buttons: *Yes* and *No*.
- alertyesnocancel -- displays a modal alert window with a message and three buttons: *Yes*, *No* and *Cancel*.
- beep -- makes the computer speaker beep once.
- bigmessage -- displays a message alert.
- cancelok -- displays a modal alert window with a message and two buttons: *Cancel* and *Ok*.
- gettextokcancel -- displays a modal dialog that asks the user to enter an item of text.
- giantmessage -- displays a message alert.
- message -- displays a modal alert window with a message.
- noyes -- displays a modal alert window with a message and two buttons: *No* and *Yes*.
- nsnotify -- delivers a notification.
- okcancel -- displays a modal alert window with a message and two buttons: *Ok* and *Cancel*.
- rudemessage -- displays a message alert.
- statusmessage -- displays a message in the status bar at the bottom of the procedure window.
- stopalert -- displays a modal alert window with a warning icon, a message and one or more buttons.
- tallmessage -- displays a message alert.
- yesno -- displays a modal alert window with a message and two buttons: *Yes* and *No*.

History

Version | Status | Notes
10.0 | Updated | Carried over from Panorama 6.0 but does not have 255 character limit, and automatically grows in height to accommodate the specified text.