Home » Archimedes archive » Acorn User » AU 1993-10.adf » !OmniDesk_OmniDesk » !OmniDesk/Docs/MessFormat
!OmniDesk/Docs/MessFormat
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 User » AU 1993-10.adf » !OmniDesk_OmniDesk |
| Filename: | !OmniDesk/Docs/MessFormat |
| Read OK: | ✔ |
| File size: | 14BF bytes |
| Load address: | 0000 |
| Exec address: | 0000 |
File contents
Format and usage description of all messages used by
the OmniDesk suite of utilities. These messages have
been officially allocated by Acorn.
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Message_UtilDeclare (&825C0):
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
This is the message block that an OmniDesk utility
must send to OmniDesk if OmniDesk has started it up.
The message contains 208 bytes, starting at Block+20
(ie taking into account the standard 20-byte message
header):
Offset: Length: Contents:
~~~~~~~ ~~~~~~~ ~~~~~~~~~
+20 4 Task handle
+24 20 Task name (for Utilities menu and
Preferences window) 19 chars+CHR$13
+44 11 Leafname of application within
Utilities directory (ending CHR$13)
+55 77 Help message detailing SELECT- or
ADJUST-click action of utility. This
is used both for the icon-bar icon
and for the menu entry.
+132 77 Help message detailing DRAG action
(or blank for none) used for icon-
bar icon and drag target window.
+209 End of message
NB The utilities should not provide an ADJUST action
for the icon-bar icon, since the SELECT action may
be assigned to either SELECT or ADJUST by OmniDesk.
The help message should omit the opening "Click
SELECT/ADJUST to ", since this is provided as
appropriate by OmniDesk.
The Drag message should be of the form "Drag ...
here to ...", since it is used both by the help
message for the icon-bar icon and as the text label
in the drag target window.
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Message_UtilOpen (&825C1):
~~~~~~~~~~~~~~~~~~~~~~~~~~
This is the message block received by an OmniDesk
utility if it is chosen from the Utilities menu, or
if it has been selected to receive SELECT or ADJUST
clicks on the icon-bar icon, or file-drags to the
icon-bar icon.
Offset: Length: Contents:
~~~~~~~ ~~~~~~~ ~~~~~~~~~
+20 4 4 for a mouse click
2 for a file to receive
+24 20 Taskname of RECEIVER
-------
If Block!20=2, then:
+44 4 Estimated size of data in bytes
+48 4 File type
+52 ? Path name
When a utility receives this message from OmniDesk,
it should check that the taskname in Block+24 is its
own taskname, since it may be picking up a message
broadcast for another utility.
If the message is for the utility which receives it,
the utility should take the following actions:
If Block!20=4, then behave as if SELECT had been
clicked on the icon-bar icon.
If Block!20=2, then load the file using the supplied
pathname (as if it had been dragged to the icon-bar
icon). When processing is complete, send a message
UtilAckLoad to OmniDesk so it can tidy things up as
necessary (i.e. delete <Wimp$Scrap> if appropriate).
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Message_UtilQuitting (&825C2):
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
This is used under three circumstances:
1) OmniDesk broadcasts the message when Quit has
been chosen from its icon-bar menu. Any utility
which has been started by OmniDesk must now exit
immediately.
2) OmniDesk sends the message to each appropriate
utility when 'OK' is clicked in the Preferences
window: i.e. any utility which is running and whose
'load' switch is deselected will be told to quit.
3) If a utility quits unexpectedly, or is quit from
the task manager, it sends the message to OmniDesk
so that its internal utility record can be updated.
Offset: Length: Contents:
~~~~~~~ ~~~~~~~ ~~~~~~~~~
+20 4 Task handle
For circumstances (1) and (2), the task handle will
be that of OmniDesk.
For circumstance (3), the task handle will be that
of the quitting utility.
The message is only *broadcast* under circumstance
(1), and unless the task handle received is that of
OmniDesk, a receiving task should ignore it.
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Message_UtilReside (&825C3):
~~~~~~~~~~~~~~~~~~~~~~~~~~~~
No contents
~~~~~~~~~~~
A utility receiving this message should update its
status to one of permanence.
Specifically, update the Exit variable to FALSE and
become permanent: i.e. do not quit until actually
told to do so by OmniDesk.
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Message_UtilLoadAck (&825C4):
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
No contents
~~~~~~~~~~~
A utility should send this message to OmniDesk once
it has finished processing a file which it was told
to load by a previous Message_UtilOpen with a
Block!20 code of 2.
Specifically, the process is as follows:
1. The user drags a file to the OmniDesk icon or
drag target window.
2. OmniDesk sends a Message_UtilOpen to the utility
in question.
3. The utility processes the file if appropriate or
puts up an error if it's the wrong file type etc.
4. The utility sends a Message_UtilLoadAck back to
OmniDesk.
5. OmniDesk deletes <Wimp$Scrap> if that's where the
input file came from.
N.B. If any utility which accepts dragged files is
run alone (i.e. not via OmniDesk, but installing its
own icon on the icon-bar), then it must handle all
drags, including those involving <Wimp$Scrap>,
itself. This will of course also apply to utilities
started by OmniDesk if they allow the user to drag
a new file into one of their own windows.
00000000 46 6f 72 6d 61 74 20 61 6e 64 20 75 73 61 67 65 |Format and usage| 00000010 20 64 65 73 63 72 69 70 74 69 6f 6e 20 6f 66 20 | description of | 00000020 61 6c 6c 20 6d 65 73 73 61 67 65 73 20 75 73 65 |all messages use| 00000030 64 20 62 79 0a 74 68 65 20 4f 6d 6e 69 44 65 73 |d by.the OmniDes| 00000040 6b 20 73 75 69 74 65 20 6f 66 20 75 74 69 6c 69 |k suite of utili| 00000050 74 69 65 73 2e 20 54 68 65 73 65 20 6d 65 73 73 |ties. These mess| 00000060 61 67 65 73 20 68 61 76 65 0a 62 65 65 6e 20 6f |ages have.been o| 00000070 66 66 69 63 69 61 6c 6c 79 20 61 6c 6c 6f 63 61 |fficially alloca| 00000080 74 65 64 20 62 79 20 41 63 6f 72 6e 2e 0a 7e 7e |ted by Acorn..~~| 00000090 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e |~~~~~~~~~~~~~~~~| * 000000c0 7e 7e 0a 0a 4d 65 73 73 61 67 65 5f 55 74 69 6c |~~..Message_Util| 000000d0 44 65 63 6c 61 72 65 20 28 26 38 32 35 43 30 29 |Declare (&825C0)| 000000e0 3a 0a 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e |:.~~~~~~~~~~~~~~| 000000f0 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 0a |~~~~~~~~~~~~~~~.| 00000100 54 68 69 73 20 69 73 20 74 68 65 20 6d 65 73 73 |This is the mess| 00000110 61 67 65 20 62 6c 6f 63 6b 20 74 68 61 74 20 61 |age block that a| 00000120 6e 20 4f 6d 6e 69 44 65 73 6b 20 75 74 69 6c 69 |n OmniDesk utili| 00000130 74 79 0a 6d 75 73 74 20 73 65 6e 64 20 74 6f 20 |ty.must send to | 00000140 4f 6d 6e 69 44 65 73 6b 20 69 66 20 4f 6d 6e 69 |OmniDesk if Omni| 00000150 44 65 73 6b 20 68 61 73 20 73 74 61 72 74 65 64 |Desk has started| 00000160 20 69 74 20 75 70 2e 0a 0a 54 68 65 20 6d 65 73 | it up...The mes| 00000170 73 61 67 65 20 63 6f 6e 74 61 69 6e 73 20 32 30 |sage contains 20| 00000180 38 20 62 79 74 65 73 2c 20 73 74 61 72 74 69 6e |8 bytes, startin| 00000190 67 20 61 74 20 42 6c 6f 63 6b 2b 32 30 0a 28 69 |g at Block+20.(i| 000001a0 65 20 74 61 6b 69 6e 67 20 69 6e 74 6f 20 61 63 |e taking into ac| 000001b0 63 6f 75 6e 74 20 74 68 65 20 73 74 61 6e 64 61 |count the standa| 000001c0 72 64 20 32 30 2d 62 79 74 65 20 6d 65 73 73 61 |rd 20-byte messa| 000001d0 67 65 0a 68 65 61 64 65 72 29 3a 0a 0a 4f 66 66 |ge.header):..Off| 000001e0 73 65 74 3a 20 4c 65 6e 67 74 68 3a 20 43 6f 6e |set: Length: Con| 000001f0 74 65 6e 74 73 3a 0a 7e 7e 7e 7e 7e 7e 7e 20 7e |tents:.~~~~~~~ ~| 00000200 7e 7e 7e 7e 7e 7e 20 7e 7e 7e 7e 7e 7e 7e 7e 7e |~~~~~~ ~~~~~~~~~| 00000210 0a 2b 32 30 20 20 20 20 20 34 20 20 20 20 20 20 |.+20 4 | 00000220 20 54 61 73 6b 20 68 61 6e 64 6c 65 0a 2b 32 34 | Task handle.+24| 00000230 20 20 20 20 20 32 30 20 20 20 20 20 20 54 61 73 | 20 Tas| 00000240 6b 20 6e 61 6d 65 20 28 66 6f 72 20 55 74 69 6c |k name (for Util| 00000250 69 74 69 65 73 20 6d 65 6e 75 20 61 6e 64 0a 20 |ities menu and. | 00000260 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 50 | P| 00000270 72 65 66 65 72 65 6e 63 65 73 20 77 69 6e 64 6f |references windo| 00000280 77 29 20 31 39 20 63 68 61 72 73 2b 43 48 52 24 |w) 19 chars+CHR$| 00000290 31 33 0a 2b 34 34 20 20 20 20 20 31 31 20 20 20 |13.+44 11 | 000002a0 20 20 20 4c 65 61 66 6e 61 6d 65 20 6f 66 20 61 | Leafname of a| 000002b0 70 70 6c 69 63 61 74 69 6f 6e 20 77 69 74 68 69 |pplication withi| 000002c0 6e 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 |n. | 000002d0 20 20 55 74 69 6c 69 74 69 65 73 20 64 69 72 65 | Utilities dire| 000002e0 63 74 6f 72 79 20 28 65 6e 64 69 6e 67 20 43 48 |ctory (ending CH| 000002f0 52 24 31 33 29 0a 2b 35 35 20 20 20 20 20 37 37 |R$13).+55 77| 00000300 20 20 20 20 20 20 48 65 6c 70 20 6d 65 73 73 61 | Help messa| 00000310 67 65 20 64 65 74 61 69 6c 69 6e 67 20 53 45 4c |ge detailing SEL| 00000320 45 43 54 2d 20 6f 72 0a 20 20 20 20 20 20 20 20 |ECT- or. | 00000330 20 20 20 20 20 20 20 20 41 44 4a 55 53 54 2d 63 | ADJUST-c| 00000340 6c 69 63 6b 20 61 63 74 69 6f 6e 20 6f 66 20 75 |lick action of u| 00000350 74 69 6c 69 74 79 2e 20 54 68 69 73 0a 20 20 20 |tility. This. | 00000360 20 20 20 20 20 20 20 20 20 20 20 20 20 69 73 20 | is | 00000370 75 73 65 64 20 62 6f 74 68 20 66 6f 72 20 74 68 |used both for th| 00000380 65 20 69 63 6f 6e 2d 62 61 72 20 69 63 6f 6e 0a |e icon-bar icon.| 00000390 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 | | 000003a0 61 6e 64 20 66 6f 72 20 74 68 65 20 6d 65 6e 75 |and for the menu| 000003b0 20 65 6e 74 72 79 2e 0a 2b 31 33 32 20 20 20 20 | entry..+132 | 000003c0 37 37 20 20 20 20 20 20 48 65 6c 70 20 6d 65 73 |77 Help mes| 000003d0 73 61 67 65 20 64 65 74 61 69 6c 69 6e 67 20 44 |sage detailing D| 000003e0 52 41 47 20 61 63 74 69 6f 6e 0a 20 20 20 20 20 |RAG action. | 000003f0 20 20 20 20 20 20 20 20 20 20 20 28 6f 72 20 62 | (or b| 00000400 6c 61 6e 6b 20 66 6f 72 20 6e 6f 6e 65 29 20 75 |lank for none) u| 00000410 73 65 64 20 66 6f 72 20 69 63 6f 6e 2d 0a 20 20 |sed for icon-. | 00000420 20 20 20 20 20 20 20 20 20 20 20 20 20 20 62 61 | ba| 00000430 72 20 69 63 6f 6e 20 61 6e 64 20 64 72 61 67 20 |r icon and drag | 00000440 74 61 72 67 65 74 20 77 69 6e 64 6f 77 2e 0a 2b |target window..+| 00000450 32 30 39 20 20 20 20 45 6e 64 20 6f 66 20 6d 65 |209 End of me| 00000460 73 73 61 67 65 0a 0a 4e 42 20 54 68 65 20 75 74 |ssage..NB The ut| 00000470 69 6c 69 74 69 65 73 20 73 68 6f 75 6c 64 20 6e |ilities should n| 00000480 6f 74 20 70 72 6f 76 69 64 65 20 61 6e 20 41 44 |ot provide an AD| 00000490 4a 55 53 54 20 61 63 74 69 6f 6e 0a 66 6f 72 20 |JUST action.for | 000004a0 74 68 65 20 69 63 6f 6e 2d 62 61 72 20 69 63 6f |the icon-bar ico| 000004b0 6e 2c 20 73 69 6e 63 65 20 74 68 65 20 53 45 4c |n, since the SEL| 000004c0 45 43 54 20 61 63 74 69 6f 6e 20 6d 61 79 0a 62 |ECT action may.b| 000004d0 65 20 61 73 73 69 67 6e 65 64 20 74 6f 20 65 69 |e assigned to ei| 000004e0 74 68 65 72 20 53 45 4c 45 43 54 20 6f 72 20 41 |ther SELECT or A| 000004f0 44 4a 55 53 54 20 62 79 20 4f 6d 6e 69 44 65 73 |DJUST by OmniDes| 00000500 6b 2e 0a 54 68 65 20 68 65 6c 70 20 6d 65 73 73 |k..The help mess| 00000510 61 67 65 20 73 68 6f 75 6c 64 20 6f 6d 69 74 20 |age should omit | 00000520 74 68 65 20 6f 70 65 6e 69 6e 67 20 22 43 6c 69 |the opening "Cli| 00000530 63 6b 0a 53 45 4c 45 43 54 2f 41 44 4a 55 53 54 |ck.SELECT/ADJUST| 00000540 20 74 6f 20 22 2c 20 73 69 6e 63 65 20 74 68 69 | to ", since thi| 00000550 73 20 69 73 20 70 72 6f 76 69 64 65 64 20 61 73 |s is provided as| 00000560 0a 61 70 70 72 6f 70 72 69 61 74 65 20 62 79 20 |.appropriate by | 00000570 4f 6d 6e 69 44 65 73 6b 2e 0a 0a 54 68 65 20 44 |OmniDesk...The D| 00000580 72 61 67 20 6d 65 73 73 61 67 65 20 73 68 6f 75 |rag message shou| 00000590 6c 64 20 62 65 20 6f 66 20 74 68 65 20 66 6f 72 |ld be of the for| 000005a0 6d 20 22 44 72 61 67 20 2e 2e 2e 0a 68 65 72 65 |m "Drag ....here| 000005b0 20 74 6f 20 2e 2e 2e 22 2c 20 73 69 6e 63 65 20 | to ...", since | 000005c0 69 74 20 69 73 20 75 73 65 64 20 62 6f 74 68 20 |it is used both | 000005d0 62 79 20 74 68 65 20 68 65 6c 70 0a 6d 65 73 73 |by the help.mess| 000005e0 61 67 65 20 66 6f 72 20 74 68 65 20 69 63 6f 6e |age for the icon| 000005f0 2d 62 61 72 20 69 63 6f 6e 20 61 6e 64 20 61 73 |-bar icon and as| 00000600 20 74 68 65 20 74 65 78 74 20 6c 61 62 65 6c 0a | the text label.| 00000610 69 6e 20 74 68 65 20 64 72 61 67 20 74 61 72 67 |in the drag targ| 00000620 65 74 20 77 69 6e 64 6f 77 2e 0a 0a 7e 7e 7e 7e |et window...~~~~| 00000630 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e |~~~~~~~~~~~~~~~~| * 00000660 0a 0a 4d 65 73 73 61 67 65 5f 55 74 69 6c 4f 70 |..Message_UtilOp| 00000670 65 6e 20 28 26 38 32 35 43 31 29 3a 0a 7e 7e 7e |en (&825C1):.~~~| 00000680 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e |~~~~~~~~~~~~~~~~| 00000690 7e 7e 7e 7e 7e 7e 7e 0a 54 68 69 73 20 69 73 20 |~~~~~~~.This is | 000006a0 74 68 65 20 6d 65 73 73 61 67 65 20 62 6c 6f 63 |the message bloc| 000006b0 6b 20 72 65 63 65 69 76 65 64 20 62 79 20 61 6e |k received by an| 000006c0 20 4f 6d 6e 69 44 65 73 6b 0a 75 74 69 6c 69 74 | OmniDesk.utilit| 000006d0 79 20 69 66 20 69 74 20 69 73 20 63 68 6f 73 65 |y if it is chose| 000006e0 6e 20 66 72 6f 6d 20 74 68 65 20 55 74 69 6c 69 |n from the Utili| 000006f0 74 69 65 73 20 6d 65 6e 75 2c 20 6f 72 0a 69 66 |ties menu, or.if| 00000700 20 69 74 20 68 61 73 20 62 65 65 6e 20 73 65 6c | it has been sel| 00000710 65 63 74 65 64 20 74 6f 20 72 65 63 65 69 76 65 |ected to receive| 00000720 20 53 45 4c 45 43 54 20 6f 72 20 41 44 4a 55 53 | SELECT or ADJUS| 00000730 54 0a 63 6c 69 63 6b 73 20 6f 6e 20 74 68 65 20 |T.clicks on the | 00000740 69 63 6f 6e 2d 62 61 72 20 69 63 6f 6e 2c 20 6f |icon-bar icon, o| 00000750 72 20 66 69 6c 65 2d 64 72 61 67 73 20 74 6f 20 |r file-drags to | 00000760 74 68 65 0a 69 63 6f 6e 2d 62 61 72 20 69 63 6f |the.icon-bar ico| 00000770 6e 2e 0a 0a 4f 66 66 73 65 74 3a 20 4c 65 6e 67 |n...Offset: Leng| 00000780 74 68 3a 20 43 6f 6e 74 65 6e 74 73 3a 0a 7e 7e |th: Contents:.~~| 00000790 7e 7e 7e 7e 7e 20 7e 7e 7e 7e 7e 7e 7e 20 7e 7e |~~~~~ ~~~~~~~ ~~| 000007a0 7e 7e 7e 7e 7e 7e 7e 0a 2b 32 30 20 20 20 20 20 |~~~~~~~.+20 | 000007b0 34 20 20 20 20 20 20 20 34 20 66 6f 72 20 61 20 |4 4 for a | 000007c0 6d 6f 75 73 65 20 63 6c 69 63 6b 0a 20 20 20 20 |mouse click. | 000007d0 20 20 20 20 20 20 20 20 20 20 20 20 32 20 66 6f | 2 fo| 000007e0 72 20 61 20 66 69 6c 65 20 74 6f 20 72 65 63 65 |r a file to rece| 000007f0 69 76 65 0a 2b 32 34 20 20 20 20 20 32 30 20 20 |ive.+24 20 | 00000800 20 20 20 20 54 61 73 6b 6e 61 6d 65 20 6f 66 20 | Taskname of | 00000810 52 45 43 45 49 56 45 52 0a 2d 2d 2d 2d 2d 2d 2d |RECEIVER.-------| 00000820 0a 49 66 20 42 6c 6f 63 6b 21 32 30 3d 32 2c 20 |.If Block!20=2, | 00000830 74 68 65 6e 3a 0a 2b 34 34 20 20 20 20 20 34 20 |then:.+44 4 | 00000840 20 20 20 20 20 20 45 73 74 69 6d 61 74 65 64 20 | Estimated | 00000850 73 69 7a 65 20 6f 66 20 64 61 74 61 20 69 6e 20 |size of data in | 00000860 62 79 74 65 73 0a 2b 34 38 20 20 20 20 20 34 20 |bytes.+48 4 | 00000870 20 20 20 20 20 20 46 69 6c 65 20 74 79 70 65 0a | File type.| 00000880 2b 35 32 20 20 20 20 20 3f 20 20 20 20 20 20 20 |+52 ? | 00000890 50 61 74 68 20 6e 61 6d 65 0a 0a 57 68 65 6e 20 |Path name..When | 000008a0 61 20 75 74 69 6c 69 74 79 20 72 65 63 65 69 76 |a utility receiv| 000008b0 65 73 20 74 68 69 73 20 6d 65 73 73 61 67 65 20 |es this message | 000008c0 66 72 6f 6d 20 4f 6d 6e 69 44 65 73 6b 2c 0a 69 |from OmniDesk,.i| 000008d0 74 20 73 68 6f 75 6c 64 20 63 68 65 63 6b 20 74 |t should check t| 000008e0 68 61 74 20 74 68 65 20 74 61 73 6b 6e 61 6d 65 |hat the taskname| 000008f0 20 69 6e 20 42 6c 6f 63 6b 2b 32 34 20 69 73 20 | in Block+24 is | 00000900 69 74 73 0a 6f 77 6e 20 74 61 73 6b 6e 61 6d 65 |its.own taskname| 00000910 2c 20 73 69 6e 63 65 20 69 74 20 6d 61 79 20 62 |, since it may b| 00000920 65 20 70 69 63 6b 69 6e 67 20 75 70 20 61 20 6d |e picking up a m| 00000930 65 73 73 61 67 65 0a 62 72 6f 61 64 63 61 73 74 |essage.broadcast| 00000940 20 66 6f 72 20 61 6e 6f 74 68 65 72 20 75 74 69 | for another uti| 00000950 6c 69 74 79 2e 0a 0a 49 66 20 74 68 65 20 6d 65 |lity...If the me| 00000960 73 73 61 67 65 20 69 73 20 66 6f 72 20 74 68 65 |ssage is for the| 00000970 20 75 74 69 6c 69 74 79 20 77 68 69 63 68 20 72 | utility which r| 00000980 65 63 65 69 76 65 73 20 69 74 2c 0a 74 68 65 20 |eceives it,.the | 00000990 75 74 69 6c 69 74 79 20 73 68 6f 75 6c 64 20 74 |utility should t| 000009a0 61 6b 65 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e |ake the followin| 000009b0 67 20 61 63 74 69 6f 6e 73 3a 0a 0a 49 66 20 42 |g actions:..If B| 000009c0 6c 6f 63 6b 21 32 30 3d 34 2c 20 74 68 65 6e 20 |lock!20=4, then | 000009d0 62 65 68 61 76 65 20 61 73 20 69 66 20 53 45 4c |behave as if SEL| 000009e0 45 43 54 20 68 61 64 20 62 65 65 6e 0a 63 6c 69 |ECT had been.cli| 000009f0 63 6b 65 64 20 6f 6e 20 74 68 65 20 69 63 6f 6e |cked on the icon| 00000a00 2d 62 61 72 20 69 63 6f 6e 2e 0a 0a 49 66 20 42 |-bar icon...If B| 00000a10 6c 6f 63 6b 21 32 30 3d 32 2c 20 74 68 65 6e 20 |lock!20=2, then | 00000a20 6c 6f 61 64 20 74 68 65 20 66 69 6c 65 20 75 73 |load the file us| 00000a30 69 6e 67 20 74 68 65 20 73 75 70 70 6c 69 65 64 |ing the supplied| 00000a40 0a 70 61 74 68 6e 61 6d 65 20 28 61 73 20 69 66 |.pathname (as if| 00000a50 20 69 74 20 68 61 64 20 62 65 65 6e 20 64 72 61 | it had been dra| 00000a60 67 67 65 64 20 74 6f 20 74 68 65 20 69 63 6f 6e |gged to the icon| 00000a70 2d 62 61 72 0a 69 63 6f 6e 29 2e 20 57 68 65 6e |-bar.icon). When| 00000a80 20 70 72 6f 63 65 73 73 69 6e 67 20 69 73 20 63 | processing is c| 00000a90 6f 6d 70 6c 65 74 65 2c 20 73 65 6e 64 20 61 20 |omplete, send a | 00000aa0 6d 65 73 73 61 67 65 0a 55 74 69 6c 41 63 6b 4c |message.UtilAckL| 00000ab0 6f 61 64 20 74 6f 20 4f 6d 6e 69 44 65 73 6b 20 |oad to OmniDesk | 00000ac0 73 6f 20 69 74 20 63 61 6e 20 74 69 64 79 20 74 |so it can tidy t| 00000ad0 68 69 6e 67 73 20 75 70 20 61 73 0a 6e 65 63 65 |hings up as.nece| 00000ae0 73 73 61 72 79 20 28 69 2e 65 2e 20 64 65 6c 65 |ssary (i.e. dele| 00000af0 74 65 20 3c 57 69 6d 70 24 53 63 72 61 70 3e 20 |te <Wimp$Scrap> | 00000b00 69 66 20 61 70 70 72 6f 70 72 69 61 74 65 29 2e |if appropriate).| 00000b10 0a 0a 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e |..~~~~~~~~~~~~~~| 00000b20 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e |~~~~~~~~~~~~~~~~| * 00000b40 7e 7e 7e 7e 7e 7e 0a 0a 4d 65 73 73 61 67 65 5f |~~~~~~..Message_| 00000b50 55 74 69 6c 51 75 69 74 74 69 6e 67 20 28 26 38 |UtilQuitting (&8| 00000b60 32 35 43 32 29 3a 0a 7e 7e 7e 7e 7e 7e 7e 7e 7e |25C2):.~~~~~~~~~| 00000b70 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e |~~~~~~~~~~~~~~~~| 00000b80 7e 7e 7e 7e 7e 0a 54 68 69 73 20 69 73 20 75 73 |~~~~~.This is us| 00000b90 65 64 20 75 6e 64 65 72 20 74 68 72 65 65 20 63 |ed under three c| 00000ba0 69 72 63 75 6d 73 74 61 6e 63 65 73 3a 0a 0a 31 |ircumstances:..1| 00000bb0 29 20 4f 6d 6e 69 44 65 73 6b 20 62 72 6f 61 64 |) OmniDesk broad| 00000bc0 63 61 73 74 73 20 74 68 65 20 6d 65 73 73 61 67 |casts the messag| 00000bd0 65 20 77 68 65 6e 20 51 75 69 74 20 68 61 73 0a |e when Quit has.| 00000be0 62 65 65 6e 20 63 68 6f 73 65 6e 20 66 72 6f 6d |been chosen from| 00000bf0 20 69 74 73 20 69 63 6f 6e 2d 62 61 72 20 6d 65 | its icon-bar me| 00000c00 6e 75 2e 20 41 6e 79 20 75 74 69 6c 69 74 79 0a |nu. Any utility.| 00000c10 77 68 69 63 68 20 68 61 73 20 62 65 65 6e 20 73 |which has been s| 00000c20 74 61 72 74 65 64 20 62 79 20 4f 6d 6e 69 44 65 |tarted by OmniDe| 00000c30 73 6b 20 6d 75 73 74 20 6e 6f 77 20 65 78 69 74 |sk must now exit| 00000c40 0a 69 6d 6d 65 64 69 61 74 65 6c 79 2e 0a 0a 32 |.immediately...2| 00000c50 29 20 4f 6d 6e 69 44 65 73 6b 20 73 65 6e 64 73 |) OmniDesk sends| 00000c60 20 74 68 65 20 6d 65 73 73 61 67 65 20 74 6f 20 | the message to | 00000c70 65 61 63 68 20 61 70 70 72 6f 70 72 69 61 74 65 |each appropriate| 00000c80 0a 75 74 69 6c 69 74 79 20 77 68 65 6e 20 27 4f |.utility when 'O| 00000c90 4b 27 20 69 73 20 63 6c 69 63 6b 65 64 20 69 6e |K' is clicked in| 00000ca0 20 74 68 65 20 50 72 65 66 65 72 65 6e 63 65 73 | the Preferences| 00000cb0 0a 77 69 6e 64 6f 77 3a 20 69 2e 65 2e 20 61 6e |.window: i.e. an| 00000cc0 79 20 75 74 69 6c 69 74 79 20 77 68 69 63 68 20 |y utility which | 00000cd0 69 73 20 72 75 6e 6e 69 6e 67 20 61 6e 64 20 77 |is running and w| 00000ce0 68 6f 73 65 0a 27 6c 6f 61 64 27 20 73 77 69 74 |hose.'load' swit| 00000cf0 63 68 20 69 73 20 64 65 73 65 6c 65 63 74 65 64 |ch is deselected| 00000d00 20 77 69 6c 6c 20 62 65 20 74 6f 6c 64 20 74 6f | will be told to| 00000d10 20 71 75 69 74 2e 0a 0a 33 29 20 49 66 20 61 20 | quit...3) If a | 00000d20 75 74 69 6c 69 74 79 20 71 75 69 74 73 20 75 6e |utility quits un| 00000d30 65 78 70 65 63 74 65 64 6c 79 2c 20 6f 72 20 69 |expectedly, or i| 00000d40 73 20 71 75 69 74 20 66 72 6f 6d 0a 74 68 65 20 |s quit from.the | 00000d50 74 61 73 6b 20 6d 61 6e 61 67 65 72 2c 20 69 74 |task manager, it| 00000d60 20 73 65 6e 64 73 20 74 68 65 20 6d 65 73 73 61 | sends the messa| 00000d70 67 65 20 74 6f 20 4f 6d 6e 69 44 65 73 6b 0a 73 |ge to OmniDesk.s| 00000d80 6f 20 74 68 61 74 20 69 74 73 20 69 6e 74 65 72 |o that its inter| 00000d90 6e 61 6c 20 75 74 69 6c 69 74 79 20 72 65 63 6f |nal utility reco| 00000da0 72 64 20 63 61 6e 20 62 65 20 75 70 64 61 74 65 |rd can be update| 00000db0 64 2e 0a 0a 4f 66 66 73 65 74 3a 20 4c 65 6e 67 |d...Offset: Leng| 00000dc0 74 68 3a 20 43 6f 6e 74 65 6e 74 73 3a 0a 7e 7e |th: Contents:.~~| 00000dd0 7e 7e 7e 7e 7e 20 7e 7e 7e 7e 7e 7e 7e 20 7e 7e |~~~~~ ~~~~~~~ ~~| 00000de0 7e 7e 7e 7e 7e 7e 7e 0a 2b 32 30 20 20 20 20 20 |~~~~~~~.+20 | 00000df0 34 20 20 20 20 20 20 20 54 61 73 6b 20 68 61 6e |4 Task han| 00000e00 64 6c 65 0a 0a 46 6f 72 20 63 69 72 63 75 6d 73 |dle..For circums| 00000e10 74 61 6e 63 65 73 20 28 31 29 20 61 6e 64 20 28 |tances (1) and (| 00000e20 32 29 2c 20 74 68 65 20 74 61 73 6b 20 68 61 6e |2), the task han| 00000e30 64 6c 65 20 77 69 6c 6c 0a 62 65 20 74 68 61 74 |dle will.be that| 00000e40 20 6f 66 20 4f 6d 6e 69 44 65 73 6b 2e 0a 0a 46 | of OmniDesk...F| 00000e50 6f 72 20 63 69 72 63 75 6d 73 74 61 6e 63 65 20 |or circumstance | 00000e60 28 33 29 2c 20 74 68 65 20 74 61 73 6b 20 68 61 |(3), the task ha| 00000e70 6e 64 6c 65 20 77 69 6c 6c 20 62 65 20 74 68 61 |ndle will be tha| 00000e80 74 0a 6f 66 20 74 68 65 20 71 75 69 74 74 69 6e |t.of the quittin| 00000e90 67 20 75 74 69 6c 69 74 79 2e 0a 0a 54 68 65 20 |g utility...The | 00000ea0 6d 65 73 73 61 67 65 20 69 73 20 6f 6e 6c 79 20 |message is only | 00000eb0 2a 62 72 6f 61 64 63 61 73 74 2a 20 75 6e 64 65 |*broadcast* unde| 00000ec0 72 20 63 69 72 63 75 6d 73 74 61 6e 63 65 0a 28 |r circumstance.(| 00000ed0 31 29 2c 20 61 6e 64 20 75 6e 6c 65 73 73 20 74 |1), and unless t| 00000ee0 68 65 20 74 61 73 6b 20 68 61 6e 64 6c 65 20 72 |he task handle r| 00000ef0 65 63 65 69 76 65 64 20 69 73 20 74 68 61 74 20 |eceived is that | 00000f00 6f 66 0a 4f 6d 6e 69 44 65 73 6b 2c 20 61 20 72 |of.OmniDesk, a r| 00000f10 65 63 65 69 76 69 6e 67 20 74 61 73 6b 20 73 68 |eceiving task sh| 00000f20 6f 75 6c 64 20 69 67 6e 6f 72 65 20 69 74 2e 0a |ould ignore it..| 00000f30 0a 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e |.~~~~~~~~~~~~~~~| 00000f40 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e |~~~~~~~~~~~~~~~~| * 00000f60 7e 7e 7e 7e 7e 0a 0a 4d 65 73 73 61 67 65 5f 55 |~~~~~..Message_U| 00000f70 74 69 6c 52 65 73 69 64 65 20 28 26 38 32 35 43 |tilReside (&825C| 00000f80 33 29 3a 0a 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e |3):.~~~~~~~~~~~~| 00000f90 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e |~~~~~~~~~~~~~~~~| 00000fa0 0a 4e 6f 20 63 6f 6e 74 65 6e 74 73 0a 7e 7e 7e |.No contents.~~~| 00000fb0 7e 7e 7e 7e 7e 7e 7e 7e 0a 41 20 75 74 69 6c 69 |~~~~~~~~.A utili| 00000fc0 74 79 20 72 65 63 65 69 76 69 6e 67 20 74 68 69 |ty receiving thi| 00000fd0 73 20 6d 65 73 73 61 67 65 20 73 68 6f 75 6c 64 |s message should| 00000fe0 20 75 70 64 61 74 65 20 69 74 73 0a 73 74 61 74 | update its.stat| 00000ff0 75 73 20 74 6f 20 6f 6e 65 20 6f 66 20 70 65 72 |us to one of per| 00001000 6d 61 6e 65 6e 63 65 2e 0a 0a 53 70 65 63 69 66 |manence...Specif| 00001010 69 63 61 6c 6c 79 2c 20 75 70 64 61 74 65 20 74 |ically, update t| 00001020 68 65 20 45 78 69 74 20 76 61 72 69 61 62 6c 65 |he Exit variable| 00001030 20 74 6f 20 46 41 4c 53 45 20 61 6e 64 0a 62 65 | to FALSE and.be| 00001040 63 6f 6d 65 20 70 65 72 6d 61 6e 65 6e 74 3a 20 |come permanent: | 00001050 69 2e 65 2e 20 64 6f 20 6e 6f 74 20 71 75 69 74 |i.e. do not quit| 00001060 20 75 6e 74 69 6c 20 61 63 74 75 61 6c 6c 79 0a | until actually.| 00001070 74 6f 6c 64 20 74 6f 20 64 6f 20 73 6f 20 62 79 |told to do so by| 00001080 20 4f 6d 6e 69 44 65 73 6b 2e 0a 0a 7e 7e 7e 7e | OmniDesk...~~~~| 00001090 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e |~~~~~~~~~~~~~~~~| * 000010c0 0a 0a 4d 65 73 73 61 67 65 5f 55 74 69 6c 4c 6f |..Message_UtilLo| 000010d0 61 64 41 63 6b 20 28 26 38 32 35 43 34 29 3a 0a |adAck (&825C4):.| 000010e0 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e |~~~~~~~~~~~~~~~~| 000010f0 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 0a 4e 6f |~~~~~~~~~~~~~.No| 00001100 20 63 6f 6e 74 65 6e 74 73 0a 7e 7e 7e 7e 7e 7e | contents.~~~~~~| 00001110 7e 7e 7e 7e 7e 0a 41 20 75 74 69 6c 69 74 79 20 |~~~~~.A utility | 00001120 73 68 6f 75 6c 64 20 73 65 6e 64 20 74 68 69 73 |should send this| 00001130 20 6d 65 73 73 61 67 65 20 74 6f 20 4f 6d 6e 69 | message to Omni| 00001140 44 65 73 6b 20 6f 6e 63 65 0a 69 74 20 68 61 73 |Desk once.it has| 00001150 20 66 69 6e 69 73 68 65 64 20 70 72 6f 63 65 73 | finished proces| 00001160 73 69 6e 67 20 61 20 66 69 6c 65 20 77 68 69 63 |sing a file whic| 00001170 68 20 69 74 20 77 61 73 20 74 6f 6c 64 0a 74 6f |h it was told.to| 00001180 20 6c 6f 61 64 20 62 79 20 61 20 70 72 65 76 69 | load by a previ| 00001190 6f 75 73 20 4d 65 73 73 61 67 65 5f 55 74 69 6c |ous Message_Util| 000011a0 4f 70 65 6e 20 77 69 74 68 20 61 0a 42 6c 6f 63 |Open with a.Bloc| 000011b0 6b 21 32 30 20 63 6f 64 65 20 6f 66 20 32 2e 0a |k!20 code of 2..| 000011c0 0a 53 70 65 63 69 66 69 63 61 6c 6c 79 2c 20 74 |.Specifically, t| 000011d0 68 65 20 70 72 6f 63 65 73 73 20 69 73 20 61 73 |he process is as| 000011e0 20 66 6f 6c 6c 6f 77 73 3a 0a 0a 31 2e 20 54 68 | follows:..1. Th| 000011f0 65 20 75 73 65 72 20 64 72 61 67 73 20 61 20 66 |e user drags a f| 00001200 69 6c 65 20 74 6f 20 74 68 65 20 4f 6d 6e 69 44 |ile to the OmniD| 00001210 65 73 6b 20 69 63 6f 6e 20 6f 72 0a 64 72 61 67 |esk icon or.drag| 00001220 20 74 61 72 67 65 74 20 77 69 6e 64 6f 77 2e 0a | target window..| 00001230 0a 32 2e 20 4f 6d 6e 69 44 65 73 6b 20 73 65 6e |.2. OmniDesk sen| 00001240 64 73 20 61 20 4d 65 73 73 61 67 65 5f 55 74 69 |ds a Message_Uti| 00001250 6c 4f 70 65 6e 20 74 6f 20 74 68 65 20 75 74 69 |lOpen to the uti| 00001260 6c 69 74 79 0a 69 6e 20 71 75 65 73 74 69 6f 6e |lity.in question| 00001270 2e 0a 0a 33 2e 20 54 68 65 20 75 74 69 6c 69 74 |...3. The utilit| 00001280 79 20 70 72 6f 63 65 73 73 65 73 20 74 68 65 20 |y processes the | 00001290 66 69 6c 65 20 69 66 20 61 70 70 72 6f 70 72 69 |file if appropri| 000012a0 61 74 65 20 6f 72 0a 70 75 74 73 20 75 70 20 61 |ate or.puts up a| 000012b0 6e 20 65 72 72 6f 72 20 69 66 20 69 74 27 73 20 |n error if it's | 000012c0 74 68 65 20 77 72 6f 6e 67 20 66 69 6c 65 20 74 |the wrong file t| 000012d0 79 70 65 20 65 74 63 2e 0a 0a 34 2e 20 54 68 65 |ype etc...4. The| 000012e0 20 75 74 69 6c 69 74 79 20 73 65 6e 64 73 20 61 | utility sends a| 000012f0 20 4d 65 73 73 61 67 65 5f 55 74 69 6c 4c 6f 61 | Message_UtilLoa| 00001300 64 41 63 6b 20 62 61 63 6b 20 74 6f 0a 4f 6d 6e |dAck back to.Omn| 00001310 69 44 65 73 6b 2e 0a 0a 35 2e 20 4f 6d 6e 69 44 |iDesk...5. OmniD| 00001320 65 73 6b 20 64 65 6c 65 74 65 73 20 3c 57 69 6d |esk deletes <Wim| 00001330 70 24 53 63 72 61 70 3e 20 69 66 20 74 68 61 74 |p$Scrap> if that| 00001340 27 73 20 77 68 65 72 65 20 74 68 65 0a 69 6e 70 |'s where the.inp| 00001350 75 74 20 66 69 6c 65 20 63 61 6d 65 20 66 72 6f |ut file came fro| 00001360 6d 2e 0a 0a 4e 2e 42 2e 20 49 66 20 61 6e 79 20 |m...N.B. If any | 00001370 75 74 69 6c 69 74 79 20 77 68 69 63 68 20 61 63 |utility which ac| 00001380 63 65 70 74 73 20 64 72 61 67 67 65 64 20 66 69 |cepts dragged fi| 00001390 6c 65 73 20 69 73 0a 72 75 6e 20 61 6c 6f 6e 65 |les is.run alone| 000013a0 20 28 69 2e 65 2e 20 6e 6f 74 20 76 69 61 20 4f | (i.e. not via O| 000013b0 6d 6e 69 44 65 73 6b 2c 20 62 75 74 20 69 6e 73 |mniDesk, but ins| 000013c0 74 61 6c 6c 69 6e 67 20 69 74 73 0a 6f 77 6e 20 |talling its.own | 000013d0 69 63 6f 6e 20 6f 6e 20 74 68 65 20 69 63 6f 6e |icon on the icon| 000013e0 2d 62 61 72 29 2c 20 74 68 65 6e 20 69 74 20 6d |-bar), then it m| 000013f0 75 73 74 20 68 61 6e 64 6c 65 20 61 6c 6c 0a 64 |ust handle all.d| 00001400 72 61 67 73 2c 20 69 6e 63 6c 75 64 69 6e 67 20 |rags, including | 00001410 74 68 6f 73 65 20 69 6e 76 6f 6c 76 69 6e 67 20 |those involving | 00001420 3c 57 69 6d 70 24 53 63 72 61 70 3e 2c 0a 69 74 |<Wimp$Scrap>,.it| 00001430 73 65 6c 66 2e 20 54 68 69 73 20 77 69 6c 6c 20 |self. This will | 00001440 6f 66 20 63 6f 75 72 73 65 20 61 6c 73 6f 20 61 |of course also a| 00001450 70 70 6c 79 20 74 6f 20 75 74 69 6c 69 74 69 65 |pply to utilitie| 00001460 73 0a 73 74 61 72 74 65 64 20 62 79 20 4f 6d 6e |s.started by Omn| 00001470 69 44 65 73 6b 20 69 66 20 74 68 65 79 20 61 6c |iDesk if they al| 00001480 6c 6f 77 20 74 68 65 20 75 73 65 72 20 74 6f 20 |low the user to | 00001490 64 72 61 67 0a 61 20 6e 65 77 20 66 69 6c 65 20 |drag.a new file | 000014a0 69 6e 74 6f 20 6f 6e 65 20 6f 66 20 74 68 65 69 |into one of thei| 000014b0 72 20 6f 77 6e 20 77 69 6e 64 6f 77 73 2e 0a |r own windows..| 000014bf
.