Home » Archimedes archive » Archimedes World » AW-1995-01-Disc2.adf » Disk2Jan95 » !AWJan95/Goodies/Event/Docs/Messages

!AWJan95/Goodies/Event/Docs/Messages

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/Messages
Read OK:
File size: 0388 bytes
Load address: 0000
Exec address: 0000
File contents
PROCshell_BroadcastMessage()
Params =>
         int reason code         
         str message text

This routine is used by the EvntShell
library for communication between apps
using the library and !ShellDBug, although
it could be used for other purposes.

--------------------------------------------------------

PROCshell_MessageSendDataLoad()
Params =>
         int file type
         str full path name of file

This call is useful for forcing a file to be
loaded by another application, as if if had
been double clicked in a Filer window. In
effect this is the same as the RISC OS 3
Filer_Run command, but this call will work
on RISC OS 2 as well.

--------------------------------------------------------

PROCshell_HandleUnknownMessage()
Params =>
         int address of message block

Called every time an unknown message is received.

--------------------------------------------------------
00000000  50 52 4f 43 73 68 65 6c  6c 5f 42 72 6f 61 64 63  |PROCshell_Broadc|
00000010  61 73 74 4d 65 73 73 61  67 65 28 29 0a 50 61 72  |astMessage().Par|
00000020  61 6d 73 20 3d 3e 0a 20  20 20 20 20 20 20 20 20  |ams =>.         |
00000030  69 6e 74 20 72 65 61 73  6f 6e 20 63 6f 64 65 20  |int reason code |
00000040  20 20 20 20 20 20 20 20  0a 20 20 20 20 20 20 20  |        .       |
00000050  20 20 73 74 72 20 6d 65  73 73 61 67 65 20 74 65  |  str message te|
00000060  78 74 0a 0a 54 68 69 73  20 72 6f 75 74 69 6e 65  |xt..This routine|
00000070  20 69 73 20 75 73 65 64  20 62 79 20 74 68 65 20  | is used by the |
00000080  45 76 6e 74 53 68 65 6c  6c 0a 6c 69 62 72 61 72  |EvntShell.librar|
00000090  79 20 66 6f 72 20 63 6f  6d 6d 75 6e 69 63 61 74  |y for communicat|
000000a0  69 6f 6e 20 62 65 74 77  65 65 6e 20 61 70 70 73  |ion between apps|
000000b0  0a 75 73 69 6e 67 20 74  68 65 20 6c 69 62 72 61  |.using the libra|
000000c0  72 79 20 61 6e 64 20 21  53 68 65 6c 6c 44 42 75  |ry and !ShellDBu|
000000d0  67 2c 20 61 6c 74 68 6f  75 67 68 0a 69 74 20 63  |g, although.it c|
000000e0  6f 75 6c 64 20 62 65 20  75 73 65 64 20 66 6f 72  |ould be used for|
000000f0  20 6f 74 68 65 72 20 70  75 72 70 6f 73 65 73 2e  | other purposes.|
00000100  0a 0a 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |..--------------|
00000110  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |----------------|
*
00000130  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 0a 0a 50 52 4f 43  |----------..PROC|
00000140  73 68 65 6c 6c 5f 4d 65  73 73 61 67 65 53 65 6e  |shell_MessageSen|
00000150  64 44 61 74 61 4c 6f 61  64 28 29 0a 50 61 72 61  |dDataLoad().Para|
00000160  6d 73 20 3d 3e 0a 20 20  20 20 20 20 20 20 20 69  |ms =>.         i|
00000170  6e 74 20 66 69 6c 65 20  74 79 70 65 0a 20 20 20  |nt file type.   |
00000180  20 20 20 20 20 20 73 74  72 20 66 75 6c 6c 20 70  |      str full p|
00000190  61 74 68 20 6e 61 6d 65  20 6f 66 20 66 69 6c 65  |ath name of file|
000001a0  0a 0a 54 68 69 73 20 63  61 6c 6c 20 69 73 20 75  |..This call is u|
000001b0  73 65 66 75 6c 20 66 6f  72 20 66 6f 72 63 69 6e  |seful for forcin|
000001c0  67 20 61 20 66 69 6c 65  20 74 6f 20 62 65 0a 6c  |g a file to be.l|
000001d0  6f 61 64 65 64 20 62 79  20 61 6e 6f 74 68 65 72  |oaded by another|
000001e0  20 61 70 70 6c 69 63 61  74 69 6f 6e 2c 20 61 73  | application, as|
000001f0  20 69 66 20 69 66 20 68  61 64 0a 62 65 65 6e 20  | if if had.been |
00000200  64 6f 75 62 6c 65 20 63  6c 69 63 6b 65 64 20 69  |double clicked i|
00000210  6e 20 61 20 46 69 6c 65  72 20 77 69 6e 64 6f 77  |n a Filer window|
00000220  2e 20 49 6e 0a 65 66 66  65 63 74 20 74 68 69 73  |. In.effect this|
00000230  20 69 73 20 74 68 65 20  73 61 6d 65 20 61 73 20  | is the same as |
00000240  74 68 65 20 52 49 53 43  20 4f 53 20 33 0a 46 69  |the RISC OS 3.Fi|
00000250  6c 65 72 5f 52 75 6e 20  63 6f 6d 6d 61 6e 64 2c  |ler_Run command,|
00000260  20 62 75 74 20 74 68 69  73 20 63 61 6c 6c 20 77  | but this call w|
00000270  69 6c 6c 20 77 6f 72 6b  0a 6f 6e 20 52 49 53 43  |ill work.on RISC|
00000280  20 4f 53 20 32 20 61 73  20 77 65 6c 6c 2e 0a 0a  | OS 2 as well...|
00000290  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |----------------|
*
000002c0  2d 2d 2d 2d 2d 2d 2d 2d  0a 0a 50 52 4f 43 73 68  |--------..PROCsh|
000002d0  65 6c 6c 5f 48 61 6e 64  6c 65 55 6e 6b 6e 6f 77  |ell_HandleUnknow|
000002e0  6e 4d 65 73 73 61 67 65  28 29 0a 50 61 72 61 6d  |nMessage().Param|
000002f0  73 20 3d 3e 0a 20 20 20  20 20 20 20 20 20 69 6e  |s =>.         in|
00000300  74 20 61 64 64 72 65 73  73 20 6f 66 20 6d 65 73  |t address of mes|
00000310  73 61 67 65 20 62 6c 6f  63 6b 0a 0a 43 61 6c 6c  |sage block..Call|
00000320  65 64 20 65 76 65 72 79  20 74 69 6d 65 20 61 6e  |ed every time an|
00000330  20 75 6e 6b 6e 6f 77 6e  20 6d 65 73 73 61 67 65  | unknown message|
00000340  20 69 73 20 72 65 63 65  69 76 65 64 2e 0a 0a 2d  | is received...-|
00000350  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |----------------|
*
00000380  2d 2d 2d 2d 2d 2d 2d 0a                           |-------.|
00000388