Home » Archimedes archive » Acorn Computing » 1994 08 subscription disc.adf » 9408s » Shareware/Event/Documents/!EShellDoc/TextHelp/Icons
Shareware/Event/Documents/!EShellDoc/TextHelp/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 » Acorn Computing » 1994 08 subscription disc.adf » 9408s |
| Filename: | Shareware/Event/Documents/!EShellDoc/TextHelp/Icons |
| Read OK: | ✔ |
| File size: | 2FFE 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
--------------------------------------------------------
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 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_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_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.
-------------------------------------------------------- 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 3c 46 4e 73 68 65 6c 6c 5f |e also <FNshell_| 000000b0 49 63 6f 6e 47 65 74 56 61 6c 69 64 61 74 69 6f |IconGetValidatio| 000000c0 6e 3e 2e 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |n>...-----------| 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 2d 2d 0a 0a 50 |-------------..P| 00000100 52 4f 43 73 68 65 6c 6c 5f 49 63 6f 6e 53 65 6c |ROCshell_IconSel| 00000110 65 63 74 41 6c 6c 28 29 0a 50 61 72 61 6d 73 20 |ectAll().Params | 00000120 3d 3e 20 20 20 20 20 20 20 20 20 0a 20 20 20 20 |=> . | 00000130 20 20 20 20 20 69 6e 74 20 77 69 6e 64 6f 77 20 | int window | 00000140 68 61 6e 64 6c 65 20 20 20 20 20 20 20 20 20 0a |handle .| 00000150 0a 53 65 6c 65 63 74 73 20 61 6c 6c 20 6f 66 20 |.Selects all of | 00000160 74 68 65 20 69 63 6f 6e 73 20 63 6f 6e 74 61 69 |the icons contai| 00000170 6e 65 64 0a 69 6e 20 74 68 65 20 73 70 65 63 69 |ned.in the speci| 00000180 66 69 65 64 20 77 69 6e 64 6f 77 2e 0a 0a 2d 2d |fied window...--| 00000190 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |----------------| * 000001c0 2d 2d 2d 2d 2d 2d 0a 0a 50 52 4f 43 73 68 65 6c |------..PROCshel| 000001d0 6c 5f 49 63 6f 6e 44 65 73 65 6c 65 63 74 41 6c |l_IconDeselectAl| 000001e0 6c 28 29 0a 50 61 72 61 6d 73 20 3d 3e 20 20 20 |l().Params => | 000001f0 20 20 20 20 20 20 0a 20 20 20 20 20 20 20 20 20 | . | 00000200 69 6e 74 20 77 69 6e 64 6f 77 20 68 61 6e 64 6c |int window handl| 00000210 65 20 20 20 20 20 20 20 20 20 0a 0a 44 65 73 65 |e ..Dese| 00000220 6c 65 63 74 73 20 61 6c 6c 20 6f 66 20 74 68 65 |lects all of the| 00000230 20 69 63 6f 6e 73 20 63 6f 6e 74 61 69 6e 65 64 | icons contained| 00000240 0a 69 6e 20 74 68 65 20 73 70 65 63 69 66 69 65 |.in the specifie| 00000250 64 20 77 69 6e 64 6f 77 2e 0a 0a 2d 2d 2d 2d 2d |d window...-----| 00000260 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |----------------| * 00000290 2d 2d 2d 0a 0a 50 52 4f 43 73 68 65 6c 6c 5f 49 |---..PROCshell_I| 000002a0 63 6f 6e 44 65 6c 65 74 65 28 29 0a 50 61 72 61 |conDelete().Para| 000002b0 6d 73 20 3d 3e 0a 20 20 20 20 20 20 20 20 20 69 |ms =>. i| 000002c0 6e 74 20 77 69 6e 64 6f 77 20 68 61 6e 64 6c 65 |nt window handle| 000002d0 0a 20 20 20 20 20 20 20 20 20 69 6e 74 20 69 63 |. int ic| 000002e0 6f 6e 20 68 61 6e 64 6c 65 0a 0a 54 68 69 73 20 |on handle..This | 000002f0 63 61 6c 6c 20 66 72 65 65 73 20 61 6e 79 20 6d |call frees any m| 00000300 65 6d 6f 72 79 20 75 73 65 64 20 66 6f 72 20 69 |emory used for i| 00000310 6e 64 69 72 65 63 74 65 64 20 64 61 74 61 0a 61 |ndirected data.a| 00000320 6e 64 20 76 61 6c 69 64 61 74 69 6f 6e 20 73 74 |nd validation st| 00000330 72 69 6e 67 73 2e 20 54 68 65 20 77 69 6e 64 6f |rings. The windo| 00000340 77 20 61 72 65 61 20 63 6f 76 65 72 65 64 20 62 |w area covered b| 00000350 79 0a 74 68 65 20 69 63 6f 6e 20 28 69 6e 63 6c |y.the icon (incl| 00000360 75 64 69 6e 67 20 61 6e 79 20 33 44 20 62 6f 72 |uding any 3D bor| 00000370 64 65 72 73 29 20 69 73 20 6e 6f 74 20 72 65 64 |ders) is not red| 00000380 72 61 77 6e 2e 0a 55 73 65 20 50 52 4f 43 73 68 |rawn..Use PROCsh| 00000390 65 6c 6c 5f 49 63 6f 6e 44 65 6c 65 74 65 32 20 |ell_IconDelete2 | 000003a0 74 6f 20 64 65 6c 65 74 65 20 74 68 65 20 69 63 |to delete the ic| 000003b0 6f 6e 20 61 6e 64 0a 72 65 64 72 61 77 20 74 68 |on and.redraw th| 000003c0 65 20 77 69 6e 64 6f 77 20 61 72 65 61 2e 0a 0a |e 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 2d 2d 0a 0a 50 52 4f 43 73 68 |--------..PROCsh| 00000410 65 6c 6c 5f 49 63 6f 6e 44 65 6c 65 74 65 32 28 |ell_IconDelete2(| 00000420 29 0a 50 61 72 61 6d 73 20 3d 3e 0a 20 20 20 20 |).Params =>. | 00000430 20 20 20 20 20 69 6e 74 20 77 69 6e 64 6f 77 20 | int window | 00000440 68 61 6e 64 6c 65 0a 20 20 20 20 20 20 20 20 20 |handle. | 00000450 69 6e 74 20 69 63 6f 6e 20 68 61 6e 64 6c 65 0a |int icon handle.| 00000460 0a 54 68 69 73 20 63 61 6c 6c 20 66 72 65 65 73 |.This call frees| 00000470 20 61 6e 79 20 6d 65 6d 6f 72 79 20 75 73 65 64 | any memory used| 00000480 20 66 6f 72 20 69 6e 64 69 72 65 63 74 65 64 20 | for indirected | 00000490 64 61 74 61 0a 61 6e 64 20 76 61 6c 69 64 61 74 |data.and validat| 000004a0 69 6f 6e 20 73 74 72 69 6e 67 73 2e 20 54 68 65 |ion strings. The| 000004b0 20 77 69 6e 64 6f 77 20 61 72 65 61 20 63 6f 76 | window area cov| 000004c0 65 72 65 64 20 62 79 0a 74 68 65 20 69 63 6f 6e |ered by.the icon| 000004d0 20 28 69 6e 63 6c 75 64 69 6e 67 20 61 6e 79 20 | (including any | 000004e0 33 44 20 62 6f 72 64 65 72 73 29 20 69 73 20 72 |3D borders) is r| 000004f0 65 64 72 61 77 6e 2e 0a 0a 57 68 65 6e 20 61 20 |edrawn...When a | 00000500 6c 61 72 67 65 20 6e 75 6d 62 65 72 20 6f 66 20 |large number of | 00000510 69 63 6f 6e 73 20 61 72 65 20 74 6f 20 62 65 20 |icons are to be | 00000520 64 65 6c 65 74 65 64 20 69 74 20 69 73 0a 62 65 |deleted it is.be| 00000530 74 74 65 72 20 74 6f 20 75 73 65 20 50 52 4f 43 |tter to use PROC| 00000540 73 68 65 6c 6c 5f 49 63 6f 6e 44 65 6c 65 74 65 |shell_IconDelete| 00000550 20 61 6e 64 20 74 68 65 6e 20 72 65 64 72 61 77 | and then redraw| 00000560 0a 74 68 65 20 77 69 6e 64 6f 77 20 61 66 74 65 |.the window afte| 00000570 72 77 61 72 64 73 20 61 73 20 74 68 69 73 20 77 |rwards as this w| 00000580 69 6c 6c 20 62 65 20 71 75 69 63 6b 65 72 2e 0a |ill be quicker..| 00000590 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |.---------------| 000005a0 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |----------------| * 000005c0 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 46 4e 73 68 65 |---------..FNshe| 000005d0 6c 6c 5f 49 63 6f 6e 4d 6f 76 65 32 28 29 0a 50 |ll_IconMove2().P| 000005e0 61 72 61 6d 73 20 3d 3e 0a 20 20 20 20 20 20 20 |arams =>. | 000005f0 20 20 69 6e 74 20 77 69 6e 64 6f 77 20 68 61 6e | int window han| 00000600 64 6c 65 20 20 0a 20 20 20 20 20 20 20 20 20 69 |dle . i| 00000610 6e 74 20 69 63 6f 6e 20 68 61 6e 64 6c 65 0a 20 |nt icon handle. | 00000620 20 20 20 20 20 20 20 20 69 6e 74 20 78 20 64 69 | int x di| 00000630 73 70 6c 61 63 65 6d 65 6e 74 0a 20 20 20 20 20 |splacement. | 00000640 20 20 20 20 69 6e 74 20 79 20 64 69 73 70 6c 61 | int y displa| 00000650 63 65 6d 65 6e 74 0a 0a 20 20 20 20 20 20 20 3c |cement.. <| 00000660 3d 0a 20 20 20 20 20 20 20 20 20 69 6e 74 20 69 |=. int i| 00000670 63 6f 6e 20 68 61 6e 64 6c 65 0a 0a 41 6c 6c 6f |con handle..Allo| 00000680 77 73 20 61 6e 20 69 63 6f 6e 20 74 6f 20 62 65 |ws an icon to be| 00000690 20 6d 6f 76 65 64 20 61 72 6f 75 6e 64 20 74 68 | moved around th| 000006a0 65 20 77 69 6e 64 6f 77 2e 0a 41 73 20 74 68 65 |e window..As the| 000006b0 20 69 63 6f 6e 20 68 61 73 20 74 6f 20 62 65 20 | icon has to be | 000006c0 64 65 6c 65 74 65 64 20 61 6e 64 20 74 68 65 6e |deleted and then| 000006d0 0a 72 65 63 72 65 61 74 65 64 20 69 74 20 72 65 |.recreated it re| 000006e0 74 75 72 6e 73 20 74 68 65 20 6e 65 77 20 69 63 |turns the new ic| 000006f0 6f 6e 20 68 61 6e 64 6c 65 20 28 77 68 69 63 68 |on handle (which| 00000700 0a 73 68 6f 75 6c 64 20 62 65 20 74 68 65 20 73 |.should be the s| 00000710 61 6d 65 20 61 73 20 74 68 65 20 6f 6c 64 20 68 |ame as the old h| 00000720 61 6e 64 6c 65 29 2e 20 54 68 65 20 69 63 6f 6e |andle). The icon| 00000730 0a 69 73 20 72 65 64 72 61 77 6e 20 61 66 74 65 |.is redrawn afte| 00000740 72 20 6d 6f 76 69 6e 67 2c 20 74 61 6b 69 6e 67 |r moving, taking| 00000750 20 61 63 63 6f 75 6e 74 20 6f 66 20 61 6e 79 0a | account of any.| 00000760 33 44 20 62 6f 72 64 65 72 73 2e 0a 0a 53 65 65 |3D borders...See| 00000770 20 61 6c 73 6f 20 46 4e 73 68 65 6c 6c 5f 49 63 | also FNshell_Ic| 00000780 6f 6e 4d 6f 76 65 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d |onMove..--------| 00000790 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |----------------| * 000007c0 0a 0a 46 4e 73 68 65 6c 6c 5f 49 63 6f 6e 4d 6f |..FNshell_IconMo| 000007d0 76 65 28 29 0a 50 61 72 61 6d 73 20 3d 3e 0a 20 |ve().Params =>. | 000007e0 20 20 20 20 20 20 20 20 69 6e 74 20 77 69 6e 64 | int wind| 000007f0 6f 77 20 68 61 6e 64 6c 65 20 20 0a 20 20 20 20 |ow handle . | 00000800 20 20 20 20 20 69 6e 74 20 69 63 6f 6e 20 68 61 | int icon ha| 00000810 6e 64 6c 65 0a 20 20 20 20 20 20 20 20 20 69 6e |ndle. in| 00000820 74 20 6d 69 6e 20 78 20 63 6f 6f 72 64 0a 20 20 |t min x coord. | 00000830 20 20 20 20 20 20 20 69 6e 74 20 6d 69 6e 20 79 | int min y| 00000840 20 63 6f 6f 72 64 0a 20 20 20 20 20 20 20 20 20 | coord. | 00000850 69 6e 74 20 6d 61 78 20 78 20 63 6f 6f 72 64 0a |int max x coord.| 00000860 20 20 20 20 20 20 20 20 20 69 6e 74 20 6d 61 79 | int may| 00000870 20 79 20 63 6f 6f 72 64 0a 0a 20 20 20 20 20 20 | y coord.. | 00000880 20 3c 3d 0a 20 20 20 20 20 20 20 20 20 69 6e 74 | <=. int| 00000890 20 69 63 6f 6e 20 68 61 6e 64 6c 65 0a 0a 41 6c | icon handle..Al| 000008a0 6c 6f 77 73 20 74 68 65 20 72 65 64 65 66 69 6e |lows the redefin| 000008b0 69 74 69 6f 6e 20 6f 66 20 61 6e 20 69 63 6f 6e |ition of an icon| 000008c0 27 73 20 62 6f 75 6e 64 69 6e 67 0a 62 6f 78 2e |'s bounding.box.| 000008d0 20 41 73 20 74 68 65 20 69 63 6f 6e 20 68 61 73 | As the icon has| 000008e0 20 74 6f 20 62 65 20 64 65 6c 65 74 65 64 20 61 | to be deleted a| 000008f0 6e 64 20 74 68 65 6e 0a 72 65 63 72 65 61 74 65 |nd then.recreate| 00000900 64 20 69 74 20 72 65 74 75 72 6e 73 20 74 68 65 |d it returns the| 00000910 20 6e 65 77 20 69 63 6f 6e 20 68 61 6e 64 6c 65 | new icon handle| 00000920 20 28 77 68 69 63 68 0a 73 68 6f 75 6c 64 20 62 | (which.should b| 00000930 65 20 74 68 65 20 73 61 6d 65 20 61 73 20 74 68 |e the same as th| 00000940 65 20 6f 6c 64 20 68 61 6e 64 6c 65 29 2e 20 54 |e old handle). T| 00000950 68 65 20 69 63 6f 6e 0a 69 73 20 72 65 64 72 61 |he icon.is redra| 00000960 77 6e 20 61 66 74 65 72 20 72 65 73 69 7a 69 6e |wn after resizin| 00000970 67 2c 20 74 61 6b 69 6e 67 20 61 63 63 6f 75 6e |g, taking accoun| 00000980 74 20 6f 66 20 61 6e 79 0a 33 44 20 62 6f 72 64 |t of any.3D bord| 00000990 65 72 73 2e 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |ers...----------| 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 2d 2d 0a 0a |--------------..| 000009d0 46 4e 73 68 65 6c 6c 5f 49 63 6f 6e 47 65 74 44 |FNshell_IconGetD| 000009e0 61 74 61 28 29 0a 50 61 72 61 6d 73 20 3d 3e 0a |ata().Params =>.| 000009f0 20 20 20 20 20 20 20 20 20 69 6e 74 20 77 69 6e | int win| 00000a00 64 6f 77 20 68 61 6e 64 6c 65 20 20 0a 20 20 20 |dow handle . | 00000a10 20 20 20 20 20 20 69 6e 74 20 69 63 6f 6e 20 68 | int icon h| 00000a20 61 6e 64 6c 65 0a 0a 20 20 20 20 20 20 20 3c 3d |andle.. <=| 00000a30 0a 20 20 20 20 20 20 20 20 20 73 74 72 20 69 63 |. str ic| 00000a40 6f 6e 20 74 65 78 74 0a 0a 53 65 65 20 61 6c 73 |on text..See als| 00000a50 6f 20 3c 50 52 4f 43 73 68 65 6c 6c 5f 49 63 6f |o <PROCshell_Ico| 00000a60 6e 50 75 74 44 61 74 61 3e 2e 0a 0a 2d 2d 2d 2d |nPutData>...----| 00000a70 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |----------------| * 00000aa0 2d 2d 2d 2d 0a 0a 50 52 4f 43 73 68 65 6c 6c 5f |----..PROCshell_| 00000ab0 49 63 6f 6e 62 61 72 53 65 74 54 65 78 74 28 29 |IconbarSetText()| 00000ac0 0a 50 61 72 61 6d 73 20 3d 3e 0a 20 20 20 20 20 |.Params =>. | 00000ad0 20 20 20 20 69 6e 74 20 77 69 6e 64 6f 77 20 68 | int window h| 00000ae0 61 6e 64 6c 65 20 20 20 20 20 0a 20 20 20 20 20 |andle . | 00000af0 20 20 20 20 69 6e 74 20 69 63 6f 6e 20 68 61 6e | int icon han| 00000b00 64 6c 65 0a 20 20 20 20 20 20 20 20 20 73 74 72 |dle. str| 00000b10 20 74 65 78 74 20 75 6e 64 65 72 20 69 63 6f 6e | text under icon| 00000b20 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |..--------------| 00000b30 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |----------------| * 00000b50 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 50 52 4f 43 |----------..PROC| 00000b60 73 68 65 6c 6c 5f 49 63 6f 6e 50 75 74 44 61 74 |shell_IconPutDat| 00000b70 61 28 29 0a 50 61 72 61 6d 73 20 3d 3e 20 0a 20 |a().Params => . | 00000b80 20 20 20 20 20 20 20 20 69 6e 74 20 77 69 6e 64 | int wind| 00000b90 6f 77 20 68 61 6e 64 6c 65 20 0a 20 20 20 20 20 |ow handle . | 00000ba0 20 20 20 20 69 6e 74 20 69 63 6f 6e 20 68 61 6e | int icon han| 00000bb0 64 6c 65 0a 20 20 20 20 20 20 20 20 20 73 74 72 |dle. str| 00000bc0 20 74 65 78 74 20 74 6f 20 69 6e 73 65 72 74 20 | text to insert | 00000bd0 69 6e 74 6f 20 69 63 6f 6e 0a 20 20 20 20 20 20 |into icon. | 00000be0 20 20 20 69 6e 74 20 72 65 64 72 61 77 20 66 6c | int redraw fl| 00000bf0 61 67 0a 0a 41 6e 20 65 72 72 6f 72 20 69 73 20 |ag..An error is | 00000c00 67 65 6e 65 72 61 74 65 64 20 69 66 20 74 68 65 |generated if the| 00000c10 20 74 65 78 74 20 69 73 20 74 6f 6f 0a 6c 6f 6e | text is too.lon| 00000c20 67 20 74 6f 20 66 69 74 20 69 6e 20 74 68 65 20 |g to fit in the | 00000c30 69 63 6f 6e 2e 0a 0a 49 66 20 74 68 65 20 72 65 |icon...If the re| 00000c40 64 72 61 77 20 66 6c 61 67 20 69 73 20 54 52 55 |draw flag is TRU| 00000c50 45 20 77 69 6d 70 20 70 6f 6c 6c 20 69 73 0a 63 |E wimp poll is.c| 00000c60 61 6c 6c 65 64 20 69 6d 6d 65 64 69 61 74 65 6c |alled immediatel| 00000c70 79 20 74 6f 20 75 70 64 61 74 65 20 74 68 65 20 |y to update the | 00000c80 69 63 6f 6e 0a 63 6f 6e 74 65 6e 74 73 2e 20 4e |icon.contents. N| 00000c90 6f 74 65 20 74 68 61 74 20 69 66 20 74 68 65 20 |ote that if the | 00000ca0 77 69 6e 64 6f 77 20 69 73 20 6e 6f 74 0a 6f 70 |window is not.op| 00000cb0 65 6e 20 28 66 6f 72 20 65 78 61 6d 70 6c 65 20 |en (for example | 00000cc0 69 66 20 79 6f 75 20 61 72 65 20 63 61 6c 6c 69 |if you are calli| 00000cd0 6e 67 20 74 68 69 73 0a 72 6f 75 74 69 6e 65 20 |ng this.routine | 00000ce0 69 6e 20 61 20 70 72 65 2d 6f 70 65 6e 20 66 75 |in a pre-open fu| 00000cf0 6e 63 74 69 6f 6e 29 20 74 68 65 6e 20 74 68 65 |nction) then the| 00000d00 0a 72 65 64 72 61 77 20 66 6c 61 67 20 73 68 6f |.redraw flag sho| 00000d10 75 6c 64 20 62 65 20 46 41 4c 53 45 20 61 73 20 |uld be FALSE as | 00000d20 74 68 65 20 77 68 6f 6c 65 0a 77 69 6e 64 6f 77 |the whole.window| 00000d30 20 77 69 6c 6c 20 62 65 20 72 65 64 72 61 77 6e | will be redrawn| 00000d40 20 77 68 65 6e 20 69 74 20 69 73 20 6f 70 65 6e | when it is open| 00000d50 65 64 2e 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |ed...-----------| 00000d60 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |----------------| * 00000d80 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 50 |-------------..P| 00000d90 52 4f 43 73 68 65 6c 6c 5f 49 63 6f 6e 52 65 64 |ROCshell_IconRed| 00000da0 72 61 77 28 29 0a 50 61 72 61 6d 73 20 3d 3e 20 |raw().Params => | 00000db0 20 20 20 0a 20 20 20 20 20 20 20 20 20 69 6e 74 | . int| 00000dc0 20 77 69 6e 64 6f 77 20 68 61 6e 64 6c 65 20 20 | window handle | 00000dd0 20 20 0a 20 20 20 20 20 20 20 20 20 69 6e 74 20 | . int | 00000de0 69 63 6f 6e 20 68 61 6e 64 6c 65 0a 0a 46 6f 72 |icon handle..For| 00000df0 63 65 20 61 20 72 65 64 72 61 77 20 6f 66 20 74 |ce a redraw of t| 00000e00 68 65 20 73 63 72 65 65 6e 0a 61 72 65 61 20 63 |he screen.area c| 00000e10 6f 76 65 72 65 64 20 62 79 20 74 68 65 20 67 69 |overed by the gi| 00000e20 76 65 6e 20 69 63 6f 6e 0a 28 69 6e 63 6c 75 64 |ven icon.(includ| 00000e30 69 6e 67 20 61 6e 79 20 33 44 20 62 6f 72 64 65 |ing any 3D borde| 00000e40 72 73 29 2e 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |rs)...----------| 00000e50 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |----------------| * 00000e70 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a |--------------..| 00000e80 50 52 4f 43 73 68 65 6c 6c 5f 49 63 6f 6e 50 75 |PROCshell_IconPu| 00000e90 74 56 61 6c 69 64 61 74 69 6f 6e 28 29 0a 50 61 |tValidation().Pa| 00000ea0 72 61 6d 73 20 3d 3e 20 20 20 20 20 20 0a 20 20 |rams => . | 00000eb0 20 20 20 20 20 20 20 69 6e 74 20 77 69 6e 64 6f | int windo| 00000ec0 77 20 68 61 6e 64 6c 65 20 20 20 20 20 20 0a 20 |w handle . | 00000ed0 20 20 20 20 20 20 20 20 69 6e 74 20 69 63 6f 6e | int icon| 00000ee0 20 68 61 6e 64 6c 65 0a 20 20 20 20 20 20 20 20 | handle. | 00000ef0 20 73 74 72 20 6e 65 77 20 76 61 6c 69 64 61 74 | str new validat| 00000f00 69 6f 6e 20 73 74 72 69 6e 67 0a 0a 53 65 65 20 |ion string..See | 00000f10 61 6c 73 6f 20 46 4e 73 68 65 6c 6c 5f 49 63 6f |also FNshell_Ico| 00000f20 6e 47 65 74 56 61 6c 69 64 61 74 69 6f 6e 2e 0a |nGetValidation..| 00000f30 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |.---------------| 00000f40 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |----------------| * 00000f60 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 50 52 4f 43 73 |---------..PROCs| 00000f70 68 65 6c 6c 5f 49 63 6f 6e 53 65 6c 65 63 74 28 |hell_IconSelect(| 00000f80 29 0a 50 61 72 61 6d 73 20 3d 3e 20 20 20 20 20 |).Params => | 00000f90 20 20 20 0a 20 20 20 20 20 20 20 20 20 69 6e 74 | . int| 00000fa0 20 77 69 6e 64 6f 77 20 68 61 6e 64 6c 65 20 20 | window handle | 00000fb0 20 20 20 20 20 20 0a 20 20 20 20 20 20 20 20 20 | . | 00000fc0 69 6e 74 20 69 63 6f 6e 20 68 61 6e 64 6c 65 0a |int icon handle.| 00000fd0 0a 4d 61 6b 65 20 74 68 65 20 73 70 65 63 69 66 |.Make the specif| 00000fe0 69 65 64 20 69 63 6f 6e 20 73 65 6c 65 63 74 65 |ied icon selecte| 00000ff0 64 2e 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |d...------------| 00001000 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |----------------| * 00001020 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 50 52 |------------..PR| 00001030 4f 43 73 68 65 6c 6c 5f 49 63 6f 6e 44 65 73 65 |OCshell_IconDese| 00001040 6c 65 63 74 28 29 0a 50 61 72 61 6d 73 20 3d 3e |lect().Params =>| 00001050 20 20 20 20 20 20 20 20 20 0a 20 20 20 20 20 20 | . | 00001060 20 20 20 69 6e 74 20 77 69 6e 64 6f 77 20 68 61 | int window ha| 00001070 6e 64 6c 65 20 20 20 20 20 20 20 20 20 0a 20 20 |ndle . | 00001080 20 20 20 20 20 20 20 69 6e 74 20 69 63 6f 6e 20 | int icon | 00001090 68 61 6e 64 6c 65 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d |handle..--------| 000010a0 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |----------------| * 000010d0 0a 0a 50 52 4f 43 73 68 65 6c 6c 5f 49 63 6f 6e |..PROCshell_Icon| 000010e0 55 6e 73 65 6c 65 63 74 61 62 6c 65 28 29 0a 50 |Unselectable().P| 000010f0 61 72 61 6d 73 20 3d 3e 20 20 20 20 20 20 20 20 |arams => | 00001100 20 20 0a 20 20 20 20 20 20 20 20 20 69 6e 74 20 | . int | 00001110 77 69 6e 64 6f 77 20 68 61 6e 64 6c 65 20 20 20 |window handle | 00001120 20 20 20 20 20 20 20 0a 20 20 20 20 20 20 20 20 | . | 00001130 20 69 6e 74 20 69 63 6f 6e 20 68 61 6e 64 6c 65 | int icon handle| 00001140 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |..--------------| 00001150 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |----------------| * 00001170 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 50 52 4f 43 |----------..PROC| 00001180 73 68 65 6c 6c 5f 49 63 6f 6e 53 65 74 42 47 43 |shell_IconSetBGC| 00001190 6f 6c 6f 75 72 28 29 0a 50 61 72 61 6d 73 20 3d |olour().Params =| 000011a0 3e 20 20 20 20 20 20 20 20 20 20 20 0a 20 20 20 |> . | 000011b0 20 20 20 20 20 20 69 6e 74 20 77 69 6e 64 6f 77 | int window| 000011c0 20 68 61 6e 64 6c 65 20 20 20 20 20 20 20 20 20 | handle | 000011d0 20 20 0a 20 20 20 20 20 20 20 20 20 69 6e 74 20 | . int | 000011e0 69 63 6f 6e 20 68 61 6e 64 6c 65 20 0a 20 20 20 |icon handle . | 000011f0 20 20 20 20 20 20 69 6e 74 20 62 61 63 6b 67 72 | int backgr| 00001200 6f 75 6e 64 20 63 6f 6c 6f 75 72 0a 0a 41 6e 20 |ound colour..An | 00001210 65 72 72 6f 72 20 69 73 20 67 65 6e 65 72 61 74 |error is generat| 00001220 65 64 20 69 66 20 74 68 65 20 63 6f 6c 6f 75 72 |ed if the colour| 00001230 0a 6e 75 6d 62 65 72 20 69 73 20 6f 75 74 73 69 |.number is outsi| 00001240 64 65 20 74 68 65 20 72 61 6e 67 65 20 30 2d 31 |de the range 0-1| 00001250 35 2e 0a 0a 53 65 65 20 61 6c 73 6f 20 50 52 4f |5...See also PRO| 00001260 43 73 68 65 6c 6c 5f 49 63 6f 6e 53 65 74 46 47 |Cshell_IconSetFG| 00001270 43 6f 6c 6f 75 72 2e 0a 0a 2d 2d 2d 2d 2d 2d 2d |Colour...-------| 00001280 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |----------------| * 000012b0 2d 0a 0a 50 52 4f 43 73 68 65 6c 6c 5f 49 63 6f |-..PROCshell_Ico| 000012c0 6e 53 65 74 46 47 43 6f 6c 6f 75 72 28 29 0a 50 |nSetFGColour().P| 000012d0 61 72 61 6d 73 20 3d 3e 20 20 20 20 20 20 20 20 |arams => | 000012e0 20 20 20 20 0a 20 20 20 20 20 20 20 20 20 69 6e | . in| 000012f0 74 20 77 69 6e 64 6f 77 20 68 61 6e 64 6c 65 20 |t window handle | 00001300 20 20 20 20 20 20 20 20 20 20 20 0a 20 20 20 20 | . | 00001310 20 20 20 20 20 69 6e 74 20 69 63 6f 6e 20 68 61 | int icon ha| 00001320 6e 64 6c 65 20 20 0a 20 20 20 20 20 20 20 20 20 |ndle . | 00001330 69 6e 74 20 66 6f 72 65 67 72 6f 75 6e 64 20 63 |int foreground c| 00001340 6f 6c 6f 75 72 0a 0a 41 6e 20 65 72 72 6f 72 20 |olour..An error | 00001350 69 73 20 67 65 6e 65 72 61 74 65 64 20 69 66 20 |is generated if | 00001360 74 68 65 20 63 6f 6c 6f 75 72 0a 6e 75 6d 62 65 |the colour.numbe| 00001370 72 20 69 73 20 6f 75 74 73 69 64 65 20 74 68 65 |r is outside the| 00001380 20 72 61 6e 67 65 20 30 2d 31 35 2e 0a 0a 53 65 | range 0-15...Se| 00001390 65 20 61 6c 73 6f 20 50 52 4f 43 73 68 65 6c 6c |e also PROCshell| 000013a0 5f 49 63 6f 6e 53 65 74 42 47 43 6f 6c 6f 75 72 |_IconSetBGColour| 000013b0 2e 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |...-------------| 000013c0 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |----------------| * 000013e0 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 50 52 4f |-----------..PRO| 000013f0 43 73 68 65 6c 6c 5f 49 63 6f 6e 53 65 74 42 75 |Cshell_IconSetBu| 00001400 74 74 6f 6e 54 79 70 65 28 29 0a 50 61 72 61 6d |ttonType().Param| 00001410 73 20 3d 3e 20 20 20 20 20 20 20 20 20 20 20 20 |s => | 00001420 0a 20 20 20 20 20 20 20 20 20 69 6e 74 20 77 69 |. int wi| 00001430 6e 64 6f 77 20 68 61 6e 64 6c 65 20 20 20 20 20 |ndow handle | 00001440 20 20 20 20 20 20 20 0a 20 20 20 20 20 20 20 20 | . | 00001450 20 69 6e 74 20 69 63 6f 6e 20 68 61 6e 64 6c 65 | int icon handle| 00001460 20 20 0a 20 20 20 20 20 20 20 20 20 69 6e 74 20 | . int | 00001470 62 75 74 74 6f 6e 20 74 79 70 65 0a 0a 41 6e 20 |button type..An | 00001480 65 72 72 6f 72 20 69 73 20 67 65 6e 65 72 61 74 |error is generat| 00001490 65 64 20 69 66 20 74 68 65 20 62 75 74 74 6f 6e |ed if the button| 000014a0 0a 74 79 70 65 20 69 73 20 6f 75 74 73 69 64 65 |.type is outside| 000014b0 20 74 68 65 20 72 61 6e 67 65 20 30 2d 31 31 2c | the range 0-11,| 000014c0 31 34 2d 31 35 2e 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d |14-15...--------| 000014d0 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |----------------| * 00001500 0a 0a 50 52 4f 43 73 68 65 6c 6c 5f 49 63 6f 6e |..PROCshell_Icon| 00001510 53 65 74 45 53 47 28 29 0a 50 61 72 61 6d 73 20 |SetESG().Params | 00001520 3d 3e 20 20 20 20 20 20 20 20 20 20 20 20 0a 20 |=> . | 00001530 20 20 20 20 20 20 20 20 69 6e 74 20 77 69 6e 64 | int wind| 00001540 6f 77 20 68 61 6e 64 6c 65 20 20 20 20 20 20 20 |ow handle | 00001550 20 20 20 20 20 0a 20 20 20 20 20 20 20 20 20 69 | . i| 00001560 6e 74 20 69 63 6f 6e 20 68 61 6e 64 6c 65 20 20 |nt icon handle | 00001570 0a 20 20 20 20 20 20 20 20 20 69 6e 74 20 45 78 |. int Ex| 00001580 63 6c 75 73 69 76 65 20 53 65 6c 65 63 74 69 6f |clusive Selectio| 00001590 6e 20 47 72 6f 75 70 0a 20 20 20 20 20 20 20 20 |n Group. | 000015a0 20 20 20 20 20 6e 75 6d 62 65 72 0a 0a 41 6e 20 | number..An | 000015b0 65 72 72 6f 72 20 69 73 20 67 65 6e 65 72 61 74 |error is generat| 000015c0 65 64 20 69 66 20 74 68 65 20 65 73 67 20 6e 75 |ed if the esg nu| 000015d0 6d 62 65 72 0a 69 73 20 6f 75 74 73 69 64 65 20 |mber.is outside | 000015e0 74 68 65 20 72 61 6e 67 65 20 30 2d 33 31 2e 0a |the range 0-31..| 000015f0 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |.---------------| 00001600 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |----------------| * 00001620 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 50 52 4f 43 73 |---------..PROCs| 00001630 68 65 6c 6c 5f 49 63 6f 6e 53 65 74 54 65 78 74 |hell_IconSetText| 00001640 28 29 0a 50 61 72 61 6d 73 20 3d 3e 20 20 20 20 |().Params => | 00001650 20 20 20 20 20 20 20 20 0a 20 20 20 20 20 20 20 | . | 00001660 20 20 69 6e 74 20 20 77 69 6e 64 6f 77 20 68 61 | int window ha| 00001670 6e 64 6c 65 20 20 20 20 20 20 20 20 20 20 20 20 |ndle | 00001680 0a 20 20 20 20 20 20 20 20 20 69 6e 74 20 20 69 |. int i| 00001690 63 6f 6e 20 68 61 6e 64 6c 65 20 20 0a 20 20 20 |con handle . | 000016a0 20 20 20 20 20 20 62 6f 6f 6c 20 73 74 61 74 65 | bool state| 000016b0 20 28 30 20 74 6f 20 63 6c 65 61 72 20 74 65 78 | (0 to clear tex| 000016c0 74 20 62 69 74 2c 0a 20 20 20 20 20 20 20 20 20 |t bit,. | 000016d0 20 20 20 20 20 6e 6f 6e 2d 30 20 74 6f 20 73 65 | non-0 to se| 000016e0 74 20 69 74 29 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d |t it)..---------| 000016f0 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |----------------| * 00001710 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a |---------------.| 00001720 0a 50 52 4f 43 73 68 65 6c 6c 5f 49 63 6f 6e 53 |.PROCshell_IconS| 00001730 65 74 53 70 72 69 74 65 28 29 0a 50 61 72 61 6d |etSprite().Param| 00001740 73 20 3d 3e 20 20 20 20 20 20 20 20 20 20 20 20 |s => | 00001750 0a 20 20 20 20 20 20 20 20 20 69 6e 74 20 20 77 |. int w| 00001760 69 6e 64 6f 77 20 68 61 6e 64 6c 65 20 20 20 20 |indow handle | 00001770 20 20 20 20 20 20 20 20 0a 20 20 20 20 20 20 20 | . | 00001780 20 20 69 6e 74 20 20 69 63 6f 6e 20 68 61 6e 64 | int icon hand| 00001790 6c 65 20 20 0a 20 20 20 20 20 20 20 20 20 62 6f |le . bo| 000017a0 6f 6c 20 73 74 61 74 65 20 28 30 20 74 6f 20 63 |ol state (0 to c| 000017b0 6c 65 61 72 20 73 70 72 69 74 65 20 62 69 74 2c |lear sprite bit,| 000017c0 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 6e |. n| 000017d0 6f 6e 2d 30 20 74 6f 20 73 65 74 20 69 74 29 0a |on-0 to set it).| 000017e0 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |.---------------| 000017f0 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |----------------| * 00001810 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 50 52 4f 43 73 |---------..PROCs| 00001820 68 65 6c 6c 5f 49 63 6f 6e 53 65 74 42 6f 72 64 |hell_IconSetBord| 00001830 65 72 28 29 0a 50 61 72 61 6d 73 20 3d 3e 20 20 |er().Params => | 00001840 20 20 20 20 20 20 20 20 20 20 0a 20 20 20 20 20 | . | 00001850 20 20 20 20 69 6e 74 20 20 77 69 6e 64 6f 77 20 | int window | 00001860 68 61 6e 64 6c 65 20 20 20 20 20 20 20 20 20 20 |handle | 00001870 20 20 0a 20 20 20 20 20 20 20 20 20 69 6e 74 20 | . int | 00001880 20 69 63 6f 6e 20 68 61 6e 64 6c 65 20 20 0a 20 | icon handle . | 00001890 20 20 20 20 20 20 20 20 62 6f 6f 6c 20 73 74 61 | bool sta| 000018a0 74 65 20 28 30 20 74 6f 20 63 6c 65 61 72 20 62 |te (0 to clear b| 000018b0 6f 72 64 65 72 20 62 69 74 2c 0a 20 20 20 20 20 |order bit,. | 000018c0 20 20 20 20 20 20 20 20 20 6e 6f 6e 2d 30 20 74 | non-0 t| 000018d0 6f 20 73 65 74 20 69 74 29 0a 0a 2d 2d 2d 2d 2d |o set it)..-----| 000018e0 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |----------------| * 00001910 2d 2d 2d 0a 0a 50 52 4f 43 73 68 65 6c 6c 5f 49 |---..PROCshell_I| 00001920 63 6f 6e 53 65 74 48 43 65 6e 74 72 65 64 28 29 |conSetHCentred()| 00001930 0a 50 61 72 61 6d 73 20 3d 3e 20 20 20 20 20 20 |.Params => | 00001940 20 20 20 20 20 20 0a 20 20 20 20 20 20 20 20 20 | . | 00001950 69 6e 74 20 20 77 69 6e 64 6f 77 20 68 61 6e 64 |int window hand| 00001960 6c 65 20 20 20 20 20 20 20 20 20 20 20 20 0a 20 |le . | 00001970 20 20 20 20 20 20 20 20 69 6e 74 20 20 69 63 6f | int ico| 00001980 6e 20 68 61 6e 64 6c 65 20 20 0a 20 20 20 20 20 |n handle . | 00001990 20 20 20 20 62 6f 6f 6c 20 73 74 61 74 65 20 28 | bool state (| 000019a0 30 20 74 6f 20 63 6c 65 61 72 20 68 6f 72 69 7a |0 to clear horiz| 000019b0 6f 6e 74 61 6c 6c 79 0a 20 20 20 20 20 20 20 20 |ontally. | 000019c0 20 20 20 20 20 20 63 65 6e 74 72 65 64 20 62 69 | centred bi| 000019d0 74 2c 20 6e 6f 6e 2d 30 20 74 6f 20 73 65 74 20 |t, non-0 to set | 000019e0 69 74 29 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |it)..-----------| 000019f0 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |----------------| * 00001a10 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 50 |-------------..P| 00001a20 52 4f 43 73 68 65 6c 6c 5f 49 63 6f 6e 53 65 74 |ROCshell_IconSet| 00001a30 56 43 65 6e 74 72 65 64 28 29 0a 50 61 72 61 6d |VCentred().Param| 00001a40 73 20 3d 3e 20 20 20 20 20 20 20 20 20 20 20 20 |s => | 00001a50 0a 20 20 20 20 20 20 20 20 20 69 6e 74 20 20 77 |. int w| 00001a60 69 6e 64 6f 77 20 68 61 6e 64 6c 65 20 20 20 20 |indow handle | 00001a70 20 20 20 20 20 20 20 20 0a 20 20 20 20 20 20 20 | . | 00001a80 20 20 69 6e 74 20 20 69 63 6f 6e 20 68 61 6e 64 | int icon hand| 00001a90 6c 65 20 20 0a 20 20 20 20 20 20 20 20 20 62 6f |le . bo| 00001aa0 6f 6c 20 73 74 61 74 65 20 28 30 20 74 6f 20 63 |ol state (0 to c| 00001ab0 6c 65 61 72 20 76 65 72 74 69 63 61 6c 6c 79 0a |lear vertically.| 00001ac0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 63 65 | ce| 00001ad0 6e 74 72 65 64 20 62 69 74 2c 20 6e 6f 6e 2d 30 |ntred bit, non-0| 00001ae0 20 74 6f 20 73 65 74 20 69 74 29 0a 0a 2d 2d 2d | to set it)..---| 00001af0 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |----------------| * 00001b20 2d 2d 2d 2d 2d 0a 0a 50 52 4f 43 73 68 65 6c 6c |-----..PROCshell| 00001b30 5f 49 63 6f 6e 53 65 74 52 69 67 68 74 4a 75 73 |_IconSetRightJus| 00001b40 74 28 29 0a 50 61 72 61 6d 73 20 3d 3e 20 20 20 |t().Params => | 00001b50 20 20 20 20 20 20 20 20 20 0a 20 20 20 20 20 20 | . | 00001b60 20 20 20 69 6e 74 20 20 77 69 6e 64 6f 77 20 68 | int window h| 00001b70 61 6e 64 6c 65 20 20 20 20 20 20 20 20 20 20 20 |andle | 00001b80 20 0a 20 20 20 20 20 20 20 20 20 69 6e 74 20 20 | . int | 00001b90 69 63 6f 6e 20 68 61 6e 64 6c 65 20 20 0a 20 20 |icon handle . | 00001ba0 20 20 20 20 20 20 20 62 6f 6f 6c 20 73 74 61 74 | bool stat| 00001bb0 65 20 28 30 20 74 6f 20 63 6c 65 61 72 20 72 69 |e (0 to clear ri| 00001bc0 67 68 74 20 6a 75 73 74 69 66 69 65 64 0a 20 20 |ght justified. | 00001bd0 20 20 20 20 20 20 20 20 20 20 20 20 62 69 74 2c | bit,| 00001be0 20 6e 6f 6e 2d 30 20 74 6f 20 73 65 74 20 69 74 | non-0 to set it| 00001bf0 29 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |)..-------------| 00001c00 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |----------------| * 00001c20 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 50 52 4f |-----------..PRO| 00001c30 43 73 68 65 6c 6c 5f 49 63 6f 6e 53 65 74 4c 65 |Cshell_IconSetLe| 00001c40 66 74 4a 75 73 74 28 29 0a 50 61 72 61 6d 73 20 |ftJust().Params | 00001c50 3d 3e 20 20 20 20 20 20 20 20 20 20 20 20 0a 20 |=> . | 00001c60 20 20 20 20 20 20 20 20 69 6e 74 20 20 77 69 6e | int win| 00001c70 64 6f 77 20 68 61 6e 64 6c 65 20 20 20 20 20 20 |dow handle | 00001c80 20 20 20 20 20 20 0a 20 20 20 20 20 20 20 20 20 | . | 00001c90 69 6e 74 20 20 69 63 6f 6e 20 68 61 6e 64 6c 65 |int icon handle| 00001ca0 20 20 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d | ..------------| 00001cb0 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |----------------| * 00001cd0 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 50 52 |------------..PR| 00001ce0 4f 43 73 68 65 6c 6c 5f 49 63 6f 6e 53 65 74 46 |OCshell_IconSetF| 00001cf0 69 6c 6c 65 64 28 29 0a 50 61 72 61 6d 73 20 3d |illed().Params =| 00001d00 3e 20 20 20 20 20 20 20 20 20 20 20 20 0a 20 20 |> . | 00001d10 20 20 20 20 20 20 20 69 6e 74 20 20 77 69 6e 64 | int wind| 00001d20 6f 77 20 68 61 6e 64 6c 65 20 20 20 20 20 20 20 |ow handle | 00001d30 20 20 20 20 20 0a 20 20 20 20 20 20 20 20 20 69 | . i| 00001d40 6e 74 20 20 69 63 6f 6e 20 68 61 6e 64 6c 65 20 |nt icon handle | 00001d50 20 0a 20 20 20 20 20 20 20 20 20 62 6f 6f 6c 20 | . bool | 00001d60 73 74 61 74 65 20 28 30 20 74 6f 20 63 6c 65 61 |state (0 to clea| 00001d70 72 20 66 69 6c 6c 65 64 0a 20 20 20 20 20 20 20 |r filled. | 00001d80 20 20 20 20 20 20 20 62 69 74 2c 20 6e 6f 6e 2d | bit, non-| 00001d90 30 20 74 6f 20 73 65 74 20 69 74 29 0a 0a 2d 2d |0 to set it)..--| 00001da0 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |----------------| * 00001dd0 2d 2d 2d 2d 2d 2d 0a 0a 50 52 4f 43 73 68 65 6c |------..PROCshel| 00001de0 6c 5f 43 61 72 65 74 53 65 74 50 6f 73 69 74 69 |l_CaretSetPositi| 00001df0 6f 6e 28 29 0a 50 61 72 61 6d 73 20 3d 3e 20 20 |on().Params => | 00001e00 20 20 20 20 20 20 20 20 20 20 20 0a 20 20 20 20 | . | 00001e10 20 20 20 20 20 69 6e 74 20 77 69 6e 64 6f 77 20 | int window | 00001e20 68 61 6e 64 6c 65 20 20 20 20 20 20 20 20 20 20 |handle | 00001e30 20 20 20 0a 20 20 20 20 20 20 20 20 20 69 6e 74 | . int| 00001e40 20 69 63 6f 6e 20 68 61 6e 64 6c 65 0a 20 20 20 | icon handle. | 00001e50 20 20 20 20 20 20 69 6e 74 20 78 20 6f 66 66 73 | int x offs| 00001e60 65 74 20 69 6e 20 69 63 6f 6e 20 28 75 73 75 61 |et in icon (usua| 00001e70 6c 6c 79 20 2d 31 29 0a 20 20 20 20 20 20 20 20 |lly -1). | 00001e80 20 69 6e 74 20 79 20 6f 66 66 73 65 74 20 69 6e | int y offset in| 00001e90 20 69 63 6f 6e 20 28 75 73 75 61 6c 6c 79 20 2d | icon (usually -| 00001ea0 31 29 0a 20 20 20 20 20 20 20 20 20 69 6e 74 20 |1). int | 00001eb0 68 65 69 67 68 74 20 28 75 73 75 61 6c 6c 79 20 |height (usually | 00001ec0 2d 31 29 0a 20 20 20 20 20 20 20 20 20 69 6e 74 |-1). int| 00001ed0 20 69 6e 64 65 78 0a 0a 41 6c 6c 6f 77 73 20 74 | index..Allows t| 00001ee0 68 65 20 63 61 72 65 74 20 74 6f 20 62 65 20 70 |he caret to be p| 00001ef0 6f 73 69 74 69 6f 6e 65 64 20 77 69 74 68 69 6e |ositioned within| 00001f00 0a 61 6e 20 69 63 6f 6e 2e 20 74 68 65 20 69 6e |.an icon. the in| 00001f10 64 65 78 20 70 61 72 61 6d 65 74 65 72 20 69 73 |dex parameter is| 00001f20 20 74 68 65 0a 6e 75 6d 62 65 72 20 6f 66 20 63 | the.number of c| 00001f30 68 61 72 61 63 74 65 72 73 20 62 65 66 6f 72 65 |haracters before| 00001f40 20 74 68 65 20 63 61 72 65 74 2e 0a 0a 53 65 65 | the caret...See| 00001f50 20 61 6c 73 6f 20 50 52 4f 43 73 68 65 6c 6c 5f | also PROCshell_| 00001f60 43 61 72 65 74 53 65 74 52 69 67 68 74 2e 0a 0a |CaretSetRight...| 00001f70 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |----------------| * 00001fa0 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 50 52 4f 43 73 68 |--------..PROCsh| 00001fb0 65 6c 6c 5f 43 61 72 65 74 53 65 74 52 69 67 68 |ell_CaretSetRigh| 00001fc0 74 28 29 0a 50 61 72 61 6d 73 20 3d 3e 20 20 20 |t().Params => | 00001fd0 20 20 20 20 20 20 20 20 20 20 20 0a 20 20 20 20 | . | 00001fe0 20 20 20 20 20 69 6e 74 20 77 69 6e 64 6f 77 20 | int window | 00001ff0 68 61 6e 64 6c 65 20 20 20 20 20 20 20 20 20 20 |handle | 00002000 20 20 20 20 0a 20 20 20 20 20 20 20 20 20 69 6e | . in| 00002010 74 20 69 63 6f 6e 20 68 61 6e 64 6c 65 0a 0a 50 |t icon handle..P| 00002020 6f 73 69 74 69 6f 6e 73 20 74 68 65 20 63 61 72 |ositions the car| 00002030 65 74 20 61 74 20 74 68 65 20 72 69 67 68 74 20 |et at the right | 00002040 68 61 6e 64 0a 65 6e 64 20 6f 66 20 61 6e 79 20 |hand.end of any | 00002050 74 65 78 74 20 69 6e 20 74 68 65 20 73 70 65 63 |text in the spec| 00002060 69 66 69 65 64 20 69 63 6f 6e 2e 0a 0a 53 65 65 |ified icon...See| 00002070 20 61 6c 73 6f 20 50 52 4f 43 73 68 65 6c 6c 5f | also PROCshell_| 00002080 43 61 72 65 74 53 65 74 50 6f 73 69 74 69 6f 6e |CaretSetPosition| 00002090 2e 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |...-------------| 000020a0 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |----------------| * 000020c0 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 46 4e 73 |-----------..FNs| 000020d0 68 65 6c 6c 5f 49 63 6f 6e 62 61 72 28 29 0a 50 |hell_Iconbar().P| 000020e0 61 72 61 6d 73 20 3d 3e 0a 20 20 20 20 20 20 20 |arams =>. | 000020f0 20 20 69 6e 74 20 20 2d 31 20 66 6f 72 20 72 69 | int -1 for ri| 00002100 67 68 74 20 73 69 64 65 20 6f 66 20 62 61 72 2c |ght side of bar,| 00002110 20 2d 32 20 66 6f 72 20 6c 65 66 74 20 73 69 64 | -2 for left sid| 00002120 65 0a 20 20 20 20 20 20 20 20 20 73 74 72 20 20 |e. str | 00002130 73 70 72 69 74 65 20 6e 61 6d 65 0a 20 20 20 20 |sprite name. | 00002140 20 20 20 20 20 73 74 72 20 20 74 65 78 74 20 75 | str text u| 00002150 6e 64 65 72 20 69 63 6f 6e 0a 20 20 20 20 20 20 |nder icon. | 00002160 20 20 20 69 6e 74 20 20 77 69 64 74 68 20 6f 66 | int width of| 00002170 20 69 63 6f 6e 2f 74 65 78 74 20 28 77 68 69 63 | icon/text (whic| 00002180 68 65 76 65 72 20 69 73 20 6c 61 72 67 65 72 29 |hever is larger)| 00002190 0a 20 20 20 20 20 20 20 20 20 73 74 72 20 20 6d |. str m| 000021a0 65 6e 75 20 6e 61 6d 65 0a 20 20 20 20 20 20 20 |enu name. | 000021b0 20 20 62 6f 6f 6c 20 73 68 69 66 74 20 66 6c 61 | bool shift fla| 000021c0 67 20 28 6e 6f 74 20 69 6d 70 6c 65 6d 65 6e 74 |g (not implement| 000021d0 65 64 29 0a 20 20 20 20 20 20 20 20 20 62 6f 6f |ed). boo| 000021e0 6c 20 63 74 72 6c 20 20 66 6c 61 67 20 28 6e 6f |l ctrl flag (no| 000021f0 74 20 69 6d 70 6c 65 6d 65 6e 74 65 64 29 0a 20 |t implemented). | 00002200 20 20 20 20 20 20 20 20 62 6f 6f 6c 20 61 6c 74 | bool alt| 00002210 20 20 20 66 6c 61 67 20 28 6e 6f 74 20 69 6d 70 | flag (not imp| 00002220 6c 65 6d 65 6e 74 65 64 29 0a 20 20 20 20 20 20 |lemented). | 00002230 20 20 20 73 74 72 20 20 66 75 6e 63 74 69 6f 6e | str function| 00002240 20 6e 61 6d 65 0a 0a 54 68 65 20 73 68 69 66 74 | name..The shift| 00002250 2c 20 63 74 72 6c 20 61 6e 64 20 61 6c 74 20 66 |, ctrl and alt f| 00002260 6c 61 67 73 20 61 72 65 20 66 6f 72 20 66 75 74 |lags are for fut| 00002270 75 72 65 0a 65 6e 68 61 6e 63 65 6d 65 6e 74 73 |ure.enhancements| 00002280 20 74 6f 20 74 68 65 20 6c 69 62 72 61 72 79 20 | to the library | 00002290 61 6e 64 20 73 68 6f 75 6c 64 20 62 65 20 73 65 |and should be se| 000022a0 74 0a 74 6f 20 30 20 6f 6e 20 74 68 69 73 20 72 |t.to 0 on this r| 000022b0 65 6c 65 61 73 65 2e 0a 0a 46 4e 73 68 65 6c 6c |elease...FNshell| 000022c0 5f 49 63 6f 6e 47 65 74 56 61 6c 69 64 61 74 69 |_IconGetValidati| 000022d0 6f 6e 28 29 0a 50 61 72 61 6d 73 20 3d 3e 0a 20 |on().Params =>. | 000022e0 20 20 20 20 20 20 20 20 69 6e 74 20 77 69 6e 64 | int wind| 000022f0 6f 77 20 68 61 6e 64 6c 65 20 20 20 20 20 0a 20 |ow handle . | 00002300 20 20 20 20 20 20 20 20 69 6e 74 20 69 63 6f 6e | int icon| 00002310 20 68 61 6e 64 6c 65 0a 20 20 20 20 20 20 20 20 | handle. | 00002320 20 0a 20 20 20 20 20 20 20 3c 3d 0a 20 20 20 20 | . <=. | 00002330 20 20 20 20 20 73 74 72 20 76 61 6c 69 64 61 74 | str validat| 00002340 69 6f 6e 20 73 74 72 69 6e 67 0a 0a 53 65 65 20 |ion string..See | 00002350 61 6c 73 6f 20 50 52 4f 43 73 68 65 6c 6c 5f 49 |also PROCshell_I| 00002360 63 6f 6e 50 75 74 56 61 6c 69 64 61 74 69 6f 6e |conPutValidation| 00002370 2e 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |...-------------| 00002380 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |----------------| * 000023a0 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 46 4e 73 |-----------..FNs| 000023b0 68 65 6c 6c 5f 49 63 6f 6e 4e 65 77 53 70 72 69 |hell_IconNewSpri| 000023c0 74 65 28 29 0a 50 61 72 61 6d 73 20 3d 3e 0a 20 |te().Params =>. | 000023d0 20 20 20 20 20 20 20 20 69 6e 74 20 77 69 6e 64 | int wind| 000023e0 6f 77 20 68 61 6e 64 6c 65 20 20 20 0a 20 20 20 |ow handle . | 000023f0 20 20 20 20 20 20 69 6e 74 20 69 63 6f 6e 20 68 | int icon h| 00002400 61 6e 64 6c 65 0a 20 20 20 20 20 20 20 20 20 73 |andle. s| 00002410 74 72 20 6e 65 77 20 73 70 72 69 74 65 20 6e 61 |tr new sprite na| 00002420 6d 65 0a 20 20 20 20 20 20 20 20 20 69 6e 74 20 |me. int | 00002430 72 65 64 72 61 77 20 66 6c 61 67 0a 0a 20 20 20 |redraw flag.. | 00002440 20 20 20 20 3c 3d 0a 20 20 20 20 20 20 20 20 20 | <=. | 00002450 69 6e 74 20 6e 65 77 20 69 63 6f 6e 20 68 61 6e |int new icon han| 00002460 64 6c 65 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |dle..-----------| 00002470 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |----------------| * 00002490 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 46 |-------------..F| 000024a0 4e 73 68 65 6c 6c 5f 49 73 49 63 6f 6e 53 65 6c |Nshell_IsIconSel| 000024b0 65 63 74 65 64 28 29 0a 50 61 72 61 6d 73 20 3d |ected().Params =| 000024c0 3e 0a 20 20 20 20 20 20 20 20 20 69 6e 74 20 20 |>. int | 000024d0 77 69 6e 64 6f 77 20 68 61 6e 64 6c 65 20 20 20 |window handle | 000024e0 20 20 20 20 0a 20 20 20 20 20 20 20 20 20 69 6e | . in| 000024f0 74 20 20 69 63 6f 6e 20 68 61 6e 64 6c 65 0a 0a |t icon handle..| 00002500 20 20 20 20 20 20 20 3c 3d 0a 20 20 20 20 20 20 | <=. | 00002510 20 20 20 62 6f 6f 6c 20 54 52 55 45 20 69 66 20 | bool TRUE if | 00002520 73 65 6c 65 63 74 65 64 2c 20 46 41 4c 53 45 20 |selected, FALSE | 00002530 6f 74 68 65 72 77 69 73 65 0a 0a 2d 2d 2d 2d 2d |otherwise..-----| 00002540 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |----------------| * 00002570 2d 2d 2d 0a 0a 46 4e 73 68 65 6c 6c 5f 49 63 6f |---..FNshell_Ico| 00002580 6e 43 72 65 61 74 65 28 29 0a 50 61 72 61 6d 73 |nCreate().Params| 00002590 20 3d 3e 20 0a 20 20 20 20 20 20 20 20 20 69 6e | => . in| 000025a0 74 20 77 69 6e 64 6f 77 20 68 61 6e 64 6c 65 20 |t window handle | 000025b0 0a 20 20 20 20 20 20 20 20 20 69 6e 74 20 6d 69 |. int mi| 000025c0 6e 20 78 20 63 6f 6f 72 64 20 6f 66 20 69 63 6f |n x coord of ico| 000025d0 6e 0a 20 20 20 20 20 20 20 20 20 69 6e 74 20 6d |n. int m| 000025e0 69 6e 20 79 20 63 6f 6f 72 64 20 6f 66 20 69 63 |in y coord of ic| 000025f0 6f 6e 0a 20 20 20 20 20 20 20 20 20 69 6e 74 20 |on. int | 00002600 77 69 64 74 68 20 6f 66 20 69 63 6f 6e 0a 20 20 |width of icon. | 00002610 20 20 20 20 20 20 20 69 6e 74 20 68 65 69 67 68 | int heigh| 00002620 74 20 6f 66 20 69 63 6f 6e 0a 20 20 20 20 20 20 |t of icon. | 00002630 20 20 20 69 6e 74 20 66 6f 72 65 67 72 6f 75 6e | int foregroun| 00002640 64 20 63 6f 6c 6f 75 72 0a 20 20 20 20 20 20 20 |d colour. | 00002650 20 20 69 6e 74 20 62 61 63 6b 67 72 6f 75 6e 64 | int background| 00002660 20 63 6f 6c 6f 75 72 0a 20 20 20 20 20 20 20 20 | colour. | 00002670 20 69 6e 74 20 69 63 6f 6e 20 66 6c 61 67 73 0a | int icon flags.| 00002680 20 20 20 20 20 20 20 20 20 73 74 72 20 74 65 78 | str tex| 00002690 74 20 74 6f 20 69 6e 73 65 72 74 20 69 6e 74 6f |t to insert into| 000026a0 20 69 63 6f 6e 0a 20 20 20 20 20 20 20 20 20 69 | icon. i| 000026b0 6e 74 20 61 64 64 72 65 73 73 20 6f 66 20 69 6e |nt address of in| 000026c0 64 69 72 65 63 74 65 64 20 64 61 74 61 0a 20 20 |directed data. | 000026d0 20 20 20 20 20 20 20 20 20 20 20 28 69 67 6e 6f | (igno| 000026e0 72 65 64 20 77 68 65 6e 20 6e 6f 74 20 69 6e 64 |red when not ind| 000026f0 69 72 65 63 74 65 64 29 0a 20 20 20 20 20 20 20 |irected). | 00002700 20 20 69 6e 74 20 6c 65 6e 67 74 68 20 6f 66 20 | int length of | 00002710 69 6e 64 69 72 65 63 74 65 64 20 62 75 66 66 65 |indirected buffe| 00002720 72 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 28 |r. (| 00002730 69 67 6e 6f 72 65 64 20 77 68 65 6e 20 6e 6f 74 |ignored when not| 00002740 20 69 6e 64 69 72 65 63 74 65 64 29 0a 20 20 20 | indirected). | 00002750 20 20 20 20 20 20 73 74 72 20 76 61 6c 69 64 61 | str valida| 00002760 74 69 6f 6e 20 73 74 72 69 6e 67 0a 0a 20 20 20 |tion string.. | 00002770 20 20 20 20 3c 3d 0a 20 20 20 20 20 20 20 20 20 | <=. | 00002780 69 6e 74 20 68 61 6e 64 6c 65 20 6f 66 20 6e 65 |int handle of ne| 00002790 77 20 69 63 6f 6e 0a 20 20 20 20 20 20 20 20 20 |w icon. | 000027a0 0a 54 68 69 73 20 72 6f 75 74 69 6e 65 20 69 73 |.This routine is| 000027b0 20 6f 6e 6c 79 20 75 73 65 64 20 77 68 65 6e 20 | only used when | 000027c0 74 68 65 20 61 70 70 6c 69 63 61 74 69 6f 6e 0a |the application.| 000027d0 6e 65 65 64 73 20 74 6f 20 63 72 65 61 74 65 20 |needs to create | 000027e0 69 63 6f 6e 73 20 69 74 73 65 6c 66 20 72 61 74 |icons itself rat| 000027f0 68 65 72 20 74 68 61 6e 0a 6c 6f 61 64 69 6e 67 |her than.loading| 00002800 20 74 68 65 6d 20 61 73 20 70 61 72 74 20 6f 66 | them as part of| 00002810 20 61 20 77 69 6e 64 6f 77 20 64 65 66 69 6e 69 | a window defini| 00002820 74 69 6f 6e 20 69 6e 0a 61 20 74 65 6d 70 6c 61 |tion in.a templa| 00002830 74 65 2e 0a 0a 49 74 20 64 6f 65 73 20 6e 6f 74 |te...It does not| 00002840 20 72 65 64 72 61 77 20 74 68 65 20 61 72 65 61 | redraw the area| 00002850 20 6f 66 20 74 68 65 20 77 69 6e 64 6f 77 20 6f | of the window o| 00002860 63 63 75 70 69 65 64 0a 62 79 20 74 68 65 20 6e |ccupied.by the n| 00002870 65 77 20 69 63 6f 6e 2e 20 49 66 20 74 68 65 20 |ew icon. If the | 00002880 77 69 6e 64 6f 77 20 69 73 20 6f 70 65 6e 20 69 |window is open i| 00002890 74 20 6d 61 79 20 62 65 0a 6e 65 63 65 73 73 61 |t may be.necessa| 000028a0 72 79 20 74 6f 20 63 61 6c 6c 20 50 52 4f 43 73 |ry to call PROCs| 000028b0 68 65 6c 6c 5f 49 63 6f 6e 52 65 64 72 61 77 20 |hell_IconRedraw | 000028c0 74 6f 20 75 70 64 61 74 65 0a 74 68 65 20 77 69 |to update.the wi| 000028d0 6e 64 6f 77 20 61 72 65 61 20 63 6f 76 65 72 65 |ndow area covere| 000028e0 64 20 62 79 20 74 68 65 20 69 63 6f 6e 2e 0a 0a |d by the icon...| 000028f0 55 73 65 72 20 46 4e 20 28 50 52 4f 43 73 68 65 |User FN (PROCshe| 00002900 6c 6c 5f 49 63 6f 6e 42 61 72 29 0a 50 61 72 61 |ll_IconBar).Para| 00002910 6d 73 20 3d 3e 20 0a 20 20 20 20 20 20 20 20 20 |ms => . | 00002920 73 74 72 20 74 65 78 74 20 6f 66 20 6d 65 6e 75 |str text of menu| 00002930 20 73 65 6c 65 63 74 69 6f 6e 0a 20 0a 54 68 69 | selection. .Thi| 00002940 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 63 61 |s function is ca| 00002950 6c 6c 65 64 20 77 68 65 6e 20 74 68 65 20 75 73 |lled when the us| 00002960 65 72 20 63 68 6f 6f 73 65 73 0a 61 6e 20 69 74 |er chooses.an it| 00002970 65 6d 20 6f 6e 20 74 68 65 20 6d 65 6e 75 2e 0a |em on the menu..| 00002980 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |.---------------| 00002990 2d 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 0a 0a 50 52 4f 43 73 |---------..PROCs| 000029c0 68 65 6c 6c 5f 49 63 6f 6e 53 65 74 28 29 0a 50 |hell_IconSet().P| 000029d0 61 72 61 6d 73 20 3d 3e 20 20 20 20 20 20 20 20 |arams => | 000029e0 20 0a 20 20 20 20 20 20 20 20 20 69 6e 74 20 20 | . int | 000029f0 77 69 6e 64 6f 77 20 68 61 6e 64 6c 65 0a 20 20 |window handle. | 00002a00 20 20 20 20 20 20 20 69 6e 74 20 20 69 63 6f 6e | int icon| 00002a10 20 68 61 6e 64 6c 65 0a 20 20 20 20 20 20 20 20 | handle. | 00002a20 20 62 6f 6f 6c 20 73 74 61 74 65 20 28 30 20 66 | bool state (0 f| 00002a30 6f 72 20 64 65 73 65 6c 65 63 74 65 64 2c 20 6e |or deselected, n| 00002a40 6f 6e 20 30 0a 20 20 20 20 20 20 20 20 20 20 20 |on 0. | 00002a50 20 20 20 66 6f 72 20 73 65 6c 65 63 74 65 64 29 | for selected)| 00002a60 0a 0a 54 68 69 73 20 63 61 6c 6c 20 69 73 20 75 |..This call is u| 00002a70 73 65 64 20 74 6f 20 73 65 6c 65 63 74 20 6f 72 |sed to select or| 00002a80 20 64 65 73 65 6c 65 63 74 20 69 63 6f 6e 73 0a | deselect icons.| 00002a90 64 65 70 65 6e 64 69 6e 67 20 6f 6e 20 74 68 65 |depending on the| 00002aa0 20 76 61 6c 75 65 20 6f 66 20 74 68 65 20 73 74 | value of the st| 00002ab0 61 74 65 20 66 6c 61 67 0a 0a 2d 2d 2d 2d 2d 2d |ate flag..------| 00002ac0 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |----------------| * 00002af0 2d 2d 0a 0a 50 52 4f 43 73 68 65 6c 6c 5f 49 63 |--..PROCshell_Ic| 00002b00 6f 6e 53 65 74 53 65 6c 65 63 74 65 64 28 29 0a |onSetSelected().| 00002b10 50 61 72 61 6d 73 20 3d 3e 20 20 20 20 20 20 20 |Params => | 00002b20 20 20 0a 20 20 20 20 20 20 20 20 20 69 6e 74 20 | . int | 00002b30 20 77 69 6e 64 6f 77 20 68 61 6e 64 6c 65 0a 20 | window handle. | 00002b40 20 20 20 20 20 20 20 20 69 6e 74 20 20 69 63 6f | int ico| 00002b50 6e 20 68 61 6e 64 6c 65 0a 20 20 20 20 20 20 20 |n handle. | 00002b60 20 20 62 6f 6f 6c 20 73 74 61 74 65 20 28 30 20 | bool state (0 | 00002b70 66 6f 72 20 64 65 73 65 6c 65 63 74 65 64 2c 20 |for deselected, | 00002b80 6e 6f 6e 20 30 0a 20 20 20 20 20 20 20 20 20 20 |non 0. | 00002b90 20 20 20 20 66 6f 72 20 73 65 6c 65 63 74 65 64 | for selected| 00002ba0 29 0a 0a 54 68 69 73 20 63 61 6c 6c 20 69 73 20 |)..This call is | 00002bb0 75 73 65 64 20 74 6f 20 73 65 6c 65 63 74 20 6f |used to select o| 00002bc0 72 20 64 65 73 65 6c 65 63 74 20 69 63 6f 6e 73 |r deselect icons| 00002bd0 0a 64 65 70 65 6e 64 69 6e 67 20 6f 6e 20 74 68 |.depending on th| 00002be0 65 20 76 61 6c 75 65 20 6f 66 20 74 68 65 20 73 |e value of the s| 00002bf0 74 61 74 65 20 66 6c 61 67 0a 0a 2d 2d 2d 2d 2d |tate flag..-----| 00002c00 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |----------------| * 00002c30 2d 2d 2d 0a 0a 50 52 4f 43 73 68 65 6c 6c 5f 49 |---..PROCshell_I| 00002c40 63 6f 6e 53 65 74 55 6e 73 65 6c 65 63 74 61 62 |conSetUnselectab| 00002c50 6c 65 28 29 0a 50 61 72 61 6d 73 20 3d 3e 20 20 |le().Params => | 00002c60 20 20 20 20 20 20 20 0a 20 20 20 20 20 20 20 20 | . | 00002c70 20 69 6e 74 20 20 77 69 6e 64 6f 77 20 68 61 6e | int window han| 00002c80 64 6c 65 0a 20 20 20 20 20 20 20 20 20 69 6e 74 |dle. int| 00002c90 20 20 69 63 6f 6e 20 68 61 6e 64 6c 65 0a 20 20 | icon handle. | 00002ca0 20 20 20 20 20 20 20 62 6f 6f 6c 20 73 74 61 74 | bool stat| 00002cb0 65 20 28 30 20 74 6f 20 6d 61 6b 65 20 69 63 6f |e (0 to make ico| 00002cc0 6e 20 73 65 6c 65 63 74 61 62 6c 65 2c 0a 20 20 |n selectable,. | 00002cd0 20 20 20 20 20 20 20 20 20 20 20 20 6e 6f 6e 20 | non | 00002ce0 30 20 74 6f 20 6d 61 6b 65 20 69 74 20 75 6e 73 |0 to make it uns| 00002cf0 65 6c 65 63 74 61 62 6c 65 29 0a 0a 54 68 69 73 |electable)..This| 00002d00 20 63 61 6c 6c 20 69 73 20 75 73 65 64 20 74 6f | call is used to| 00002d10 20 6d 61 6b 65 20 69 63 6f 6e 73 20 75 6e 73 65 | make icons unse| 00002d20 6c 65 63 74 61 62 6c 65 0a 28 69 2e 65 2e 20 67 |lectable.(i.e. g| 00002d30 72 65 79 65 64 20 6f 75 74 29 20 64 65 70 65 6e |reyed out) depen| 00002d40 64 69 6e 67 20 6f 6e 20 74 68 65 20 76 61 6c 75 |ding on the valu| 00002d50 65 20 6f 66 0a 74 68 65 20 73 74 61 74 65 20 66 |e of.the state f| 00002d60 6c 61 67 2e 20 49 66 20 74 68 65 20 69 63 6f 6e |lag. If the icon| 00002d70 20 63 6f 6e 74 61 69 6e 73 20 74 68 65 20 63 61 | contains the ca| 00002d80 72 65 74 0a 77 68 65 6e 20 69 74 20 69 73 20 6d |ret.when it is m| 00002d90 61 64 65 20 75 6e 73 65 6c 65 63 74 61 62 6c 65 |ade unselectable| 00002da0 2c 20 74 68 65 20 63 61 72 65 74 20 69 73 20 6c |, the caret is l| 00002db0 6f 73 74 2e 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |ost...----------| 00002dc0 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |----------------| * 00002de0 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a |--------------..| 00002df0 46 4e 73 68 65 6c 6c 5f 49 63 6f 6e 52 65 73 69 |FNshell_IconResi| 00002e00 7a 65 28 29 0a 50 61 72 61 6d 73 20 3d 3e 0a 20 |ze().Params =>. | 00002e10 20 20 20 20 20 20 20 20 69 6e 74 20 77 69 6e 64 | int wind| 00002e20 6f 77 20 68 61 6e 64 6c 65 20 20 0a 20 20 20 20 |ow handle . | 00002e30 20 20 20 20 20 69 6e 74 20 69 63 6f 6e 20 68 61 | int icon ha| 00002e40 6e 64 6c 65 0a 20 20 20 20 20 20 20 20 20 69 6e |ndle. in| 00002e50 74 20 6d 69 6e 20 78 20 63 6f 6f 72 64 0a 20 20 |t min x coord. | 00002e60 20 20 20 20 20 20 20 69 6e 74 20 6d 69 6e 20 79 | int min y| 00002e70 20 63 6f 6f 72 64 0a 20 20 20 20 20 20 20 20 20 | coord. | 00002e80 69 6e 74 20 6d 61 78 20 78 20 63 6f 6f 72 64 0a |int max x coord.| 00002e90 20 20 20 20 20 20 20 20 20 69 6e 74 20 6d 61 78 | int max| 00002ea0 20 79 20 63 6f 6f 72 64 0a 0a 20 20 20 20 20 20 | y coord.. | 00002eb0 20 3c 3d 0a 20 20 20 20 20 20 20 20 20 69 6e 74 | <=. int| 00002ec0 20 69 63 6f 6e 20 68 61 6e 64 6c 65 0a 0a 41 6c | icon handle..Al| 00002ed0 6c 6f 77 73 20 74 68 65 20 72 65 64 65 66 69 6e |lows the redefin| 00002ee0 69 74 69 6f 6e 20 6f 66 20 61 6e 20 69 63 6f 6e |ition of an icon| 00002ef0 27 73 20 62 6f 75 6e 64 69 6e 67 0a 62 6f 78 2e |'s bounding.box.| 00002f00 20 41 73 20 74 68 65 20 69 63 6f 6e 20 68 61 73 | As the icon has| 00002f10 20 74 6f 20 62 65 20 64 65 6c 65 74 65 64 20 61 | to be deleted a| 00002f20 6e 64 20 74 68 65 6e 0a 72 65 63 72 65 61 74 65 |nd then.recreate| 00002f30 64 20 69 74 20 72 65 74 75 72 6e 73 20 74 68 65 |d it returns the| 00002f40 20 6e 65 77 20 69 63 6f 6e 20 68 61 6e 64 6c 65 | new icon handle| 00002f50 20 28 77 68 69 63 68 0a 73 68 6f 75 6c 64 20 62 | (which.should b| 00002f60 65 20 74 68 65 20 73 61 6d 65 20 61 73 20 74 68 |e the same as th| 00002f70 65 20 6f 6c 64 20 68 61 6e 64 6c 65 29 2e 20 54 |e old handle). T| 00002f80 68 65 20 69 63 6f 6e 0a 69 73 20 72 65 64 72 61 |he icon.is redra| 00002f90 77 6e 20 61 66 74 65 72 20 72 65 73 69 7a 69 6e |wn after resizin| 00002fa0 67 2c 20 74 61 6b 69 6e 67 20 61 63 63 6f 75 6e |g, taking accoun| 00002fb0 74 20 6f 66 20 61 6e 79 0a 33 44 20 62 6f 72 64 |t of any.3D bord| 00002fc0 65 72 73 2e 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |ers...----------| 00002fd0 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |----------------| * 00002ff0 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |--------------| 00002ffe
.