/*
 * mbox.h
 *
 * [Generated from mbox, 25 September 1996]
 */

#if !defined(__CC_NORCROFT) || !defined(__arm)
  #error You must use the Norcroft ARM Compiler for Sapphire programs
#endif

#pragma include_only_once
#pragma force_top_level

#ifndef __mbox_h
#define __mbox_h

#ifndef __sapphire_h
  #include "sapphire.h"
#endif

/*----- Overview ----------------------------------------------------------*
 *
 * Functions provided:
 *
 *  mbox
 */

/* --- mbox --- *
 *
 * On entry:	R0 == dialogue box handle
 *		R1 == pointer to help message tag for dialogue box
 *		R2 == icon handle for embedded title
 *
 * On exit:	--
 *
 * Use:		Displays a `monologue' box (i.e. a dialogue box which just
 *		displays information to the user) on the screen and sets up
 *		an event handler for it.  The dialogue box is destroyed when
 *		it is closed.
 *
 *		If the dialogue box does not have a title bar (read by
 *		dbox_hasTitle) then R2 is used to give the monologue box
 *		an embedded title.  R2 is not used otherwise, and thus may
 *		safely contain any old rubbish.
 */

extern routine mbox;

/*----- That's all, folks -------------------------------------------------*/

#endif
