4 ; Starting and ending of Wimp tasks
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 -------------------------------------------------------------
36 [ :LNOT::DEF:wimp__dfn
41 ; On entry: R0 == pointer to application name
45 ; Use: Initialises the WindowManager, and stores away useful
46 ; snippets of information, like the task handle we've been
47 ; given. It also registers an exit handler so that the Wimp
52 ; --- wimp_taskHandle ---
56 ; On exit: R0 == the application's task handle
58 ; Use: Returns the application's task handle.
60 IMPORT wimp_taskHandle
62 ; --- wimp_version ---
66 ; On exit: R0 == the WIMP's version number (may not be the one the
69 ; Use: Returns the WindowManager's version number.
73 ; --- wimp_strWidth ---
75 ; On entry: R0 == pointer to a string
77 ; On exit: R0 == width of the string in OS units
79 ; Use: Returns the width of a string, as it would be displayed in
80 ; an icon (i.e. taking into account things like the current
81 ; desktop font etc.) The width is exact, so if you want to
82 ; e.g. draw a box round it, you'll have to add on a little
83 ; clearance at each end. 8 OS units seems to be a good size
84 ; for the clearance (so the total width you'd use is given by
85 ; wimp_strWidth(string)+16, because it has two ends).
91 ;----- That's all, folks ----------------------------------------------------