4 ; Icon bar icon handling
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 -------------------------------------------------------------
37 [ :LNOT::DEF:ibicon__dfn
40 ; --- ibicon_create ---
42 ; On entry: R0 == pointer to sprite name
43 ; R1 == pointer to text buffer (must be writable if you
44 ; intend to change the text)
45 ; R2 == icon bar position indicator (`window handle')
46 ; R3 == icon bar priority/icon handle
47 ; R4 == pointer to event handler
48 ; R5 == value to pass in R10
49 ; R6 == value to pass in R12
51 ; On exit: R0 == ibicon icon handle
54 ; Use: Places an icon on the icon bar. Your handler is called when
55 ; an event occurs on the icon. On entry to the handler, R10
56 ; and R12 are set up as for above, R0 is the event type, and
57 ; R1 is the ibicon pointer.
61 ; --- ibicon_changeSprite ---
63 ; On entry: R0 == ibicon pointer
64 ; R1 == pointer to sprite name
68 ; Use: Changes the sprite of the ibicon passed to it.
70 IMPORT ibicon_changeSprite
72 ; --- ibicon_changeText ---
74 ; On entry: R0 == ibicon pointer
75 ; R1 == pointer to new text
79 ; Use: Changes the sprite of the ibicon passed to it.
81 IMPORT ibicon_changeText
83 ; --- ibicon_remove ---
85 ; On entry: R0 == ibicon icon handle
89 ; Use: Removes the given icon from the icon bar.
99 ; Use: Initialises the ibicon unit.
103 ;----- Event types ----------------------------------------------------------
115 ;----- That's all, folks ----------------------------------------------------