4 ; Window event dispatching
6 ; © 1994-1998 Straylight
9 ;----- Licensing note -------------------------------------------------------
11 ; This file is part of Straylight's Sapphire library.
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)
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.
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.
27 ;----- Overview -------------------------------------------------------------
32 ; win_removeEventHandler
36 ; win_removeUnknownHandler
42 ; --- win_eventHandler ---
44 ; On entry: R0 == window handle
45 ; R1 == pointer to routine to call
46 ; R2 == R10 value to call routine with
47 ; R3 == R12 value to call routine with
49 ; On exit: May return an error
51 ; Use: Adds a routine to the event handler list. Later added
52 ; routines are called first. The event handing routine
53 ; must preserve all the registers, but may alter the carry
54 ; flag. If it returns with carry set, then no more event
55 ; handlers, OR post-filters, will be called.
57 IMPORT win_eventHandler
59 ; --- win_removeEventHandler ---
61 ; On entry: R0 == window handle
62 ; R1 == pointer to routine called
63 ; R2 == R10 value routine is called with
64 ; R3 == R12 value routine is called with
68 ; Use: Removes a routine to the event handler list.
70 IMPORT win_removeEventHandler
72 ; --- win_swapWindow ---
74 ; On entry: R0 == old window handle
75 ; R1 == new window handle
79 ; Use: Searches for all the event handlers for window R0, and
80 ; changes the window handle for R1. This is designed for
81 ; situations in wihich a window has been deleted and
86 ; --- win_windowDeleted ---
88 ; On entry: R0 == window handle
92 ; Use: Removes all the event handlers associated with the given
93 ; window handle. It is intended to be used when a window
96 IMPORT win_windowDeleted
98 ; --- win_unknownHandler ---
100 ; On entry: R0 == pointer to routine to call
101 ; R1 == R4 value to call routine with
102 ; R2 == R10 value to call routine with
103 ; R3 == R12 value to call routine with
105 ; On exit: May return an error
107 ; Use: Adds a rountine to the event handler list. Later added
108 ; routines are called first. The event handing routine
109 ; must preserve all the registers, but may alter the carry
110 ; flag. If it returns with carry set, then no more event
111 ; handlers, OR post-filters, will be called.
113 IMPORT win_unknownHandler
115 ; --- win_removeUnknownHandler ---
117 ; On entry: R0 == pointer to routine called
118 ; R1 == R4 value routine is called with
119 ; R2 == R10 value routine is called with
120 ; R3 == R12 value routine is called with
124 ; Use: Removes a routine to the unknown handler list.
126 IMPORT win_removeUnknownHandler
134 ; Use: Initialises the win system.
140 ;----- That's all, folks ----------------------------------------------------