Initial revision
[ssr] / StraySrc / Libraries / Sapphire / sh / mbox
1 ;
2 ; mbox.sh
3 ;
4 ; Handling for monologue boxes
5 ;
6 ; © 1994-1998 Straylight
7 ;
8
9 ;----- Licensing note -------------------------------------------------------
10 ;
11 ; This file is part of Straylight's Sapphire library.
12 ;
13 ; Sapphire is free software; you can redistribute it and/or modify
14 ; it under the terms of the GNU General Public License as published by
15 ; the Free Software Foundation; either version 2, or (at your option)
16 ; any later version.
17 ;
18 ; Sapphire is distributed in the hope that it will be useful,
19 ; but WITHOUT ANY WARRANTY; without even the implied warranty of
20 ; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
21 ; GNU General Public License for more details.
22 ;
23 ; You should have received a copy of the GNU General Public License
24 ; along with Sapphire. If not, write to the Free Software Foundation,
25 ; 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
26
27 ;----- Overview -------------------------------------------------------------
28 ;
29 ; Functions provided:
30 ;
31 ; mbox
32
33 [ :LNOT::DEF:mbox__dfn
34 GBLL mbox__dfn
35
36 ; --- mbox ---
37 ;
38 ; On entry: R0 == dialogue box handle
39 ; R1 == pointer to help message tag for dialogue box
40 ; R2 == icon handle for embedded title
41 ;
42 ; On exit: --
43 ;
44 ; Use: Displays a `monologue' box (i.e. a dialogue box which just
45 ; displays information to the user) on the screen and sets up
46 ; an event handler for it. The dialogue box is destroyed when
47 ; it is closed.
48 ;
49 ; If the dialogue box does not have a title bar (read by
50 ; dbox_hasTitle) then R2 is used to give the monologue box
51 ; an embedded title. R2 is not used otherwise, and thus may
52 ; safely contain any old rubbish.
53
54 IMPORT mbox
55
56 ]
57
58 ;----- That's all, folks ----------------------------------------------------
59
60 END