4 ; Pane handling facilities
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 -------------------------------------------------------------
39 [ :LNOT::DEF:pane__dfn
44 ; On entry: R0 == window handle of parent window
45 ; R1 == icon handle in parent window
46 ; R2 == window handle of pane window
48 ; On exit: May return an error
50 ; Use: This call registers a pane to be associated with the given
51 ; window. The pane is always opened to fit exactly within
52 ; the given icon -- border widths are taken into account
53 ; if there are scroll bars etc.
55 ; You must call pane_closed if the parent window is closed,
56 ; since there is no way for pane to trap this occurence.
62 ; On entry: R0 == window handle for which pane was registered
63 ; R1 == window handle of the pane window itself
67 ; Use: Removes the pane from the given window. This call will
68 ; close the given pane, but will not actually delete it
69 ; (ie. with a Wimp_DeleteWindow).
75 ; On entry: R0 == window handle of parent
79 ; Use: Informs pane that a parent window has closed.
80 ; All associated panes are then closed.
84 ; --- pane_deleted ---
86 ; On entry: R0 == window handle of parent
90 ; Use: Informs pane that a parent window has been deleted.
91 ; All associated panes are then closed, and there
92 ; registration with the pane library module is
99 ; On entry: R0 == window handle of parent window
100 ; R1 == icon handle within parent window
101 ; R2 == window handle of new pane
105 ; Use: This call will replace the pane in associated with icon R1
106 ; in window R0, with the pane in R2.
108 ; The exisiting pane is closed, and the new pane is
109 ; opened in it's place. No error is generated if the existing
110 ; pane does not exist; this allows the caller to delete the
111 ; window before doing the swap.
117 ; On entry: R0 == window handle
121 ; Use: Opens all the panes associated with the given window.
131 ; Use: Initialises the pane unit.
137 ;----- That's all, folks ----------------------------------------------------