[Contents] [Index] [Help] [Retrace] [Browse <] [Browse >]


    NAME
        TimedDisplayAlert -- Display an alert with automatic time-out. (V39)

    SYNOPSIS
        Response = TimedDisplayAlert( AlertNumber, String, Height, Time )
        D0                            D0           A0      D1      A1

        bool timeddisplayalert( ulong, ubyte *, uword, ulong );

    FUNCTION
        This function is equivalent to displayalert(), except that if
        the user fails to respond in a given time, the alert comes
        down automatically.  See the autodoc for displayalert() for
        full details.

    INPUTS
        AlertNumber = the number of this alert message.  The only pertinent
            bits of this number are the ALERT_TYPE bit(s).  The rest of the
           number is ignored by this routine.
        String = pointer to the alert message string, as described above
        Height = minimum display lines required for your message
        Time = length of time the alert should wait for the user to
            respond.  This time is the number of video frames the
            alert should remain up for.

    RESULT
        A bool value of true or false.  if this is a deadend_alert, false
        is always the return value.  If this is a RECOVERY_ALERT. The return
        value will be TRUE if the user presses the left mouse button in
        response to your message, and FALSE if the user presses the right hand
        button is response to your text, or if the alert could not
        be posted.  If the alert times out, the return value will be FALSE.

    BUGS

    SEE ALSO
        displayalert()