[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()