Home » Archimedes archive » Archimedes World » AW-1995-01-Disc2.adf » Disk2Jan95 » !AWJan95/Goodies/Event/Docs/Icons
!AWJan95/Goodies/Event/Docs/Icons
This website contains an archive of files for the Acorn Electron, BBC Micro, Acorn Archimedes, Commodore 16 and Commodore 64 computers, which Dominic Ford has rescued from his private collection of floppy disks and cassettes.
Some of these files were originally commercial releases in the 1980s and 1990s, but they are now widely available online. I assume that copyright over them is no longer being asserted. If you own the copyright and would like files to be removed, please contact me.
| Tape/disk: | Home » Archimedes archive » Archimedes World » AW-1995-01-Disc2.adf » Disk2Jan95 |
| Filename: | !AWJan95/Goodies/Event/Docs/Icons |
| Read OK: | ✔ |
| File size: | 3B98 bytes |
| Load address: | 0000 |
| Exec address: | 0000 |
File contents
FNshell_IconGetCommand()
Params =>
int pointer to validation string
str validation command
<=
str command string
See also FNshell_IconGetValidation.
--------------------------------------------------------
PROCshell_IconSelectAll()
Params =>
int window handle
Selects all of the icons contained
in the specified window.
--------------------------------------------------------
PROCshell_IconDeselectAll()
Params =>
int window handle
Deselects all of the icons contained
in the specified window.
--------------------------------------------------------
PROCshell_IconDelete()
Params =>
int window handle
int icon handle
This call frees any memory used for indirected data
and validation strings. The window area covered by
the icon (including any 3D borders) is not redrawn.
Use PROCshell_IconDelete2 to delete the icon and
redraw the window area.
--------------------------------------------------------
PROCshell_IconDelete2()
Params =>
int window handle
int icon handle
This call frees any memory used for indirected data
and validation strings. The window area covered by
the icon (including any 3D borders) is redrawn.
When a large number of icons are to be deleted it is
better to use PROCshell_IconDelete and then redraw
the window afterwards as this will be quicker.
--------------------------------------------------------
FNshell_IconMove2()
Params =>
int window handle
int icon handle
int x displacement
int y displacement
<=
int icon handle
Allows an icon to be moved around the window.
As the icon has to be deleted and then
recreated it returns the new icon handle (which
should be the same as the old handle). The icon
is redrawn after moving, taking account of any
3D borders.
See also FNshell_IconMove
--------------------------------------------------------
FNshell_IconMove()
Params =>
int window handle
int icon handle
int min x coord
int min y coord
int max x coord
int may y coord
<=
int icon handle
Allows the redefinition of an icon's bounding
box. As the icon has to be deleted and then
recreated it returns the new icon handle (which
should be the same as the old handle). The icon
is redrawn after resizing, taking account of any
3D borders.
--------------------------------------------------------
FNshell_IconGetData()
Params =>
int window handle
int icon handle
<=
str icon text
See also <PROCshell_IconPutData>.
--------------------------------------------------------
PROCshell_IconbarSetText()
Params =>
int window handle
int icon handle
str text under icon
A problem can occur with this call if RISC OS
2 is in use. As it does not seem possible to
discover the scroll offsets of the iconbar the
correct area of the iconbar may not be redrawn
after changing the text. Any suggestions would
be gratefully received...
--------------------------------------------------------
PROCshell_IconPutData()
Params =>
int window handle
int icon handle
str text to insert into icon
int redraw flag
An error is generated if the text is too
long to fit in the icon.
If the text to insert is the same as the
existing text then no action is taken,
avoiding any flickering of the icon.
If the redraw flag is TRUE wimp poll is
called immediately to update the icon
contents. Note that if the window is not
open (for example if you are calling this
routine in a pre-open function) then the
redraw flag should be FALSE as the whole
window will be redrawn when it is opened.
--------------------------------------------------------
PROCshell_IconPutDataNow()
Params =>
int window handle
int icon handle
str text to insert into icon
An error is generated if the text is too
long to fit in the icon.
This call is similar to PROCshell_IconPutData,
the difference being that PROCshell_Ensure is
called to make sure that the icon is updated
immediately. This is important if your program
is performing some non multi tasking operation
and you want an icon to show a status message.
--------------------------------------------------------
PROCshell_IconRedraw()
Params =>
int window handle
int icon handle
Force a redraw of the screen
area covered by the given icon
(including any 3D borders).
--------------------------------------------------------
PROCshell_IconPutValidation()
Params =>
int window handle
int icon handle
str new validation string
See also FNshell_IconGetValidation.
--------------------------------------------------------
PROCshell_IconSelect()
Params =>
int window handle
int icon handle
Make the specified icon selected.
--------------------------------------------------------
PROCshell_IconDeselect()
Params =>
int window handle
int icon handle
--------------------------------------------------------
PROCshell_IconUnselectable()
Params =>
int window handle
int icon handle
--------------------------------------------------------
PROCshell_IconSetBGColour()
Params =>
int window handle
int icon handle
int background colour
An error is generated if the colour
number is outside the range 0-15.
See also PROCshell_IconSetFGColour.
--------------------------------------------------------
PROCshell_IconSetFGColour()
Params =>
int window handle
int icon handle
int foreground colour
An error is generated if the colour
number is outside the range 0-15.
See also PROCshell_IconSetBGColour.
--------------------------------------------------------
PROCshell_IconSetButtonType()
Params =>
int window handle
int icon handle
int button type
An error is generated if the button
type is outside the range 0-11,14-15.
--------------------------------------------------------
PROCshell_IconSetESG()
Params =>
int window handle
int icon handle
int Exclusive Selection Group
number
An error is generated if the esg number
is outside the range 0-31.
--------------------------------------------------------
PROCshell_IconSetText()
Params =>
int window handle
int icon handle
bool state (0 to clear text bit,
non-0 to set it)
--------------------------------------------------------
PROCshell_IconSetSprite()
Params =>
int window handle
int icon handle
bool state (0 to clear sprite bit,
non-0 to set it)
--------------------------------------------------------
PROCshell_IconSetBorder()
Params =>
int window handle
int icon handle
bool state (0 to clear border bit,
non-0 to set it)
--------------------------------------------------------
PROCshell_IconSetHCentred()
Params =>
int window handle
int icon handle
bool state (0 to clear horizontally
centred bit, non-0 to set it)
--------------------------------------------------------
PROCshell_IconSetVCentred()
Params =>
int window handle
int icon handle
bool state (0 to clear vertically
centred bit, non-0 to set it)
--------------------------------------------------------
PROCshell_IconSetRightJust()
Params =>
int window handle
int icon handle
bool state (0 to clear right justified
bit, non-0 to set it)
--------------------------------------------------------
PROCshell_IconSetLeftJust()
Params =>
int window handle
int icon handle
--------------------------------------------------------
PROCshell_IconSetFilled()
Params =>
int window handle
int icon handle
bool state (0 to clear filled
bit, non-0 to set it)
--------------------------------------------------------
PROCshell_CaretSetPosition()
Params =>
int window handle
int icon handle
int x offset in icon (usually -1)
int y offset in icon (usually -1)
int height (usually -1)
int index
Allows the caret to be positioned within
an icon. the index parameter is the
number of characters before the caret.
See also PROCshell_CaretSetRight.
--------------------------------------------------------
PROCshell_CaretSetRight()
Params =>
int window handle
int icon handle
Positions the caret at the right hand
end of any text in the specified icon.
See also PROCshell_CaretSetPosition.
--------------------------------------------------------
FNshell_Iconbar()
Params =>
int -1 for right side of bar, -2 for left side
str sprite name
str text under icon
int width of icon/text (whichever is larger)
str menu name
bool shift flag (not implemented)
bool ctrl flag (not implemented)
bool alt flag (not implemented)
str function name
The shift, ctrl and alt flags are for future
enhancements to the library and should be set
to 0 on this release.
FNshell_IconGetValidation()
Params =>
int window handle
int icon handle
<=
str validation string
See also PROCshell_IconPutValidation.
--------------------------------------------------------
FNshell_IconNewSprite()
Params =>
int window handle
int icon handle
str new sprite name
int redraw flag
<=
int new icon handle
--------------------------------------------------------
FNshell_IsIconSelected()
Params =>
int window handle
int icon handle
<=
bool TRUE if selected, FALSE otherwise
--------------------------------------------------------
FNshell_IconIsDraggable()
Params =>
int window handle
int icon handle
<=
bool TRUE if draggable, FALSE otherwise
--------------------------------------------------------
FNshell_IconIsSprite()
Params =>
int window handle
int icon handle
<=
bool TRUE if sprite, FALSE otherwise
--------------------------------------------------------
FNshell_IconCreate()
Params =>
int window handle
int min x coord of icon
int min y coord of icon
int width of icon
int height of icon
int foreground colour
int background colour
int icon flags
str text to insert into icon
int address of indirected data
(ignored when not indirected)
int length of indirected buffer
(ignored when not indirected)
str validation string
<=
int handle of new icon
This routine is only used when the application
needs to create icons itself rather than
loading them as part of a window definition in
a template.
It does not redraw the area of the window occupied
by the new icon. If the window is open it may be
necessary to call PROCshell_IconRedraw to update
the window area covered by the icon.
User FN (PROCshell_IconBar)
Params =>
str text of menu selection
This function is called when the user chooses
an item on the menu.
--------------------------------------------------------
PROCshell_IconSet()
Params =>
int window handle
int icon handle
bool state (0 for deselected, non 0
for selected)
This call is used to select or deselect icons
depending on the value of the state flag
--------------------------------------------------------
PROCshell_IconSetSelected()
Params =>
int window handle
int icon handle
bool state (0 for deselected, non 0
for selected)
This call is used to select or deselect icons
depending on the value of the state flag
--------------------------------------------------------
PROCshell_IconSetUnselectable()
Params =>
int window handle
int icon handle
bool state (0 to make icon selectable,
non 0 to make it unselectable)
This call is used to make icons unselectable
(i.e. greyed out) depending on the value of
the state flag. If the icon contains the caret
when it is made unselectable, the caret is lost.
--------------------------------------------------------
FNshell_IconResize()
Params =>
int window handle
int icon handle
int min x coord
int min y coord
int max x coord
int max y coord
<=
int icon handle
Allows the redefinition of an icon's bounding
box. As the icon has to be deleted and then
recreated it returns the new icon handle (which
should be the same as the old handle). The icon
is redrawn after resizing, taking account of any
3D borders.
--------------------------------------------------------
PROCshell_CaretPutFirstIcon()
Params =>
int window handle
Allows the caret to be positioned within
the first writable icon in a window. If
the caret is not in the window, or there
are no writable icons no error occurs.
Note that this call does not claim the
caret, i.e. the caret must already be in
the window.
--------------------------------------------------------
PROCshell_CaretPutLastIcon()
Params =>
int window handle
Allows the caret to be positioned within
the last writable icon in a window. If
the caret is not in the window, or there
are no writable icons no error occurs.
Note that this call does not claim the
caret, i.e. the caret must already be in
the window.
--------------------------------------------------------
PROCshell_CaretPutNextIcon()
Params =>
int window handle
Allows the caret to be positioned within
the next writable icon in a window. If
the caret is not in the window, or there
are no writable icons no error occurs.
Note that this call does not claim the
caret, i.e. the caret must already be in
the window.
--------------------------------------------------------
PROCshell_CaretPutPrevIcon()
Params =>
int window handle
Allows the caret to be positioned within
the previous writable icon in a window. If
the caret is not in the window, or there
are no writable icons no error occurs.
Note that this call does not claim the
caret, i.e. the caret must already be in
the window.
-------------------------------------------------------- 00000000 46 4e 73 68 65 6c 6c 5f 49 63 6f 6e 47 65 74 43 |FNshell_IconGetC| 00000010 6f 6d 6d 61 6e 64 28 29 0a 50 61 72 61 6d 73 20 |ommand().Params | 00000020 3d 3e 0a 20 20 20 20 20 20 20 20 20 69 6e 74 20 |=>. int | 00000030 70 6f 69 6e 74 65 72 20 74 6f 20 76 61 6c 69 64 |pointer to valid| 00000040 61 74 69 6f 6e 20 73 74 72 69 6e 67 0a 20 20 20 |ation string. | 00000050 20 20 20 20 20 20 73 74 72 20 76 61 6c 69 64 61 | str valida| 00000060 74 69 6f 6e 20 63 6f 6d 6d 61 6e 64 0a 20 20 20 |tion command. | 00000070 20 20 20 20 20 20 0a 20 20 20 20 20 20 20 3c 3d | . <=| 00000080 0a 20 20 20 20 20 20 20 20 20 73 74 72 20 63 6f |. str co| 00000090 6d 6d 61 6e 64 20 73 74 72 69 6e 67 0a 0a 53 65 |mmand string..Se| 000000a0 65 20 61 6c 73 6f 20 46 4e 73 68 65 6c 6c 5f 49 |e also FNshell_I| 000000b0 63 6f 6e 47 65 74 56 61 6c 69 64 61 74 69 6f 6e |conGetValidation| 000000c0 2e 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |...-------------| 000000d0 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |----------------| * 000000f0 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 50 52 4f |-----------..PRO| 00000100 43 73 68 65 6c 6c 5f 49 63 6f 6e 53 65 6c 65 63 |Cshell_IconSelec| 00000110 74 41 6c 6c 28 29 0a 50 61 72 61 6d 73 20 3d 3e |tAll().Params =>| 00000120 20 20 20 20 20 20 20 20 20 0a 20 20 20 20 20 20 | . | 00000130 20 20 20 69 6e 74 20 77 69 6e 64 6f 77 20 68 61 | int window ha| 00000140 6e 64 6c 65 20 20 20 20 20 20 20 20 20 0a 0a 53 |ndle ..S| 00000150 65 6c 65 63 74 73 20 61 6c 6c 20 6f 66 20 74 68 |elects all of th| 00000160 65 20 69 63 6f 6e 73 20 63 6f 6e 74 61 69 6e 65 |e icons containe| 00000170 64 0a 69 6e 20 74 68 65 20 73 70 65 63 69 66 69 |d.in the specifi| 00000180 65 64 20 77 69 6e 64 6f 77 2e 0a 0a 2d 2d 2d 2d |ed window...----| 00000190 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |----------------| * 000001c0 2d 2d 2d 2d 0a 0a 50 52 4f 43 73 68 65 6c 6c 5f |----..PROCshell_| 000001d0 49 63 6f 6e 44 65 73 65 6c 65 63 74 41 6c 6c 28 |IconDeselectAll(| 000001e0 29 0a 50 61 72 61 6d 73 20 3d 3e 20 20 20 20 20 |).Params => | 000001f0 20 20 20 20 0a 20 20 20 20 20 20 20 20 20 69 6e | . in| 00000200 74 20 77 69 6e 64 6f 77 20 68 61 6e 64 6c 65 20 |t window handle | 00000210 20 20 20 20 20 20 20 20 0a 0a 44 65 73 65 6c 65 | ..Desele| 00000220 63 74 73 20 61 6c 6c 20 6f 66 20 74 68 65 20 69 |cts all of the i| 00000230 63 6f 6e 73 20 63 6f 6e 74 61 69 6e 65 64 0a 69 |cons contained.i| 00000240 6e 20 74 68 65 20 73 70 65 63 69 66 69 65 64 20 |n the specified | 00000250 77 69 6e 64 6f 77 2e 0a 0a 2d 2d 2d 2d 2d 2d 2d |window...-------| 00000260 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |----------------| * 00000290 2d 0a 0a 50 52 4f 43 73 68 65 6c 6c 5f 49 63 6f |-..PROCshell_Ico| 000002a0 6e 44 65 6c 65 74 65 28 29 0a 50 61 72 61 6d 73 |nDelete().Params| 000002b0 20 3d 3e 0a 20 20 20 20 20 20 20 20 20 69 6e 74 | =>. int| 000002c0 20 77 69 6e 64 6f 77 20 68 61 6e 64 6c 65 0a 20 | window handle. | 000002d0 20 20 20 20 20 20 20 20 69 6e 74 20 69 63 6f 6e | int icon| 000002e0 20 68 61 6e 64 6c 65 0a 0a 54 68 69 73 20 63 61 | handle..This ca| 000002f0 6c 6c 20 66 72 65 65 73 20 61 6e 79 20 6d 65 6d |ll frees any mem| 00000300 6f 72 79 20 75 73 65 64 20 66 6f 72 20 69 6e 64 |ory used for ind| 00000310 69 72 65 63 74 65 64 20 64 61 74 61 0a 61 6e 64 |irected data.and| 00000320 20 76 61 6c 69 64 61 74 69 6f 6e 20 73 74 72 69 | validation stri| 00000330 6e 67 73 2e 20 54 68 65 20 77 69 6e 64 6f 77 20 |ngs. The window | 00000340 61 72 65 61 20 63 6f 76 65 72 65 64 20 62 79 0a |area covered by.| 00000350 74 68 65 20 69 63 6f 6e 20 28 69 6e 63 6c 75 64 |the icon (includ| 00000360 69 6e 67 20 61 6e 79 20 33 44 20 62 6f 72 64 65 |ing any 3D borde| 00000370 72 73 29 20 69 73 20 6e 6f 74 20 72 65 64 72 61 |rs) is not redra| 00000380 77 6e 2e 0a 55 73 65 20 50 52 4f 43 73 68 65 6c |wn..Use PROCshel| 00000390 6c 5f 49 63 6f 6e 44 65 6c 65 74 65 32 20 74 6f |l_IconDelete2 to| 000003a0 20 64 65 6c 65 74 65 20 74 68 65 20 69 63 6f 6e | delete the icon| 000003b0 20 61 6e 64 0a 72 65 64 72 61 77 20 74 68 65 20 | and.redraw the | 000003c0 77 69 6e 64 6f 77 20 61 72 65 61 2e 0a 0a 2d 2d |window area...--| 000003d0 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |----------------| * 00000400 2d 2d 2d 2d 2d 2d 0a 0a 50 52 4f 43 73 68 65 6c |------..PROCshel| 00000410 6c 5f 49 63 6f 6e 44 65 6c 65 74 65 32 28 29 0a |l_IconDelete2().| 00000420 50 61 72 61 6d 73 20 3d 3e 0a 20 20 20 20 20 20 |Params =>. | 00000430 20 20 20 69 6e 74 20 77 69 6e 64 6f 77 20 68 61 | int window ha| 00000440 6e 64 6c 65 0a 20 20 20 20 20 20 20 20 20 69 6e |ndle. in| 00000450 74 20 69 63 6f 6e 20 68 61 6e 64 6c 65 0a 0a 54 |t icon handle..T| 00000460 68 69 73 20 63 61 6c 6c 20 66 72 65 65 73 20 61 |his call frees a| 00000470 6e 79 20 6d 65 6d 6f 72 79 20 75 73 65 64 20 66 |ny memory used f| 00000480 6f 72 20 69 6e 64 69 72 65 63 74 65 64 20 64 61 |or indirected da| 00000490 74 61 0a 61 6e 64 20 76 61 6c 69 64 61 74 69 6f |ta.and validatio| 000004a0 6e 20 73 74 72 69 6e 67 73 2e 20 54 68 65 20 77 |n strings. The w| 000004b0 69 6e 64 6f 77 20 61 72 65 61 20 63 6f 76 65 72 |indow area cover| 000004c0 65 64 20 62 79 0a 74 68 65 20 69 63 6f 6e 20 28 |ed by.the icon (| 000004d0 69 6e 63 6c 75 64 69 6e 67 20 61 6e 79 20 33 44 |including any 3D| 000004e0 20 62 6f 72 64 65 72 73 29 20 69 73 20 72 65 64 | borders) is red| 000004f0 72 61 77 6e 2e 0a 0a 57 68 65 6e 20 61 20 6c 61 |rawn...When a la| 00000500 72 67 65 20 6e 75 6d 62 65 72 20 6f 66 20 69 63 |rge number of ic| 00000510 6f 6e 73 20 61 72 65 20 74 6f 20 62 65 20 64 65 |ons are to be de| 00000520 6c 65 74 65 64 20 69 74 20 69 73 0a 62 65 74 74 |leted it is.bett| 00000530 65 72 20 74 6f 20 75 73 65 20 50 52 4f 43 73 68 |er to use PROCsh| 00000540 65 6c 6c 5f 49 63 6f 6e 44 65 6c 65 74 65 20 61 |ell_IconDelete a| 00000550 6e 64 20 74 68 65 6e 20 72 65 64 72 61 77 0a 74 |nd then redraw.t| 00000560 68 65 20 77 69 6e 64 6f 77 20 61 66 74 65 72 77 |he window afterw| 00000570 61 72 64 73 20 61 73 20 74 68 69 73 20 77 69 6c |ards as this wil| 00000580 6c 20 62 65 20 71 75 69 63 6b 65 72 2e 0a 0a 2d |l be quicker...-| 00000590 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |----------------| * 000005c0 2d 2d 2d 2d 2d 2d 2d 0a 0a 46 4e 73 68 65 6c 6c |-------..FNshell| 000005d0 5f 49 63 6f 6e 4d 6f 76 65 32 28 29 0a 50 61 72 |_IconMove2().Par| 000005e0 61 6d 73 20 3d 3e 0a 20 20 20 20 20 20 20 20 20 |ams =>. | 000005f0 69 6e 74 20 77 69 6e 64 6f 77 20 68 61 6e 64 6c |int window handl| 00000600 65 20 20 0a 20 20 20 20 20 20 20 20 20 69 6e 74 |e . int| 00000610 20 69 63 6f 6e 20 68 61 6e 64 6c 65 0a 20 20 20 | icon handle. | 00000620 20 20 20 20 20 20 69 6e 74 20 78 20 64 69 73 70 | int x disp| 00000630 6c 61 63 65 6d 65 6e 74 0a 20 20 20 20 20 20 20 |lacement. | 00000640 20 20 69 6e 74 20 79 20 64 69 73 70 6c 61 63 65 | int y displace| 00000650 6d 65 6e 74 0a 0a 20 20 20 20 20 20 20 3c 3d 0a |ment.. <=.| 00000660 20 20 20 20 20 20 20 20 20 69 6e 74 20 69 63 6f | int ico| 00000670 6e 20 68 61 6e 64 6c 65 0a 0a 41 6c 6c 6f 77 73 |n handle..Allows| 00000680 20 61 6e 20 69 63 6f 6e 20 74 6f 20 62 65 20 6d | an icon to be m| 00000690 6f 76 65 64 20 61 72 6f 75 6e 64 20 74 68 65 20 |oved around the | 000006a0 77 69 6e 64 6f 77 2e 0a 41 73 20 74 68 65 20 69 |window..As the i| 000006b0 63 6f 6e 20 68 61 73 20 74 6f 20 62 65 20 64 65 |con has to be de| 000006c0 6c 65 74 65 64 20 61 6e 64 20 74 68 65 6e 0a 72 |leted and then.r| 000006d0 65 63 72 65 61 74 65 64 20 69 74 20 72 65 74 75 |ecreated it retu| 000006e0 72 6e 73 20 74 68 65 20 6e 65 77 20 69 63 6f 6e |rns the new icon| 000006f0 20 68 61 6e 64 6c 65 20 28 77 68 69 63 68 0a 73 | handle (which.s| 00000700 68 6f 75 6c 64 20 62 65 20 74 68 65 20 73 61 6d |hould be the sam| 00000710 65 20 61 73 20 74 68 65 20 6f 6c 64 20 68 61 6e |e as the old han| 00000720 64 6c 65 29 2e 20 54 68 65 20 69 63 6f 6e 0a 69 |dle). The icon.i| 00000730 73 20 72 65 64 72 61 77 6e 20 61 66 74 65 72 20 |s redrawn after | 00000740 6d 6f 76 69 6e 67 2c 20 74 61 6b 69 6e 67 20 61 |moving, taking a| 00000750 63 63 6f 75 6e 74 20 6f 66 20 61 6e 79 0a 33 44 |ccount of any.3D| 00000760 20 62 6f 72 64 65 72 73 2e 0a 0a 53 65 65 20 61 | borders...See a| 00000770 6c 73 6f 20 46 4e 73 68 65 6c 6c 5f 49 63 6f 6e |lso FNshell_Icon| 00000780 4d 6f 76 65 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |Move..----------| 00000790 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |----------------| * 000007b0 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a |--------------..| 000007c0 46 4e 73 68 65 6c 6c 5f 49 63 6f 6e 4d 6f 76 65 |FNshell_IconMove| 000007d0 28 29 0a 50 61 72 61 6d 73 20 3d 3e 0a 20 20 20 |().Params =>. | 000007e0 20 20 20 20 20 20 69 6e 74 20 77 69 6e 64 6f 77 | int window| 000007f0 20 68 61 6e 64 6c 65 20 20 0a 20 20 20 20 20 20 | handle . | 00000800 20 20 20 69 6e 74 20 69 63 6f 6e 20 68 61 6e 64 | int icon hand| 00000810 6c 65 0a 20 20 20 20 20 20 20 20 20 69 6e 74 20 |le. int | 00000820 6d 69 6e 20 78 20 63 6f 6f 72 64 0a 20 20 20 20 |min x coord. | 00000830 20 20 20 20 20 69 6e 74 20 6d 69 6e 20 79 20 63 | int min y c| 00000840 6f 6f 72 64 0a 20 20 20 20 20 20 20 20 20 69 6e |oord. in| 00000850 74 20 6d 61 78 20 78 20 63 6f 6f 72 64 0a 20 20 |t max x coord. | 00000860 20 20 20 20 20 20 20 69 6e 74 20 6d 61 79 20 79 | int may y| 00000870 20 63 6f 6f 72 64 0a 0a 20 20 20 20 20 20 20 3c | coord.. <| 00000880 3d 0a 20 20 20 20 20 20 20 20 20 69 6e 74 20 69 |=. int i| 00000890 63 6f 6e 20 68 61 6e 64 6c 65 0a 0a 41 6c 6c 6f |con handle..Allo| 000008a0 77 73 20 74 68 65 20 72 65 64 65 66 69 6e 69 74 |ws the redefinit| 000008b0 69 6f 6e 20 6f 66 20 61 6e 20 69 63 6f 6e 27 73 |ion of an icon's| 000008c0 20 62 6f 75 6e 64 69 6e 67 0a 62 6f 78 2e 20 41 | bounding.box. A| 000008d0 73 20 74 68 65 20 69 63 6f 6e 20 68 61 73 20 74 |s the icon has t| 000008e0 6f 20 62 65 20 64 65 6c 65 74 65 64 20 61 6e 64 |o be deleted and| 000008f0 20 74 68 65 6e 0a 72 65 63 72 65 61 74 65 64 20 | then.recreated | 00000900 69 74 20 72 65 74 75 72 6e 73 20 74 68 65 20 6e |it returns the n| 00000910 65 77 20 69 63 6f 6e 20 68 61 6e 64 6c 65 20 28 |ew icon handle (| 00000920 77 68 69 63 68 0a 73 68 6f 75 6c 64 20 62 65 20 |which.should be | 00000930 74 68 65 20 73 61 6d 65 20 61 73 20 74 68 65 20 |the same as the | 00000940 6f 6c 64 20 68 61 6e 64 6c 65 29 2e 20 54 68 65 |old handle). The| 00000950 20 69 63 6f 6e 0a 69 73 20 72 65 64 72 61 77 6e | icon.is redrawn| 00000960 20 61 66 74 65 72 20 72 65 73 69 7a 69 6e 67 2c | after resizing,| 00000970 20 74 61 6b 69 6e 67 20 61 63 63 6f 75 6e 74 20 | taking account | 00000980 6f 66 20 61 6e 79 0a 33 44 20 62 6f 72 64 65 72 |of any.3D border| 00000990 73 2e 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |s...------------| 000009a0 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |----------------| * 000009c0 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 46 4e |------------..FN| 000009d0 73 68 65 6c 6c 5f 49 63 6f 6e 47 65 74 44 61 74 |shell_IconGetDat| 000009e0 61 28 29 0a 50 61 72 61 6d 73 20 3d 3e 0a 20 20 |a().Params =>. | 000009f0 20 20 20 20 20 20 20 69 6e 74 20 77 69 6e 64 6f | int windo| 00000a00 77 20 68 61 6e 64 6c 65 20 20 0a 20 20 20 20 20 |w handle . | 00000a10 20 20 20 20 69 6e 74 20 69 63 6f 6e 20 68 61 6e | int icon han| 00000a20 64 6c 65 0a 0a 20 20 20 20 20 20 20 3c 3d 0a 20 |dle.. <=. | 00000a30 20 20 20 20 20 20 20 20 73 74 72 20 69 63 6f 6e | str icon| 00000a40 20 74 65 78 74 0a 0a 53 65 65 20 61 6c 73 6f 20 | text..See also | 00000a50 3c 50 52 4f 43 73 68 65 6c 6c 5f 49 63 6f 6e 50 |<PROCshell_IconP| 00000a60 75 74 44 61 74 61 3e 2e 0a 0a 2d 2d 2d 2d 2d 2d |utData>...------| 00000a70 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |----------------| * 00000aa0 2d 2d 0a 0a 50 52 4f 43 73 68 65 6c 6c 5f 49 63 |--..PROCshell_Ic| 00000ab0 6f 6e 62 61 72 53 65 74 54 65 78 74 28 29 0a 50 |onbarSetText().P| 00000ac0 61 72 61 6d 73 20 3d 3e 0a 20 20 20 20 20 20 20 |arams =>. | 00000ad0 20 20 69 6e 74 20 77 69 6e 64 6f 77 20 68 61 6e | int window han| 00000ae0 64 6c 65 20 20 20 20 20 0a 20 20 20 20 20 20 20 |dle . | 00000af0 20 20 69 6e 74 20 69 63 6f 6e 20 68 61 6e 64 6c | int icon handl| 00000b00 65 0a 20 20 20 20 20 20 20 20 20 73 74 72 20 74 |e. str t| 00000b10 65 78 74 20 75 6e 64 65 72 20 69 63 6f 6e 0a 0a |ext under icon..| 00000b20 41 20 70 72 6f 62 6c 65 6d 20 63 61 6e 20 6f 63 |A problem can oc| 00000b30 63 75 72 20 77 69 74 68 20 74 68 69 73 20 63 61 |cur with this ca| 00000b40 6c 6c 20 69 66 20 52 49 53 43 20 4f 53 0a 32 20 |ll if RISC OS.2 | 00000b50 69 73 20 69 6e 20 75 73 65 2e 20 41 73 20 69 74 |is in use. As it| 00000b60 20 64 6f 65 73 20 6e 6f 74 20 73 65 65 6d 20 70 | does not seem p| 00000b70 6f 73 73 69 62 6c 65 20 74 6f 0a 64 69 73 63 6f |ossible to.disco| 00000b80 76 65 72 20 74 68 65 20 73 63 72 6f 6c 6c 20 6f |ver the scroll o| 00000b90 66 66 73 65 74 73 20 6f 66 20 74 68 65 20 69 63 |ffsets of the ic| 00000ba0 6f 6e 62 61 72 20 74 68 65 0a 63 6f 72 72 65 63 |onbar the.correc| 00000bb0 74 20 61 72 65 61 20 6f 66 20 74 68 65 20 69 63 |t area of the ic| 00000bc0 6f 6e 62 61 72 20 6d 61 79 20 6e 6f 74 20 62 65 |onbar may not be| 00000bd0 20 72 65 64 72 61 77 6e 0a 61 66 74 65 72 20 63 | redrawn.after c| 00000be0 68 61 6e 67 69 6e 67 20 74 68 65 20 74 65 78 74 |hanging the text| 00000bf0 2e 20 41 6e 79 20 73 75 67 67 65 73 74 69 6f 6e |. Any suggestion| 00000c00 73 20 77 6f 75 6c 64 0a 62 65 20 67 72 61 74 65 |s would.be grate| 00000c10 66 75 6c 6c 79 20 72 65 63 65 69 76 65 64 2e 2e |fully received..| 00000c20 2e 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |...-------------| 00000c30 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |----------------| * 00000c50 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 50 52 4f |-----------..PRO| 00000c60 43 73 68 65 6c 6c 5f 49 63 6f 6e 50 75 74 44 61 |Cshell_IconPutDa| 00000c70 74 61 28 29 0a 50 61 72 61 6d 73 20 3d 3e 20 0a |ta().Params => .| 00000c80 20 20 20 20 20 20 20 20 20 69 6e 74 20 77 69 6e | int win| 00000c90 64 6f 77 20 68 61 6e 64 6c 65 20 0a 20 20 20 20 |dow handle . | 00000ca0 20 20 20 20 20 69 6e 74 20 69 63 6f 6e 20 68 61 | int icon ha| 00000cb0 6e 64 6c 65 0a 20 20 20 20 20 20 20 20 20 73 74 |ndle. st| 00000cc0 72 20 74 65 78 74 20 74 6f 20 69 6e 73 65 72 74 |r text to insert| 00000cd0 20 69 6e 74 6f 20 69 63 6f 6e 0a 20 20 20 20 20 | into icon. | 00000ce0 20 20 20 20 69 6e 74 20 72 65 64 72 61 77 20 66 | int redraw f| 00000cf0 6c 61 67 0a 0a 41 6e 20 65 72 72 6f 72 20 69 73 |lag..An error is| 00000d00 20 67 65 6e 65 72 61 74 65 64 20 69 66 20 74 68 | generated if th| 00000d10 65 20 74 65 78 74 20 69 73 20 74 6f 6f 0a 6c 6f |e text is too.lo| 00000d20 6e 67 20 74 6f 20 66 69 74 20 69 6e 20 74 68 65 |ng to fit in the| 00000d30 20 69 63 6f 6e 2e 0a 0a 49 66 20 74 68 65 20 74 | icon...If the t| 00000d40 65 78 74 20 74 6f 20 69 6e 73 65 72 74 20 69 73 |ext to insert is| 00000d50 20 74 68 65 20 73 61 6d 65 20 61 73 20 74 68 65 | the same as the| 00000d60 0a 65 78 69 73 74 69 6e 67 20 74 65 78 74 20 74 |.existing text t| 00000d70 68 65 6e 20 6e 6f 20 61 63 74 69 6f 6e 20 69 73 |hen no action is| 00000d80 20 74 61 6b 65 6e 2c 0a 61 76 6f 69 64 69 6e 67 | taken,.avoiding| 00000d90 20 61 6e 79 20 66 6c 69 63 6b 65 72 69 6e 67 20 | any flickering | 00000da0 6f 66 20 74 68 65 20 69 63 6f 6e 2e 0a 0a 49 66 |of the icon...If| 00000db0 20 74 68 65 20 72 65 64 72 61 77 20 66 6c 61 67 | the redraw flag| 00000dc0 20 69 73 20 54 52 55 45 20 77 69 6d 70 20 70 6f | is TRUE wimp po| 00000dd0 6c 6c 20 69 73 0a 63 61 6c 6c 65 64 20 69 6d 6d |ll is.called imm| 00000de0 65 64 69 61 74 65 6c 79 20 74 6f 20 75 70 64 61 |ediately to upda| 00000df0 74 65 20 74 68 65 20 69 63 6f 6e 0a 63 6f 6e 74 |te the icon.cont| 00000e00 65 6e 74 73 2e 20 4e 6f 74 65 20 74 68 61 74 20 |ents. Note that | 00000e10 69 66 20 74 68 65 20 77 69 6e 64 6f 77 20 69 73 |if the window is| 00000e20 20 6e 6f 74 0a 6f 70 65 6e 20 28 66 6f 72 20 65 | not.open (for e| 00000e30 78 61 6d 70 6c 65 20 69 66 20 79 6f 75 20 61 72 |xample if you ar| 00000e40 65 20 63 61 6c 6c 69 6e 67 20 74 68 69 73 0a 72 |e calling this.r| 00000e50 6f 75 74 69 6e 65 20 69 6e 20 61 20 70 72 65 2d |outine in a pre-| 00000e60 6f 70 65 6e 20 66 75 6e 63 74 69 6f 6e 29 20 74 |open function) t| 00000e70 68 65 6e 20 74 68 65 0a 72 65 64 72 61 77 20 66 |hen the.redraw f| 00000e80 6c 61 67 20 73 68 6f 75 6c 64 20 62 65 20 46 41 |lag should be FA| 00000e90 4c 53 45 20 61 73 20 74 68 65 20 77 68 6f 6c 65 |LSE as the whole| 00000ea0 0a 77 69 6e 64 6f 77 20 77 69 6c 6c 20 62 65 20 |.window will be | 00000eb0 72 65 64 72 61 77 6e 20 77 68 65 6e 20 69 74 20 |redrawn when it | 00000ec0 69 73 20 6f 70 65 6e 65 64 2e 0a 0a 2d 2d 2d 2d |is opened...----| 00000ed0 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |----------------| * 00000f00 2d 2d 2d 2d 0a 0a 50 52 4f 43 73 68 65 6c 6c 5f |----..PROCshell_| 00000f10 49 63 6f 6e 50 75 74 44 61 74 61 4e 6f 77 28 29 |IconPutDataNow()| 00000f20 0a 50 61 72 61 6d 73 20 3d 3e 20 0a 20 20 20 20 |.Params => . | 00000f30 20 20 20 20 20 69 6e 74 20 77 69 6e 64 6f 77 20 | int window | 00000f40 68 61 6e 64 6c 65 20 0a 20 20 20 20 20 20 20 20 |handle . | 00000f50 20 69 6e 74 20 69 63 6f 6e 20 68 61 6e 64 6c 65 | int icon handle| 00000f60 0a 20 20 20 20 20 20 20 20 20 73 74 72 20 74 65 |. str te| 00000f70 78 74 20 74 6f 20 69 6e 73 65 72 74 20 69 6e 74 |xt to insert int| 00000f80 6f 20 69 63 6f 6e 0a 0a 41 6e 20 65 72 72 6f 72 |o icon..An error| 00000f90 20 69 73 20 67 65 6e 65 72 61 74 65 64 20 69 66 | is generated if| 00000fa0 20 74 68 65 20 74 65 78 74 20 69 73 20 74 6f 6f | the text is too| 00000fb0 0a 6c 6f 6e 67 20 74 6f 20 66 69 74 20 69 6e 20 |.long to fit in | 00000fc0 74 68 65 20 69 63 6f 6e 2e 0a 0a 54 68 69 73 20 |the icon...This | 00000fd0 63 61 6c 6c 20 69 73 20 73 69 6d 69 6c 61 72 20 |call is similar | 00000fe0 74 6f 20 50 52 4f 43 73 68 65 6c 6c 5f 49 63 6f |to PROCshell_Ico| 00000ff0 6e 50 75 74 44 61 74 61 2c 0a 74 68 65 20 64 69 |nPutData,.the di| 00001000 66 66 65 72 65 6e 63 65 20 62 65 69 6e 67 20 74 |fference being t| 00001010 68 61 74 20 50 52 4f 43 73 68 65 6c 6c 5f 45 6e |hat PROCshell_En| 00001020 73 75 72 65 20 69 73 0a 63 61 6c 6c 65 64 20 74 |sure is.called t| 00001030 6f 20 6d 61 6b 65 20 73 75 72 65 20 74 68 61 74 |o make sure that| 00001040 20 74 68 65 20 69 63 6f 6e 20 69 73 20 75 70 64 | the icon is upd| 00001050 61 74 65 64 0a 69 6d 6d 65 64 69 61 74 65 6c 79 |ated.immediately| 00001060 2e 20 54 68 69 73 20 69 73 20 69 6d 70 6f 72 74 |. This is import| 00001070 61 6e 74 20 69 66 20 79 6f 75 72 20 70 72 6f 67 |ant if your prog| 00001080 72 61 6d 0a 69 73 20 70 65 72 66 6f 72 6d 69 6e |ram.is performin| 00001090 67 20 73 6f 6d 65 20 6e 6f 6e 20 6d 75 6c 74 69 |g some non multi| 000010a0 20 74 61 73 6b 69 6e 67 20 6f 70 65 72 61 74 69 | tasking operati| 000010b0 6f 6e 0a 61 6e 64 20 79 6f 75 20 77 61 6e 74 20 |on.and you want | 000010c0 61 6e 20 69 63 6f 6e 20 74 6f 20 73 68 6f 77 20 |an icon to show | 000010d0 61 20 73 74 61 74 75 73 20 6d 65 73 73 61 67 65 |a status message| 000010e0 2e 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |...-------------| 000010f0 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |----------------| * 00001110 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 50 52 4f |-----------..PRO| 00001120 43 73 68 65 6c 6c 5f 49 63 6f 6e 52 65 64 72 61 |Cshell_IconRedra| 00001130 77 28 29 0a 50 61 72 61 6d 73 20 3d 3e 20 20 20 |w().Params => | 00001140 20 0a 20 20 20 20 20 20 20 20 20 69 6e 74 20 77 | . int w| 00001150 69 6e 64 6f 77 20 68 61 6e 64 6c 65 20 20 20 20 |indow handle | 00001160 0a 20 20 20 20 20 20 20 20 20 69 6e 74 20 69 63 |. int ic| 00001170 6f 6e 20 68 61 6e 64 6c 65 0a 0a 46 6f 72 63 65 |on handle..Force| 00001180 20 61 20 72 65 64 72 61 77 20 6f 66 20 74 68 65 | a redraw of the| 00001190 20 73 63 72 65 65 6e 0a 61 72 65 61 20 63 6f 76 | screen.area cov| 000011a0 65 72 65 64 20 62 79 20 74 68 65 20 67 69 76 65 |ered by the give| 000011b0 6e 20 69 63 6f 6e 0a 28 69 6e 63 6c 75 64 69 6e |n icon.(includin| 000011c0 67 20 61 6e 79 20 33 44 20 62 6f 72 64 65 72 73 |g any 3D borders| 000011d0 29 2e 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |)...------------| 000011e0 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |----------------| * 00001200 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 50 52 |------------..PR| 00001210 4f 43 73 68 65 6c 6c 5f 49 63 6f 6e 50 75 74 56 |OCshell_IconPutV| 00001220 61 6c 69 64 61 74 69 6f 6e 28 29 0a 50 61 72 61 |alidation().Para| 00001230 6d 73 20 3d 3e 20 20 20 20 20 20 0a 20 20 20 20 |ms => . | 00001240 20 20 20 20 20 69 6e 74 20 77 69 6e 64 6f 77 20 | int window | 00001250 68 61 6e 64 6c 65 20 20 20 20 20 20 0a 20 20 20 |handle . | 00001260 20 20 20 20 20 20 69 6e 74 20 69 63 6f 6e 20 68 | int icon h| 00001270 61 6e 64 6c 65 0a 20 20 20 20 20 20 20 20 20 73 |andle. s| 00001280 74 72 20 6e 65 77 20 76 61 6c 69 64 61 74 69 6f |tr new validatio| 00001290 6e 20 73 74 72 69 6e 67 0a 0a 53 65 65 20 61 6c |n string..See al| 000012a0 73 6f 20 46 4e 73 68 65 6c 6c 5f 49 63 6f 6e 47 |so FNshell_IconG| 000012b0 65 74 56 61 6c 69 64 61 74 69 6f 6e 2e 0a 0a 2d |etValidation...-| 000012c0 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |----------------| * 000012f0 2d 2d 2d 2d 2d 2d 2d 0a 0a 50 52 4f 43 73 68 65 |-------..PROCshe| 00001300 6c 6c 5f 49 63 6f 6e 53 65 6c 65 63 74 28 29 0a |ll_IconSelect().| 00001310 50 61 72 61 6d 73 20 3d 3e 20 20 20 20 20 20 20 |Params => | 00001320 20 0a 20 20 20 20 20 20 20 20 20 69 6e 74 20 77 | . int w| 00001330 69 6e 64 6f 77 20 68 61 6e 64 6c 65 20 20 20 20 |indow handle | 00001340 20 20 20 20 0a 20 20 20 20 20 20 20 20 20 69 6e | . in| 00001350 74 20 69 63 6f 6e 20 68 61 6e 64 6c 65 0a 0a 4d |t icon handle..M| 00001360 61 6b 65 20 74 68 65 20 73 70 65 63 69 66 69 65 |ake the specifie| 00001370 64 20 69 63 6f 6e 20 73 65 6c 65 63 74 65 64 2e |d icon selected.| 00001380 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |..--------------| 00001390 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |----------------| * 000013b0 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 50 52 4f 43 |----------..PROC| 000013c0 73 68 65 6c 6c 5f 49 63 6f 6e 44 65 73 65 6c 65 |shell_IconDesele| 000013d0 63 74 28 29 0a 50 61 72 61 6d 73 20 3d 3e 20 20 |ct().Params => | 000013e0 20 20 20 20 20 20 20 0a 20 20 20 20 20 20 20 20 | . | 000013f0 20 69 6e 74 20 77 69 6e 64 6f 77 20 68 61 6e 64 | int window hand| 00001400 6c 65 20 20 20 20 20 20 20 20 20 0a 20 20 20 20 |le . | 00001410 20 20 20 20 20 69 6e 74 20 69 63 6f 6e 20 68 61 | int icon ha| 00001420 6e 64 6c 65 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |ndle..----------| 00001430 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |----------------| * 00001450 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a |--------------..| 00001460 50 52 4f 43 73 68 65 6c 6c 5f 49 63 6f 6e 55 6e |PROCshell_IconUn| 00001470 73 65 6c 65 63 74 61 62 6c 65 28 29 0a 50 61 72 |selectable().Par| 00001480 61 6d 73 20 3d 3e 20 20 20 20 20 20 20 20 20 20 |ams => | 00001490 0a 20 20 20 20 20 20 20 20 20 69 6e 74 20 77 69 |. int wi| 000014a0 6e 64 6f 77 20 68 61 6e 64 6c 65 20 20 20 20 20 |ndow handle | 000014b0 20 20 20 20 20 0a 20 20 20 20 20 20 20 20 20 69 | . i| 000014c0 6e 74 20 69 63 6f 6e 20 68 61 6e 64 6c 65 0a 0a |nt icon handle..| 000014d0 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |----------------| * 00001500 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 50 52 4f 43 73 68 |--------..PROCsh| 00001510 65 6c 6c 5f 49 63 6f 6e 53 65 74 42 47 43 6f 6c |ell_IconSetBGCol| 00001520 6f 75 72 28 29 0a 50 61 72 61 6d 73 20 3d 3e 20 |our().Params => | 00001530 20 20 20 20 20 20 20 20 20 20 0a 20 20 20 20 20 | . | 00001540 20 20 20 20 69 6e 74 20 77 69 6e 64 6f 77 20 68 | int window h| 00001550 61 6e 64 6c 65 20 20 20 20 20 20 20 20 20 20 20 |andle | 00001560 0a 20 20 20 20 20 20 20 20 20 69 6e 74 20 69 63 |. int ic| 00001570 6f 6e 20 68 61 6e 64 6c 65 20 0a 20 20 20 20 20 |on handle . | 00001580 20 20 20 20 69 6e 74 20 62 61 63 6b 67 72 6f 75 | int backgrou| 00001590 6e 64 20 63 6f 6c 6f 75 72 0a 0a 41 6e 20 65 72 |nd colour..An er| 000015a0 72 6f 72 20 69 73 20 67 65 6e 65 72 61 74 65 64 |ror is generated| 000015b0 20 69 66 20 74 68 65 20 63 6f 6c 6f 75 72 0a 6e | if the colour.n| 000015c0 75 6d 62 65 72 20 69 73 20 6f 75 74 73 69 64 65 |umber is outside| 000015d0 20 74 68 65 20 72 61 6e 67 65 20 30 2d 31 35 2e | the range 0-15.| 000015e0 0a 0a 53 65 65 20 61 6c 73 6f 20 50 52 4f 43 73 |..See also PROCs| 000015f0 68 65 6c 6c 5f 49 63 6f 6e 53 65 74 46 47 43 6f |hell_IconSetFGCo| 00001600 6c 6f 75 72 2e 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d |lour...---------| 00001610 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |----------------| * 00001630 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a |---------------.| 00001640 0a 50 52 4f 43 73 68 65 6c 6c 5f 49 63 6f 6e 53 |.PROCshell_IconS| 00001650 65 74 46 47 43 6f 6c 6f 75 72 28 29 0a 50 61 72 |etFGColour().Par| 00001660 61 6d 73 20 3d 3e 20 20 20 20 20 20 20 20 20 20 |ams => | 00001670 20 20 0a 20 20 20 20 20 20 20 20 20 69 6e 74 20 | . int | 00001680 77 69 6e 64 6f 77 20 68 61 6e 64 6c 65 20 20 20 |window handle | 00001690 20 20 20 20 20 20 20 20 20 0a 20 20 20 20 20 20 | . | 000016a0 20 20 20 69 6e 74 20 69 63 6f 6e 20 68 61 6e 64 | int icon hand| 000016b0 6c 65 20 20 0a 20 20 20 20 20 20 20 20 20 69 6e |le . in| 000016c0 74 20 66 6f 72 65 67 72 6f 75 6e 64 20 63 6f 6c |t foreground col| 000016d0 6f 75 72 0a 0a 41 6e 20 65 72 72 6f 72 20 69 73 |our..An error is| 000016e0 20 67 65 6e 65 72 61 74 65 64 20 69 66 20 74 68 | generated if th| 000016f0 65 20 63 6f 6c 6f 75 72 0a 6e 75 6d 62 65 72 20 |e colour.number | 00001700 69 73 20 6f 75 74 73 69 64 65 20 74 68 65 20 72 |is outside the r| 00001710 61 6e 67 65 20 30 2d 31 35 2e 0a 0a 53 65 65 20 |ange 0-15...See | 00001720 61 6c 73 6f 20 50 52 4f 43 73 68 65 6c 6c 5f 49 |also PROCshell_I| 00001730 63 6f 6e 53 65 74 42 47 43 6f 6c 6f 75 72 2e 0a |conSetBGColour..| 00001740 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |.---------------| 00001750 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |----------------| * 00001770 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 50 52 4f 43 73 |---------..PROCs| 00001780 68 65 6c 6c 5f 49 63 6f 6e 53 65 74 42 75 74 74 |hell_IconSetButt| 00001790 6f 6e 54 79 70 65 28 29 0a 50 61 72 61 6d 73 20 |onType().Params | 000017a0 3d 3e 20 20 20 20 20 20 20 20 20 20 20 20 0a 20 |=> . | 000017b0 20 20 20 20 20 20 20 20 69 6e 74 20 77 69 6e 64 | int wind| 000017c0 6f 77 20 68 61 6e 64 6c 65 20 20 20 20 20 20 20 |ow handle | 000017d0 20 20 20 20 20 0a 20 20 20 20 20 20 20 20 20 69 | . i| 000017e0 6e 74 20 69 63 6f 6e 20 68 61 6e 64 6c 65 20 20 |nt icon handle | 000017f0 0a 20 20 20 20 20 20 20 20 20 69 6e 74 20 62 75 |. int bu| 00001800 74 74 6f 6e 20 74 79 70 65 0a 0a 41 6e 20 65 72 |tton type..An er| 00001810 72 6f 72 20 69 73 20 67 65 6e 65 72 61 74 65 64 |ror is generated| 00001820 20 69 66 20 74 68 65 20 62 75 74 74 6f 6e 0a 74 | if the button.t| 00001830 79 70 65 20 69 73 20 6f 75 74 73 69 64 65 20 74 |ype is outside t| 00001840 68 65 20 72 61 6e 67 65 20 30 2d 31 31 2c 31 34 |he range 0-11,14| 00001850 2d 31 35 2e 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |-15...----------| 00001860 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |----------------| * 00001880 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a |--------------..| 00001890 50 52 4f 43 73 68 65 6c 6c 5f 49 63 6f 6e 53 65 |PROCshell_IconSe| 000018a0 74 45 53 47 28 29 0a 50 61 72 61 6d 73 20 3d 3e |tESG().Params =>| 000018b0 20 20 20 20 20 20 20 20 20 20 20 20 0a 20 20 20 | . | 000018c0 20 20 20 20 20 20 69 6e 74 20 77 69 6e 64 6f 77 | int window| 000018d0 20 68 61 6e 64 6c 65 20 20 20 20 20 20 20 20 20 | handle | 000018e0 20 20 20 0a 20 20 20 20 20 20 20 20 20 69 6e 74 | . int| 000018f0 20 69 63 6f 6e 20 68 61 6e 64 6c 65 20 20 0a 20 | icon handle . | 00001900 20 20 20 20 20 20 20 20 69 6e 74 20 45 78 63 6c | int Excl| 00001910 75 73 69 76 65 20 53 65 6c 65 63 74 69 6f 6e 20 |usive Selection | 00001920 47 72 6f 75 70 0a 20 20 20 20 20 20 20 20 20 20 |Group. | 00001930 20 20 20 6e 75 6d 62 65 72 0a 0a 41 6e 20 65 72 | number..An er| 00001940 72 6f 72 20 69 73 20 67 65 6e 65 72 61 74 65 64 |ror is generated| 00001950 20 69 66 20 74 68 65 20 65 73 67 20 6e 75 6d 62 | if the esg numb| 00001960 65 72 0a 69 73 20 6f 75 74 73 69 64 65 20 74 68 |er.is outside th| 00001970 65 20 72 61 6e 67 65 20 30 2d 33 31 2e 0a 0a 2d |e range 0-31...-| 00001980 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |----------------| * 000019b0 2d 2d 2d 2d 2d 2d 2d 0a 0a 50 52 4f 43 73 68 65 |-------..PROCshe| 000019c0 6c 6c 5f 49 63 6f 6e 53 65 74 54 65 78 74 28 29 |ll_IconSetText()| 000019d0 0a 50 61 72 61 6d 73 20 3d 3e 20 20 20 20 20 20 |.Params => | 000019e0 20 20 20 20 20 20 0a 20 20 20 20 20 20 20 20 20 | . | 000019f0 69 6e 74 20 20 77 69 6e 64 6f 77 20 68 61 6e 64 |int window hand| 00001a00 6c 65 20 20 20 20 20 20 20 20 20 20 20 20 0a 20 |le . | 00001a10 20 20 20 20 20 20 20 20 69 6e 74 20 20 69 63 6f | int ico| 00001a20 6e 20 68 61 6e 64 6c 65 20 20 0a 20 20 20 20 20 |n handle . | 00001a30 20 20 20 20 62 6f 6f 6c 20 73 74 61 74 65 20 28 | bool state (| 00001a40 30 20 74 6f 20 63 6c 65 61 72 20 74 65 78 74 20 |0 to clear text | 00001a50 62 69 74 2c 0a 20 20 20 20 20 20 20 20 20 20 20 |bit,. | 00001a60 20 20 20 6e 6f 6e 2d 30 20 74 6f 20 73 65 74 20 | non-0 to set | 00001a70 69 74 29 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |it)..-----------| 00001a80 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |----------------| * 00001aa0 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 50 |-------------..P| 00001ab0 52 4f 43 73 68 65 6c 6c 5f 49 63 6f 6e 53 65 74 |ROCshell_IconSet| 00001ac0 53 70 72 69 74 65 28 29 0a 50 61 72 61 6d 73 20 |Sprite().Params | 00001ad0 3d 3e 20 20 20 20 20 20 20 20 20 20 20 20 0a 20 |=> . | 00001ae0 20 20 20 20 20 20 20 20 69 6e 74 20 20 77 69 6e | int win| 00001af0 64 6f 77 20 68 61 6e 64 6c 65 20 20 20 20 20 20 |dow handle | 00001b00 20 20 20 20 20 20 0a 20 20 20 20 20 20 20 20 20 | . | 00001b10 69 6e 74 20 20 69 63 6f 6e 20 68 61 6e 64 6c 65 |int icon handle| 00001b20 20 20 0a 20 20 20 20 20 20 20 20 20 62 6f 6f 6c | . bool| 00001b30 20 73 74 61 74 65 20 28 30 20 74 6f 20 63 6c 65 | state (0 to cle| 00001b40 61 72 20 73 70 72 69 74 65 20 62 69 74 2c 0a 20 |ar sprite bit,. | 00001b50 20 20 20 20 20 20 20 20 20 20 20 20 20 6e 6f 6e | non| 00001b60 2d 30 20 74 6f 20 73 65 74 20 69 74 29 0a 0a 2d |-0 to set it)..-| 00001b70 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |----------------| * 00001ba0 2d 2d 2d 2d 2d 2d 2d 0a 0a 50 52 4f 43 73 68 65 |-------..PROCshe| 00001bb0 6c 6c 5f 49 63 6f 6e 53 65 74 42 6f 72 64 65 72 |ll_IconSetBorder| 00001bc0 28 29 0a 50 61 72 61 6d 73 20 3d 3e 20 20 20 20 |().Params => | 00001bd0 20 20 20 20 20 20 20 20 0a 20 20 20 20 20 20 20 | . | 00001be0 20 20 69 6e 74 20 20 77 69 6e 64 6f 77 20 68 61 | int window ha| 00001bf0 6e 64 6c 65 20 20 20 20 20 20 20 20 20 20 20 20 |ndle | 00001c00 0a 20 20 20 20 20 20 20 20 20 69 6e 74 20 20 69 |. int i| 00001c10 63 6f 6e 20 68 61 6e 64 6c 65 20 20 0a 20 20 20 |con handle . | 00001c20 20 20 20 20 20 20 62 6f 6f 6c 20 73 74 61 74 65 | bool state| 00001c30 20 28 30 20 74 6f 20 63 6c 65 61 72 20 62 6f 72 | (0 to clear bor| 00001c40 64 65 72 20 62 69 74 2c 0a 20 20 20 20 20 20 20 |der bit,. | 00001c50 20 20 20 20 20 20 20 6e 6f 6e 2d 30 20 74 6f 20 | non-0 to | 00001c60 73 65 74 20 69 74 29 0a 0a 2d 2d 2d 2d 2d 2d 2d |set it)..-------| 00001c70 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |----------------| * 00001ca0 2d 0a 0a 50 52 4f 43 73 68 65 6c 6c 5f 49 63 6f |-..PROCshell_Ico| 00001cb0 6e 53 65 74 48 43 65 6e 74 72 65 64 28 29 0a 50 |nSetHCentred().P| 00001cc0 61 72 61 6d 73 20 3d 3e 20 20 20 20 20 20 20 20 |arams => | 00001cd0 20 20 20 20 0a 20 20 20 20 20 20 20 20 20 69 6e | . in| 00001ce0 74 20 20 77 69 6e 64 6f 77 20 68 61 6e 64 6c 65 |t window handle| 00001cf0 20 20 20 20 20 20 20 20 20 20 20 20 0a 20 20 20 | . | 00001d00 20 20 20 20 20 20 69 6e 74 20 20 69 63 6f 6e 20 | int icon | 00001d10 68 61 6e 64 6c 65 20 20 0a 20 20 20 20 20 20 20 |handle . | 00001d20 20 20 62 6f 6f 6c 20 73 74 61 74 65 20 28 30 20 | bool state (0 | 00001d30 74 6f 20 63 6c 65 61 72 20 68 6f 72 69 7a 6f 6e |to clear horizon| 00001d40 74 61 6c 6c 79 0a 20 20 20 20 20 20 20 20 20 20 |tally. | 00001d50 20 20 20 20 63 65 6e 74 72 65 64 20 62 69 74 2c | centred bit,| 00001d60 20 6e 6f 6e 2d 30 20 74 6f 20 73 65 74 20 69 74 | non-0 to set it| 00001d70 29 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |)..-------------| 00001d80 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |----------------| * 00001da0 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 50 52 4f |-----------..PRO| 00001db0 43 73 68 65 6c 6c 5f 49 63 6f 6e 53 65 74 56 43 |Cshell_IconSetVC| 00001dc0 65 6e 74 72 65 64 28 29 0a 50 61 72 61 6d 73 20 |entred().Params | 00001dd0 3d 3e 20 20 20 20 20 20 20 20 20 20 20 20 0a 20 |=> . | 00001de0 20 20 20 20 20 20 20 20 69 6e 74 20 20 77 69 6e | int win| 00001df0 64 6f 77 20 68 61 6e 64 6c 65 20 20 20 20 20 20 |dow handle | 00001e00 20 20 20 20 20 20 0a 20 20 20 20 20 20 20 20 20 | . | 00001e10 69 6e 74 20 20 69 63 6f 6e 20 68 61 6e 64 6c 65 |int icon handle| 00001e20 20 20 0a 20 20 20 20 20 20 20 20 20 62 6f 6f 6c | . bool| 00001e30 20 73 74 61 74 65 20 28 30 20 74 6f 20 63 6c 65 | state (0 to cle| 00001e40 61 72 20 76 65 72 74 69 63 61 6c 6c 79 0a 20 20 |ar vertically. | 00001e50 20 20 20 20 20 20 20 20 20 20 20 20 63 65 6e 74 | cent| 00001e60 72 65 64 20 62 69 74 2c 20 6e 6f 6e 2d 30 20 74 |red bit, non-0 t| 00001e70 6f 20 73 65 74 20 69 74 29 0a 0a 2d 2d 2d 2d 2d |o set it)..-----| 00001e80 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |----------------| * 00001eb0 2d 2d 2d 0a 0a 50 52 4f 43 73 68 65 6c 6c 5f 49 |---..PROCshell_I| 00001ec0 63 6f 6e 53 65 74 52 69 67 68 74 4a 75 73 74 28 |conSetRightJust(| 00001ed0 29 0a 50 61 72 61 6d 73 20 3d 3e 20 20 20 20 20 |).Params => | 00001ee0 20 20 20 20 20 20 20 0a 20 20 20 20 20 20 20 20 | . | 00001ef0 20 69 6e 74 20 20 77 69 6e 64 6f 77 20 68 61 6e | int window han| 00001f00 64 6c 65 20 20 20 20 20 20 20 20 20 20 20 20 0a |dle .| 00001f10 20 20 20 20 20 20 20 20 20 69 6e 74 20 20 69 63 | int ic| 00001f20 6f 6e 20 68 61 6e 64 6c 65 20 20 0a 20 20 20 20 |on handle . | 00001f30 20 20 20 20 20 62 6f 6f 6c 20 73 74 61 74 65 20 | bool state | 00001f40 28 30 20 74 6f 20 63 6c 65 61 72 20 72 69 67 68 |(0 to clear righ| 00001f50 74 20 6a 75 73 74 69 66 69 65 64 0a 20 20 20 20 |t justified. | 00001f60 20 20 20 20 20 20 20 20 20 20 62 69 74 2c 20 6e | bit, n| 00001f70 6f 6e 2d 30 20 74 6f 20 73 65 74 20 69 74 29 0a |on-0 to set it).| 00001f80 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |.---------------| 00001f90 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |----------------| * 00001fb0 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 50 52 4f 43 73 |---------..PROCs| 00001fc0 68 65 6c 6c 5f 49 63 6f 6e 53 65 74 4c 65 66 74 |hell_IconSetLeft| 00001fd0 4a 75 73 74 28 29 0a 50 61 72 61 6d 73 20 3d 3e |Just().Params =>| 00001fe0 20 20 20 20 20 20 20 20 20 20 20 20 0a 20 20 20 | . | 00001ff0 20 20 20 20 20 20 69 6e 74 20 20 77 69 6e 64 6f | int windo| 00002000 77 20 68 61 6e 64 6c 65 20 20 20 20 20 20 20 20 |w handle | 00002010 20 20 20 20 0a 20 20 20 20 20 20 20 20 20 69 6e | . in| 00002020 74 20 20 69 63 6f 6e 20 68 61 6e 64 6c 65 20 20 |t icon handle | 00002030 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |..--------------| 00002040 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |----------------| * 00002060 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 50 52 4f 43 |----------..PROC| 00002070 73 68 65 6c 6c 5f 49 63 6f 6e 53 65 74 46 69 6c |shell_IconSetFil| 00002080 6c 65 64 28 29 0a 50 61 72 61 6d 73 20 3d 3e 20 |led().Params => | 00002090 20 20 20 20 20 20 20 20 20 20 20 0a 20 20 20 20 | . | 000020a0 20 20 20 20 20 69 6e 74 20 20 77 69 6e 64 6f 77 | int window| 000020b0 20 68 61 6e 64 6c 65 20 20 20 20 20 20 20 20 20 | handle | 000020c0 20 20 20 0a 20 20 20 20 20 20 20 20 20 69 6e 74 | . int| 000020d0 20 20 69 63 6f 6e 20 68 61 6e 64 6c 65 20 20 0a | icon handle .| 000020e0 20 20 20 20 20 20 20 20 20 62 6f 6f 6c 20 73 74 | bool st| 000020f0 61 74 65 20 28 30 20 74 6f 20 63 6c 65 61 72 20 |ate (0 to clear | 00002100 66 69 6c 6c 65 64 0a 20 20 20 20 20 20 20 20 20 |filled. | 00002110 20 20 20 20 20 62 69 74 2c 20 6e 6f 6e 2d 30 20 | bit, non-0 | 00002120 74 6f 20 73 65 74 20 69 74 29 0a 0a 2d 2d 2d 2d |to set it)..----| 00002130 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |----------------| * 00002160 2d 2d 2d 2d 0a 0a 50 52 4f 43 73 68 65 6c 6c 5f |----..PROCshell_| 00002170 43 61 72 65 74 53 65 74 50 6f 73 69 74 69 6f 6e |CaretSetPosition| 00002180 28 29 0a 50 61 72 61 6d 73 20 3d 3e 20 20 20 20 |().Params => | 00002190 20 20 20 20 20 20 20 20 20 0a 20 20 20 20 20 20 | . | 000021a0 20 20 20 69 6e 74 20 77 69 6e 64 6f 77 20 68 61 | int window ha| 000021b0 6e 64 6c 65 20 20 20 20 20 20 20 20 20 20 20 20 |ndle | 000021c0 20 0a 20 20 20 20 20 20 20 20 20 69 6e 74 20 69 | . int i| 000021d0 63 6f 6e 20 68 61 6e 64 6c 65 0a 20 20 20 20 20 |con handle. | 000021e0 20 20 20 20 69 6e 74 20 78 20 6f 66 66 73 65 74 | int x offset| 000021f0 20 69 6e 20 69 63 6f 6e 20 28 75 73 75 61 6c 6c | in icon (usuall| 00002200 79 20 2d 31 29 0a 20 20 20 20 20 20 20 20 20 69 |y -1). i| 00002210 6e 74 20 79 20 6f 66 66 73 65 74 20 69 6e 20 69 |nt y offset in i| 00002220 63 6f 6e 20 28 75 73 75 61 6c 6c 79 20 2d 31 29 |con (usually -1)| 00002230 0a 20 20 20 20 20 20 20 20 20 69 6e 74 20 68 65 |. int he| 00002240 69 67 68 74 20 28 75 73 75 61 6c 6c 79 20 2d 31 |ight (usually -1| 00002250 29 0a 20 20 20 20 20 20 20 20 20 69 6e 74 20 69 |). int i| 00002260 6e 64 65 78 0a 0a 41 6c 6c 6f 77 73 20 74 68 65 |ndex..Allows the| 00002270 20 63 61 72 65 74 20 74 6f 20 62 65 20 70 6f 73 | caret to be pos| 00002280 69 74 69 6f 6e 65 64 20 77 69 74 68 69 6e 0a 61 |itioned within.a| 00002290 6e 20 69 63 6f 6e 2e 20 74 68 65 20 69 6e 64 65 |n icon. the inde| 000022a0 78 20 70 61 72 61 6d 65 74 65 72 20 69 73 20 74 |x parameter is t| 000022b0 68 65 0a 6e 75 6d 62 65 72 20 6f 66 20 63 68 61 |he.number of cha| 000022c0 72 61 63 74 65 72 73 20 62 65 66 6f 72 65 20 74 |racters before t| 000022d0 68 65 20 63 61 72 65 74 2e 0a 0a 53 65 65 20 61 |he caret...See a| 000022e0 6c 73 6f 20 50 52 4f 43 73 68 65 6c 6c 5f 43 61 |lso PROCshell_Ca| 000022f0 72 65 74 53 65 74 52 69 67 68 74 2e 0a 0a 2d 2d |retSetRight...--| 00002300 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |----------------| * 00002330 2d 2d 2d 2d 2d 2d 0a 0a 50 52 4f 43 73 68 65 6c |------..PROCshel| 00002340 6c 5f 43 61 72 65 74 53 65 74 52 69 67 68 74 28 |l_CaretSetRight(| 00002350 29 0a 50 61 72 61 6d 73 20 3d 3e 20 20 20 20 20 |).Params => | 00002360 20 20 20 20 20 20 20 20 20 0a 20 20 20 20 20 20 | . | 00002370 20 20 20 69 6e 74 20 77 69 6e 64 6f 77 20 68 61 | int window ha| 00002380 6e 64 6c 65 20 20 20 20 20 20 20 20 20 20 20 20 |ndle | 00002390 20 20 0a 20 20 20 20 20 20 20 20 20 69 6e 74 20 | . int | 000023a0 69 63 6f 6e 20 68 61 6e 64 6c 65 0a 0a 50 6f 73 |icon handle..Pos| 000023b0 69 74 69 6f 6e 73 20 74 68 65 20 63 61 72 65 74 |itions the caret| 000023c0 20 61 74 20 74 68 65 20 72 69 67 68 74 20 68 61 | at the right ha| 000023d0 6e 64 0a 65 6e 64 20 6f 66 20 61 6e 79 20 74 65 |nd.end of any te| 000023e0 78 74 20 69 6e 20 74 68 65 20 73 70 65 63 69 66 |xt in the specif| 000023f0 69 65 64 20 69 63 6f 6e 2e 0a 0a 53 65 65 20 61 |ied icon...See a| 00002400 6c 73 6f 20 50 52 4f 43 73 68 65 6c 6c 5f 43 61 |lso PROCshell_Ca| 00002410 72 65 74 53 65 74 50 6f 73 69 74 69 6f 6e 2e 0a |retSetPosition..| 00002420 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |.---------------| 00002430 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |----------------| * 00002450 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 46 4e 73 68 65 |---------..FNshe| 00002460 6c 6c 5f 49 63 6f 6e 62 61 72 28 29 0a 50 61 72 |ll_Iconbar().Par| 00002470 61 6d 73 20 3d 3e 0a 20 20 20 20 20 20 20 20 20 |ams =>. | 00002480 69 6e 74 20 20 2d 31 20 66 6f 72 20 72 69 67 68 |int -1 for righ| 00002490 74 20 73 69 64 65 20 6f 66 20 62 61 72 2c 20 2d |t side of bar, -| 000024a0 32 20 66 6f 72 20 6c 65 66 74 20 73 69 64 65 0a |2 for left side.| 000024b0 20 20 20 20 20 20 20 20 20 73 74 72 20 20 73 70 | str sp| 000024c0 72 69 74 65 20 6e 61 6d 65 0a 20 20 20 20 20 20 |rite name. | 000024d0 20 20 20 73 74 72 20 20 74 65 78 74 20 75 6e 64 | str text und| 000024e0 65 72 20 69 63 6f 6e 0a 20 20 20 20 20 20 20 20 |er icon. | 000024f0 20 69 6e 74 20 20 77 69 64 74 68 20 6f 66 20 69 | int width of i| 00002500 63 6f 6e 2f 74 65 78 74 20 28 77 68 69 63 68 65 |con/text (whiche| 00002510 76 65 72 20 69 73 20 6c 61 72 67 65 72 29 0a 20 |ver is larger). | 00002520 20 20 20 20 20 20 20 20 73 74 72 20 20 6d 65 6e | str men| 00002530 75 20 6e 61 6d 65 0a 20 20 20 20 20 20 20 20 20 |u name. | 00002540 62 6f 6f 6c 20 73 68 69 66 74 20 66 6c 61 67 20 |bool shift flag | 00002550 28 6e 6f 74 20 69 6d 70 6c 65 6d 65 6e 74 65 64 |(not implemented| 00002560 29 0a 20 20 20 20 20 20 20 20 20 62 6f 6f 6c 20 |). bool | 00002570 63 74 72 6c 20 20 66 6c 61 67 20 28 6e 6f 74 20 |ctrl flag (not | 00002580 69 6d 70 6c 65 6d 65 6e 74 65 64 29 0a 20 20 20 |implemented). | 00002590 20 20 20 20 20 20 62 6f 6f 6c 20 61 6c 74 20 20 | bool alt | 000025a0 20 66 6c 61 67 20 28 6e 6f 74 20 69 6d 70 6c 65 | flag (not imple| 000025b0 6d 65 6e 74 65 64 29 0a 20 20 20 20 20 20 20 20 |mented). | 000025c0 20 73 74 72 20 20 66 75 6e 63 74 69 6f 6e 20 6e | str function n| 000025d0 61 6d 65 0a 0a 54 68 65 20 73 68 69 66 74 2c 20 |ame..The shift, | 000025e0 63 74 72 6c 20 61 6e 64 20 61 6c 74 20 66 6c 61 |ctrl and alt fla| 000025f0 67 73 20 61 72 65 20 66 6f 72 20 66 75 74 75 72 |gs are for futur| 00002600 65 0a 65 6e 68 61 6e 63 65 6d 65 6e 74 73 20 74 |e.enhancements t| 00002610 6f 20 74 68 65 20 6c 69 62 72 61 72 79 20 61 6e |o the library an| 00002620 64 20 73 68 6f 75 6c 64 20 62 65 20 73 65 74 0a |d should be set.| 00002630 74 6f 20 30 20 6f 6e 20 74 68 69 73 20 72 65 6c |to 0 on this rel| 00002640 65 61 73 65 2e 0a 0a 46 4e 73 68 65 6c 6c 5f 49 |ease...FNshell_I| 00002650 63 6f 6e 47 65 74 56 61 6c 69 64 61 74 69 6f 6e |conGetValidation| 00002660 28 29 0a 50 61 72 61 6d 73 20 3d 3e 0a 20 20 20 |().Params =>. | 00002670 20 20 20 20 20 20 69 6e 74 20 77 69 6e 64 6f 77 | int window| 00002680 20 68 61 6e 64 6c 65 20 20 20 20 20 0a 20 20 20 | handle . | 00002690 20 20 20 20 20 20 69 6e 74 20 69 63 6f 6e 20 68 | int icon h| 000026a0 61 6e 64 6c 65 0a 20 20 20 20 20 20 20 20 20 0a |andle. .| 000026b0 20 20 20 20 20 20 20 3c 3d 0a 20 20 20 20 20 20 | <=. | 000026c0 20 20 20 73 74 72 20 76 61 6c 69 64 61 74 69 6f | str validatio| 000026d0 6e 20 73 74 72 69 6e 67 0a 0a 53 65 65 20 61 6c |n string..See al| 000026e0 73 6f 20 50 52 4f 43 73 68 65 6c 6c 5f 49 63 6f |so PROCshell_Ico| 000026f0 6e 50 75 74 56 61 6c 69 64 61 74 69 6f 6e 2e 0a |nPutValidation..| 00002700 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |.---------------| 00002710 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |----------------| * 00002730 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 46 4e 73 68 65 |---------..FNshe| 00002740 6c 6c 5f 49 63 6f 6e 4e 65 77 53 70 72 69 74 65 |ll_IconNewSprite| 00002750 28 29 0a 50 61 72 61 6d 73 20 3d 3e 0a 20 20 20 |().Params =>. | 00002760 20 20 20 20 20 20 69 6e 74 20 77 69 6e 64 6f 77 | int window| 00002770 20 68 61 6e 64 6c 65 20 20 20 0a 20 20 20 20 20 | handle . | 00002780 20 20 20 20 69 6e 74 20 69 63 6f 6e 20 68 61 6e | int icon han| 00002790 64 6c 65 0a 20 20 20 20 20 20 20 20 20 73 74 72 |dle. str| 000027a0 20 6e 65 77 20 73 70 72 69 74 65 20 6e 61 6d 65 | new sprite name| 000027b0 0a 20 20 20 20 20 20 20 20 20 69 6e 74 20 72 65 |. int re| 000027c0 64 72 61 77 20 66 6c 61 67 0a 0a 20 20 20 20 20 |draw flag.. | 000027d0 20 20 3c 3d 0a 20 20 20 20 20 20 20 20 20 69 6e | <=. in| 000027e0 74 20 6e 65 77 20 69 63 6f 6e 20 68 61 6e 64 6c |t new icon handl| 000027f0 65 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |e..-------------| 00002800 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |----------------| * 00002820 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 46 4e 73 |-----------..FNs| 00002830 68 65 6c 6c 5f 49 73 49 63 6f 6e 53 65 6c 65 63 |hell_IsIconSelec| 00002840 74 65 64 28 29 0a 50 61 72 61 6d 73 20 3d 3e 0a |ted().Params =>.| 00002850 20 20 20 20 20 20 20 20 20 69 6e 74 20 20 77 69 | int wi| 00002860 6e 64 6f 77 20 68 61 6e 64 6c 65 20 20 20 20 20 |ndow handle | 00002870 20 20 0a 20 20 20 20 20 20 20 20 20 69 6e 74 20 | . int | 00002880 20 69 63 6f 6e 20 68 61 6e 64 6c 65 0a 0a 20 20 | icon handle.. | 00002890 20 20 20 20 20 3c 3d 0a 20 20 20 20 20 20 20 20 | <=. | 000028a0 20 62 6f 6f 6c 20 54 52 55 45 20 69 66 20 73 65 | bool TRUE if se| 000028b0 6c 65 63 74 65 64 2c 20 46 41 4c 53 45 20 6f 74 |lected, FALSE ot| 000028c0 68 65 72 77 69 73 65 0a 0a 2d 2d 2d 2d 2d 2d 2d |herwise..-------| 000028d0 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |----------------| * 00002900 2d 0a 0a 46 4e 73 68 65 6c 6c 5f 49 63 6f 6e 49 |-..FNshell_IconI| 00002910 73 44 72 61 67 67 61 62 6c 65 28 29 0a 50 61 72 |sDraggable().Par| 00002920 61 6d 73 20 3d 3e 0a 20 20 20 20 20 20 20 20 20 |ams =>. | 00002930 69 6e 74 20 20 77 69 6e 64 6f 77 20 68 61 6e 64 |int window hand| 00002940 6c 65 20 20 20 20 20 20 20 0a 20 20 20 20 20 20 |le . | 00002950 20 20 20 69 6e 74 20 20 69 63 6f 6e 20 68 61 6e | int icon han| 00002960 64 6c 65 0a 0a 20 20 20 20 20 20 20 3c 3d 0a 20 |dle.. <=. | 00002970 20 20 20 20 20 20 20 20 62 6f 6f 6c 20 54 52 55 | bool TRU| 00002980 45 20 69 66 20 64 72 61 67 67 61 62 6c 65 2c 20 |E if draggable, | 00002990 46 41 4c 53 45 20 6f 74 68 65 72 77 69 73 65 0a |FALSE otherwise.| 000029a0 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |.---------------| 000029b0 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |----------------| * 000029d0 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 46 4e 73 68 65 |---------..FNshe| 000029e0 6c 6c 5f 49 63 6f 6e 49 73 53 70 72 69 74 65 28 |ll_IconIsSprite(| 000029f0 29 0a 50 61 72 61 6d 73 20 3d 3e 0a 20 20 20 20 |).Params =>. | 00002a00 20 20 20 20 20 69 6e 74 20 20 77 69 6e 64 6f 77 | int window| 00002a10 20 68 61 6e 64 6c 65 20 20 20 20 20 20 20 0a 20 | handle . | 00002a20 20 20 20 20 20 20 20 20 69 6e 74 20 20 69 63 6f | int ico| 00002a30 6e 20 68 61 6e 64 6c 65 0a 0a 20 20 20 20 20 20 |n handle.. | 00002a40 20 3c 3d 0a 20 20 20 20 20 20 20 20 20 62 6f 6f | <=. boo| 00002a50 6c 20 54 52 55 45 20 69 66 20 73 70 72 69 74 65 |l TRUE if sprite| 00002a60 2c 20 46 41 4c 53 45 20 6f 74 68 65 72 77 69 73 |, FALSE otherwis| 00002a70 65 0a 20 20 20 20 20 20 20 20 20 0a 2d 2d 2d 2d |e. .----| 00002a80 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |----------------| * 00002ab0 2d 2d 2d 2d 0a 46 4e 73 68 65 6c 6c 5f 49 63 6f |----.FNshell_Ico| 00002ac0 6e 43 72 65 61 74 65 28 29 0a 50 61 72 61 6d 73 |nCreate().Params| 00002ad0 20 3d 3e 20 0a 20 20 20 20 20 20 20 20 20 69 6e | => . in| 00002ae0 74 20 77 69 6e 64 6f 77 20 68 61 6e 64 6c 65 20 |t window handle | 00002af0 0a 20 20 20 20 20 20 20 20 20 69 6e 74 20 6d 69 |. int mi| 00002b00 6e 20 78 20 63 6f 6f 72 64 20 6f 66 20 69 63 6f |n x coord of ico| 00002b10 6e 0a 20 20 20 20 20 20 20 20 20 69 6e 74 20 6d |n. int m| 00002b20 69 6e 20 79 20 63 6f 6f 72 64 20 6f 66 20 69 63 |in y coord of ic| 00002b30 6f 6e 0a 20 20 20 20 20 20 20 20 20 69 6e 74 20 |on. int | 00002b40 77 69 64 74 68 20 6f 66 20 69 63 6f 6e 0a 20 20 |width of icon. | 00002b50 20 20 20 20 20 20 20 69 6e 74 20 68 65 69 67 68 | int heigh| 00002b60 74 20 6f 66 20 69 63 6f 6e 0a 20 20 20 20 20 20 |t of icon. | 00002b70 20 20 20 69 6e 74 20 66 6f 72 65 67 72 6f 75 6e | int foregroun| 00002b80 64 20 63 6f 6c 6f 75 72 0a 20 20 20 20 20 20 20 |d colour. | 00002b90 20 20 69 6e 74 20 62 61 63 6b 67 72 6f 75 6e 64 | int background| 00002ba0 20 63 6f 6c 6f 75 72 0a 20 20 20 20 20 20 20 20 | colour. | 00002bb0 20 69 6e 74 20 69 63 6f 6e 20 66 6c 61 67 73 0a | int icon flags.| 00002bc0 20 20 20 20 20 20 20 20 20 73 74 72 20 74 65 78 | str tex| 00002bd0 74 20 74 6f 20 69 6e 73 65 72 74 20 69 6e 74 6f |t to insert into| 00002be0 20 69 63 6f 6e 0a 20 20 20 20 20 20 20 20 20 69 | icon. i| 00002bf0 6e 74 20 61 64 64 72 65 73 73 20 6f 66 20 69 6e |nt address of in| 00002c00 64 69 72 65 63 74 65 64 20 64 61 74 61 0a 20 20 |directed data. | 00002c10 20 20 20 20 20 20 20 20 20 20 20 28 69 67 6e 6f | (igno| 00002c20 72 65 64 20 77 68 65 6e 20 6e 6f 74 20 69 6e 64 |red when not ind| 00002c30 69 72 65 63 74 65 64 29 0a 20 20 20 20 20 20 20 |irected). | 00002c40 20 20 69 6e 74 20 6c 65 6e 67 74 68 20 6f 66 20 | int length of | 00002c50 69 6e 64 69 72 65 63 74 65 64 20 62 75 66 66 65 |indirected buffe| 00002c60 72 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 28 |r. (| 00002c70 69 67 6e 6f 72 65 64 20 77 68 65 6e 20 6e 6f 74 |ignored when not| 00002c80 20 69 6e 64 69 72 65 63 74 65 64 29 0a 20 20 20 | indirected). | 00002c90 20 20 20 20 20 20 73 74 72 20 76 61 6c 69 64 61 | str valida| 00002ca0 74 69 6f 6e 20 73 74 72 69 6e 67 0a 0a 20 20 20 |tion string.. | 00002cb0 20 20 20 20 3c 3d 0a 20 20 20 20 20 20 20 20 20 | <=. | 00002cc0 69 6e 74 20 68 61 6e 64 6c 65 20 6f 66 20 6e 65 |int handle of ne| 00002cd0 77 20 69 63 6f 6e 0a 20 20 20 20 20 20 20 20 20 |w icon. | 00002ce0 0a 54 68 69 73 20 72 6f 75 74 69 6e 65 20 69 73 |.This routine is| 00002cf0 20 6f 6e 6c 79 20 75 73 65 64 20 77 68 65 6e 20 | only used when | 00002d00 74 68 65 20 61 70 70 6c 69 63 61 74 69 6f 6e 0a |the application.| 00002d10 6e 65 65 64 73 20 74 6f 20 63 72 65 61 74 65 20 |needs to create | 00002d20 69 63 6f 6e 73 20 69 74 73 65 6c 66 20 72 61 74 |icons itself rat| 00002d30 68 65 72 20 74 68 61 6e 0a 6c 6f 61 64 69 6e 67 |her than.loading| 00002d40 20 74 68 65 6d 20 61 73 20 70 61 72 74 20 6f 66 | them as part of| 00002d50 20 61 20 77 69 6e 64 6f 77 20 64 65 66 69 6e 69 | a window defini| 00002d60 74 69 6f 6e 20 69 6e 0a 61 20 74 65 6d 70 6c 61 |tion in.a templa| 00002d70 74 65 2e 0a 0a 49 74 20 64 6f 65 73 20 6e 6f 74 |te...It does not| 00002d80 20 72 65 64 72 61 77 20 74 68 65 20 61 72 65 61 | redraw the area| 00002d90 20 6f 66 20 74 68 65 20 77 69 6e 64 6f 77 20 6f | of the window o| 00002da0 63 63 75 70 69 65 64 0a 62 79 20 74 68 65 20 6e |ccupied.by the n| 00002db0 65 77 20 69 63 6f 6e 2e 20 49 66 20 74 68 65 20 |ew icon. If the | 00002dc0 77 69 6e 64 6f 77 20 69 73 20 6f 70 65 6e 20 69 |window is open i| 00002dd0 74 20 6d 61 79 20 62 65 0a 6e 65 63 65 73 73 61 |t may be.necessa| 00002de0 72 79 20 74 6f 20 63 61 6c 6c 20 50 52 4f 43 73 |ry to call PROCs| 00002df0 68 65 6c 6c 5f 49 63 6f 6e 52 65 64 72 61 77 20 |hell_IconRedraw | 00002e00 74 6f 20 75 70 64 61 74 65 0a 74 68 65 20 77 69 |to update.the wi| 00002e10 6e 64 6f 77 20 61 72 65 61 20 63 6f 76 65 72 65 |ndow area covere| 00002e20 64 20 62 79 20 74 68 65 20 69 63 6f 6e 2e 0a 0a |d by the icon...| 00002e30 55 73 65 72 20 46 4e 20 28 50 52 4f 43 73 68 65 |User FN (PROCshe| 00002e40 6c 6c 5f 49 63 6f 6e 42 61 72 29 0a 50 61 72 61 |ll_IconBar).Para| 00002e50 6d 73 20 3d 3e 20 0a 20 20 20 20 20 20 20 20 20 |ms => . | 00002e60 73 74 72 20 74 65 78 74 20 6f 66 20 6d 65 6e 75 |str text of menu| 00002e70 20 73 65 6c 65 63 74 69 6f 6e 0a 20 0a 54 68 69 | selection. .Thi| 00002e80 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 63 61 |s function is ca| 00002e90 6c 6c 65 64 20 77 68 65 6e 20 74 68 65 20 75 73 |lled when the us| 00002ea0 65 72 20 63 68 6f 6f 73 65 73 0a 61 6e 20 69 74 |er chooses.an it| 00002eb0 65 6d 20 6f 6e 20 74 68 65 20 6d 65 6e 75 2e 0a |em on the menu..| 00002ec0 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |.---------------| 00002ed0 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |----------------| * 00002ef0 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 50 52 4f 43 73 |---------..PROCs| 00002f00 68 65 6c 6c 5f 49 63 6f 6e 53 65 74 28 29 0a 50 |hell_IconSet().P| 00002f10 61 72 61 6d 73 20 3d 3e 20 20 20 20 20 20 20 20 |arams => | 00002f20 20 0a 20 20 20 20 20 20 20 20 20 69 6e 74 20 20 | . int | 00002f30 77 69 6e 64 6f 77 20 68 61 6e 64 6c 65 0a 20 20 |window handle. | 00002f40 20 20 20 20 20 20 20 69 6e 74 20 20 69 63 6f 6e | int icon| 00002f50 20 68 61 6e 64 6c 65 0a 20 20 20 20 20 20 20 20 | handle. | 00002f60 20 62 6f 6f 6c 20 73 74 61 74 65 20 28 30 20 66 | bool state (0 f| 00002f70 6f 72 20 64 65 73 65 6c 65 63 74 65 64 2c 20 6e |or deselected, n| 00002f80 6f 6e 20 30 0a 20 20 20 20 20 20 20 20 20 20 20 |on 0. | 00002f90 20 20 20 66 6f 72 20 73 65 6c 65 63 74 65 64 29 | for selected)| 00002fa0 0a 0a 54 68 69 73 20 63 61 6c 6c 20 69 73 20 75 |..This call is u| 00002fb0 73 65 64 20 74 6f 20 73 65 6c 65 63 74 20 6f 72 |sed to select or| 00002fc0 20 64 65 73 65 6c 65 63 74 20 69 63 6f 6e 73 0a | deselect icons.| 00002fd0 64 65 70 65 6e 64 69 6e 67 20 6f 6e 20 74 68 65 |depending on the| 00002fe0 20 76 61 6c 75 65 20 6f 66 20 74 68 65 20 73 74 | value of the st| 00002ff0 61 74 65 20 66 6c 61 67 0a 0a 2d 2d 2d 2d 2d 2d |ate flag..------| 00003000 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |----------------| * 00003030 2d 2d 0a 0a 50 52 4f 43 73 68 65 6c 6c 5f 49 63 |--..PROCshell_Ic| 00003040 6f 6e 53 65 74 53 65 6c 65 63 74 65 64 28 29 0a |onSetSelected().| 00003050 50 61 72 61 6d 73 20 3d 3e 20 20 20 20 20 20 20 |Params => | 00003060 20 20 0a 20 20 20 20 20 20 20 20 20 69 6e 74 20 | . int | 00003070 20 77 69 6e 64 6f 77 20 68 61 6e 64 6c 65 0a 20 | window handle. | 00003080 20 20 20 20 20 20 20 20 69 6e 74 20 20 69 63 6f | int ico| 00003090 6e 20 68 61 6e 64 6c 65 0a 20 20 20 20 20 20 20 |n handle. | 000030a0 20 20 62 6f 6f 6c 20 73 74 61 74 65 20 28 30 20 | bool state (0 | 000030b0 66 6f 72 20 64 65 73 65 6c 65 63 74 65 64 2c 20 |for deselected, | 000030c0 6e 6f 6e 20 30 0a 20 20 20 20 20 20 20 20 20 20 |non 0. | 000030d0 20 20 20 20 66 6f 72 20 73 65 6c 65 63 74 65 64 | for selected| 000030e0 29 0a 0a 54 68 69 73 20 63 61 6c 6c 20 69 73 20 |)..This call is | 000030f0 75 73 65 64 20 74 6f 20 73 65 6c 65 63 74 20 6f |used to select o| 00003100 72 20 64 65 73 65 6c 65 63 74 20 69 63 6f 6e 73 |r deselect icons| 00003110 0a 64 65 70 65 6e 64 69 6e 67 20 6f 6e 20 74 68 |.depending on th| 00003120 65 20 76 61 6c 75 65 20 6f 66 20 74 68 65 20 73 |e value of the s| 00003130 74 61 74 65 20 66 6c 61 67 0a 0a 2d 2d 2d 2d 2d |tate flag..-----| 00003140 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |----------------| * 00003170 2d 2d 2d 0a 0a 50 52 4f 43 73 68 65 6c 6c 5f 49 |---..PROCshell_I| 00003180 63 6f 6e 53 65 74 55 6e 73 65 6c 65 63 74 61 62 |conSetUnselectab| 00003190 6c 65 28 29 0a 50 61 72 61 6d 73 20 3d 3e 20 20 |le().Params => | 000031a0 20 20 20 20 20 20 20 0a 20 20 20 20 20 20 20 20 | . | 000031b0 20 69 6e 74 20 20 77 69 6e 64 6f 77 20 68 61 6e | int window han| 000031c0 64 6c 65 0a 20 20 20 20 20 20 20 20 20 69 6e 74 |dle. int| 000031d0 20 20 69 63 6f 6e 20 68 61 6e 64 6c 65 0a 20 20 | icon handle. | 000031e0 20 20 20 20 20 20 20 62 6f 6f 6c 20 73 74 61 74 | bool stat| 000031f0 65 20 28 30 20 74 6f 20 6d 61 6b 65 20 69 63 6f |e (0 to make ico| 00003200 6e 20 73 65 6c 65 63 74 61 62 6c 65 2c 0a 20 20 |n selectable,. | 00003210 20 20 20 20 20 20 20 20 20 20 20 20 6e 6f 6e 20 | non | 00003220 30 20 74 6f 20 6d 61 6b 65 20 69 74 20 75 6e 73 |0 to make it uns| 00003230 65 6c 65 63 74 61 62 6c 65 29 0a 0a 54 68 69 73 |electable)..This| 00003240 20 63 61 6c 6c 20 69 73 20 75 73 65 64 20 74 6f | call is used to| 00003250 20 6d 61 6b 65 20 69 63 6f 6e 73 20 75 6e 73 65 | make icons unse| 00003260 6c 65 63 74 61 62 6c 65 0a 28 69 2e 65 2e 20 67 |lectable.(i.e. g| 00003270 72 65 79 65 64 20 6f 75 74 29 20 64 65 70 65 6e |reyed out) depen| 00003280 64 69 6e 67 20 6f 6e 20 74 68 65 20 76 61 6c 75 |ding on the valu| 00003290 65 20 6f 66 0a 74 68 65 20 73 74 61 74 65 20 66 |e of.the state f| 000032a0 6c 61 67 2e 20 49 66 20 74 68 65 20 69 63 6f 6e |lag. If the icon| 000032b0 20 63 6f 6e 74 61 69 6e 73 20 74 68 65 20 63 61 | contains the ca| 000032c0 72 65 74 0a 77 68 65 6e 20 69 74 20 69 73 20 6d |ret.when it is m| 000032d0 61 64 65 20 75 6e 73 65 6c 65 63 74 61 62 6c 65 |ade unselectable| 000032e0 2c 20 74 68 65 20 63 61 72 65 74 20 69 73 20 6c |, the caret is l| 000032f0 6f 73 74 2e 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |ost...----------| 00003300 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |----------------| * 00003320 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a |--------------..| 00003330 46 4e 73 68 65 6c 6c 5f 49 63 6f 6e 52 65 73 69 |FNshell_IconResi| 00003340 7a 65 28 29 0a 50 61 72 61 6d 73 20 3d 3e 0a 20 |ze().Params =>. | 00003350 20 20 20 20 20 20 20 20 69 6e 74 20 77 69 6e 64 | int wind| 00003360 6f 77 20 68 61 6e 64 6c 65 20 20 0a 20 20 20 20 |ow handle . | 00003370 20 20 20 20 20 69 6e 74 20 69 63 6f 6e 20 68 61 | int icon ha| 00003380 6e 64 6c 65 0a 20 20 20 20 20 20 20 20 20 69 6e |ndle. in| 00003390 74 20 6d 69 6e 20 78 20 63 6f 6f 72 64 0a 20 20 |t min x coord. | 000033a0 20 20 20 20 20 20 20 69 6e 74 20 6d 69 6e 20 79 | int min y| 000033b0 20 63 6f 6f 72 64 0a 20 20 20 20 20 20 20 20 20 | coord. | 000033c0 69 6e 74 20 6d 61 78 20 78 20 63 6f 6f 72 64 0a |int max x coord.| 000033d0 20 20 20 20 20 20 20 20 20 69 6e 74 20 6d 61 78 | int max| 000033e0 20 79 20 63 6f 6f 72 64 0a 0a 20 20 20 20 20 20 | y coord.. | 000033f0 20 3c 3d 0a 20 20 20 20 20 20 20 20 20 69 6e 74 | <=. int| 00003400 20 69 63 6f 6e 20 68 61 6e 64 6c 65 0a 0a 41 6c | icon handle..Al| 00003410 6c 6f 77 73 20 74 68 65 20 72 65 64 65 66 69 6e |lows the redefin| 00003420 69 74 69 6f 6e 20 6f 66 20 61 6e 20 69 63 6f 6e |ition of an icon| 00003430 27 73 20 62 6f 75 6e 64 69 6e 67 0a 62 6f 78 2e |'s bounding.box.| 00003440 20 41 73 20 74 68 65 20 69 63 6f 6e 20 68 61 73 | As the icon has| 00003450 20 74 6f 20 62 65 20 64 65 6c 65 74 65 64 20 61 | to be deleted a| 00003460 6e 64 20 74 68 65 6e 0a 72 65 63 72 65 61 74 65 |nd then.recreate| 00003470 64 20 69 74 20 72 65 74 75 72 6e 73 20 74 68 65 |d it returns the| 00003480 20 6e 65 77 20 69 63 6f 6e 20 68 61 6e 64 6c 65 | new icon handle| 00003490 20 28 77 68 69 63 68 0a 73 68 6f 75 6c 64 20 62 | (which.should b| 000034a0 65 20 74 68 65 20 73 61 6d 65 20 61 73 20 74 68 |e the same as th| 000034b0 65 20 6f 6c 64 20 68 61 6e 64 6c 65 29 2e 20 54 |e old handle). T| 000034c0 68 65 20 69 63 6f 6e 0a 69 73 20 72 65 64 72 61 |he icon.is redra| 000034d0 77 6e 20 61 66 74 65 72 20 72 65 73 69 7a 69 6e |wn after resizin| 000034e0 67 2c 20 74 61 6b 69 6e 67 20 61 63 63 6f 75 6e |g, taking accoun| 000034f0 74 20 6f 66 20 61 6e 79 0a 33 44 20 62 6f 72 64 |t of any.3D bord| 00003500 65 72 73 2e 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |ers...----------| 00003510 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |----------------| * 00003530 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a |--------------..| 00003540 50 52 4f 43 73 68 65 6c 6c 5f 43 61 72 65 74 50 |PROCshell_CaretP| 00003550 75 74 46 69 72 73 74 49 63 6f 6e 28 29 0a 50 61 |utFirstIcon().Pa| 00003560 72 61 6d 73 20 3d 3e 20 20 20 20 20 20 20 20 20 |rams => | 00003570 20 20 20 20 0a 20 20 20 20 20 20 20 20 20 69 6e | . in| 00003580 74 20 77 69 6e 64 6f 77 20 68 61 6e 64 6c 65 20 |t window handle | 00003590 20 20 20 20 20 20 20 20 20 20 20 20 0a 0a 41 6c | ..Al| 000035a0 6c 6f 77 73 20 74 68 65 20 63 61 72 65 74 20 74 |lows the caret t| 000035b0 6f 20 62 65 20 70 6f 73 69 74 69 6f 6e 65 64 20 |o be positioned | 000035c0 77 69 74 68 69 6e 0a 74 68 65 20 66 69 72 73 74 |within.the first| 000035d0 20 77 72 69 74 61 62 6c 65 20 69 63 6f 6e 20 69 | writable icon i| 000035e0 6e 20 61 20 77 69 6e 64 6f 77 2e 20 49 66 0a 74 |n a window. If.t| 000035f0 68 65 20 63 61 72 65 74 20 69 73 20 6e 6f 74 20 |he caret is not | 00003600 69 6e 20 74 68 65 20 77 69 6e 64 6f 77 2c 20 6f |in the window, o| 00003610 72 20 74 68 65 72 65 0a 61 72 65 20 6e 6f 20 77 |r there.are no w| 00003620 72 69 74 61 62 6c 65 20 69 63 6f 6e 73 20 6e 6f |ritable icons no| 00003630 20 65 72 72 6f 72 20 6f 63 63 75 72 73 2e 0a 0a | error occurs...| 00003640 4e 6f 74 65 20 74 68 61 74 20 74 68 69 73 20 63 |Note that this c| 00003650 61 6c 6c 20 64 6f 65 73 20 6e 6f 74 20 63 6c 61 |all does not cla| 00003660 69 6d 20 74 68 65 0a 63 61 72 65 74 2c 20 69 2e |im the.caret, i.| 00003670 65 2e 20 74 68 65 20 63 61 72 65 74 20 6d 75 73 |e. the caret mus| 00003680 74 20 61 6c 72 65 61 64 79 20 62 65 20 69 6e 0a |t already be in.| 00003690 74 68 65 20 77 69 6e 64 6f 77 2e 0a 0a 2d 2d 2d |the window...---| 000036a0 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |----------------| * 000036d0 2d 2d 2d 2d 2d 0a 0a 50 52 4f 43 73 68 65 6c 6c |-----..PROCshell| 000036e0 5f 43 61 72 65 74 50 75 74 4c 61 73 74 49 63 6f |_CaretPutLastIco| 000036f0 6e 28 29 0a 50 61 72 61 6d 73 20 3d 3e 20 20 20 |n().Params => | 00003700 20 20 20 20 20 20 20 20 20 20 0a 20 20 20 20 20 | . | 00003710 20 20 20 20 69 6e 74 20 77 69 6e 64 6f 77 20 68 | int window h| 00003720 61 6e 64 6c 65 20 20 20 20 20 20 20 20 20 20 20 |andle | 00003730 20 20 0a 0a 41 6c 6c 6f 77 73 20 74 68 65 20 63 | ..Allows the c| 00003740 61 72 65 74 20 74 6f 20 62 65 20 70 6f 73 69 74 |aret to be posit| 00003750 69 6f 6e 65 64 20 77 69 74 68 69 6e 0a 74 68 65 |ioned within.the| 00003760 20 6c 61 73 74 20 77 72 69 74 61 62 6c 65 20 69 | last writable i| 00003770 63 6f 6e 20 69 6e 20 61 20 77 69 6e 64 6f 77 2e |con in a window.| 00003780 20 49 66 0a 74 68 65 20 63 61 72 65 74 20 69 73 | If.the caret is| 00003790 20 6e 6f 74 20 69 6e 20 74 68 65 20 77 69 6e 64 | not in the wind| 000037a0 6f 77 2c 20 6f 72 20 74 68 65 72 65 0a 61 72 65 |ow, or there.are| 000037b0 20 6e 6f 20 77 72 69 74 61 62 6c 65 20 69 63 6f | no writable ico| 000037c0 6e 73 20 6e 6f 20 65 72 72 6f 72 20 6f 63 63 75 |ns no error occu| 000037d0 72 73 2e 0a 0a 4e 6f 74 65 20 74 68 61 74 20 74 |rs...Note that t| 000037e0 68 69 73 20 63 61 6c 6c 20 64 6f 65 73 20 6e 6f |his call does no| 000037f0 74 20 63 6c 61 69 6d 20 74 68 65 0a 63 61 72 65 |t claim the.care| 00003800 74 2c 20 69 2e 65 2e 20 74 68 65 20 63 61 72 65 |t, i.e. the care| 00003810 74 20 6d 75 73 74 20 61 6c 72 65 61 64 79 20 62 |t must already b| 00003820 65 20 69 6e 0a 74 68 65 20 77 69 6e 64 6f 77 2e |e in.the window.| 00003830 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |..--------------| 00003840 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |----------------| * 00003860 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 50 52 4f 43 |----------..PROC| 00003870 73 68 65 6c 6c 5f 43 61 72 65 74 50 75 74 4e 65 |shell_CaretPutNe| 00003880 78 74 49 63 6f 6e 28 29 0a 50 61 72 61 6d 73 20 |xtIcon().Params | 00003890 3d 3e 20 20 20 20 20 20 20 20 20 20 20 20 20 0a |=> .| 000038a0 20 20 20 20 20 20 20 20 20 69 6e 74 20 77 69 6e | int win| 000038b0 64 6f 77 20 68 61 6e 64 6c 65 20 20 20 20 20 20 |dow handle | 000038c0 20 20 20 20 20 20 20 0a 0a 41 6c 6c 6f 77 73 20 | ..Allows | 000038d0 74 68 65 20 63 61 72 65 74 20 74 6f 20 62 65 20 |the caret to be | 000038e0 70 6f 73 69 74 69 6f 6e 65 64 20 77 69 74 68 69 |positioned withi| 000038f0 6e 0a 74 68 65 20 6e 65 78 74 20 77 72 69 74 61 |n.the next writa| 00003900 62 6c 65 20 69 63 6f 6e 20 69 6e 20 61 20 77 69 |ble icon in a wi| 00003910 6e 64 6f 77 2e 20 49 66 0a 74 68 65 20 63 61 72 |ndow. If.the car| 00003920 65 74 20 69 73 20 6e 6f 74 20 69 6e 20 74 68 65 |et is not in the| 00003930 20 77 69 6e 64 6f 77 2c 20 6f 72 20 74 68 65 72 | window, or ther| 00003940 65 0a 61 72 65 20 6e 6f 20 77 72 69 74 61 62 6c |e.are no writabl| 00003950 65 20 69 63 6f 6e 73 20 6e 6f 20 65 72 72 6f 72 |e icons no error| 00003960 20 6f 63 63 75 72 73 2e 0a 0a 4e 6f 74 65 20 74 | occurs...Note t| 00003970 68 61 74 20 74 68 69 73 20 63 61 6c 6c 20 64 6f |hat this call do| 00003980 65 73 20 6e 6f 74 20 63 6c 61 69 6d 20 74 68 65 |es not claim the| 00003990 0a 63 61 72 65 74 2c 20 69 2e 65 2e 20 74 68 65 |.caret, i.e. the| 000039a0 20 63 61 72 65 74 20 6d 75 73 74 20 61 6c 72 65 | caret must alre| 000039b0 61 64 79 20 62 65 20 69 6e 0a 74 68 65 20 77 69 |ady be in.the wi| 000039c0 6e 64 6f 77 2e 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d |ndow...---------| 000039d0 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |----------------| * 000039f0 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a |---------------.| 00003a00 0a 50 52 4f 43 73 68 65 6c 6c 5f 43 61 72 65 74 |.PROCshell_Caret| 00003a10 50 75 74 50 72 65 76 49 63 6f 6e 28 29 0a 50 61 |PutPrevIcon().Pa| 00003a20 72 61 6d 73 20 3d 3e 20 20 20 20 20 20 20 20 20 |rams => | 00003a30 20 20 20 20 0a 20 20 20 20 20 20 20 20 20 69 6e | . in| 00003a40 74 20 77 69 6e 64 6f 77 20 68 61 6e 64 6c 65 20 |t window handle | 00003a50 20 20 20 20 20 20 20 20 20 20 20 20 0a 0a 41 6c | ..Al| 00003a60 6c 6f 77 73 20 74 68 65 20 63 61 72 65 74 20 74 |lows the caret t| 00003a70 6f 20 62 65 20 70 6f 73 69 74 69 6f 6e 65 64 20 |o be positioned | 00003a80 77 69 74 68 69 6e 0a 74 68 65 20 70 72 65 76 69 |within.the previ| 00003a90 6f 75 73 20 77 72 69 74 61 62 6c 65 20 69 63 6f |ous writable ico| 00003aa0 6e 20 69 6e 20 61 20 77 69 6e 64 6f 77 2e 20 49 |n in a window. I| 00003ab0 66 0a 74 68 65 20 63 61 72 65 74 20 69 73 20 6e |f.the caret is n| 00003ac0 6f 74 20 69 6e 20 74 68 65 20 77 69 6e 64 6f 77 |ot in the window| 00003ad0 2c 20 6f 72 20 74 68 65 72 65 0a 61 72 65 20 6e |, or there.are n| 00003ae0 6f 20 77 72 69 74 61 62 6c 65 20 69 63 6f 6e 73 |o writable icons| 00003af0 20 6e 6f 20 65 72 72 6f 72 20 6f 63 63 75 72 73 | no error occurs| 00003b00 2e 0a 0a 4e 6f 74 65 20 74 68 61 74 20 74 68 69 |...Note that thi| 00003b10 73 20 63 61 6c 6c 20 64 6f 65 73 20 6e 6f 74 20 |s call does not | 00003b20 63 6c 61 69 6d 20 74 68 65 0a 63 61 72 65 74 2c |claim the.caret,| 00003b30 20 69 2e 65 2e 20 74 68 65 20 63 61 72 65 74 20 | i.e. the caret | 00003b40 6d 75 73 74 20 61 6c 72 65 61 64 79 20 62 65 20 |must already be | 00003b50 69 6e 0a 74 68 65 20 77 69 6e 64 6f 77 2e 0a 0a |in.the window...| 00003b60 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |----------------| * 00003b90 2d 2d 2d 2d 2d 2d 2d 2d |--------| 00003b98
.