Home » Archimedes archive » Acorn User » AU 1996-12 B.adf » Features » PCA/Docs/Ui
PCA/Docs/Ui
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 1996-12 B.adf » Features |
| Filename: | PCA/Docs/Ui |
| Read OK: | ✔ |
| File size: | 0DB7 bytes |
| Load address: | 0000 |
| Exec address: | 0000 |
File contents
Plug In Compliant Application protocol ====================================== PCA User Interface specifications ================================= Author : Rob Davison (rdavison@xtra.co.nz) Date : 15/08/96 Status : Release 1 This documents the suggested user-interface and general message handling requirements for applications on both sides of the PCA protocol. You should note that it is possible for applications to implement either or both sides of the protocol. Local application ----------------- The local application must poll the PCA system with Message_WhosAbout and present that information to the user. It is recommended that you provide several methods of doing this: Invoking the protocol --------------------- Invoking the protocol scans the active tasks and presents a list of the available utilities. This list can be presented in two ways; as a simple RISC OS menu or as a graphical 'pop-up' window. You should support both methods in your applications by providing a preferences option to the user. To invoke the popup Ctrl-Shift-Double Click is recommended. If that shortcut is not free another combination is acceptable, preferably related in some way to the Ctrl-Double click Acorn OLE-1 standard. In addition, add the PCA to your menu structure. The sub-menu item "Utilities >" is appropriate. Another alternative is to add a button to your toolbar to invoke the protocol. The width of this dialogue should be set to the width of the longest tool name returned in the Message_ImHere messages (which may be found on the RiscPC using SWI Wimp_TextOp). Add 220 OS-units to the width of all items to allow for the Tool icon and Info buttons. The height of each item is fixed at 96 OS-units. The tool icon is present in the Wimp sprite pool and is usually the PCA applications icon. Applications which provide multiple 'tools' can register more than once, passing a unique 'toolnumber' with Message_ImHere . The popup should be opened such that the pointer is centred over the top tool name and as a menu so it automatically closes on any mouse access outside it. If there are more than five PCAs available the popup dialogue should be given a vertical scrollbar and the initial size limited to five items. For a more detailed example, see the PCA version of Composition or the dialogue creation and redraw code in !Spaint. Other options Several other options may be offered to the user by a Local task. Which are practical depends on the application in question but the following may be appropriate for a task which supports both sides of the protocol: The display radio buttons allow the user to choose the form of popup which will be presented to the user. Menus are simpler and take up less desktop space. Dialogue boxes look better and provide more information. The In-place editing option should be provided by a Remote task. If no objects are being edited then toggling this option simply prevents or allows bit 4 of the flags word to be set in subsequent Message_ImHere messages generated. If an object is being edited in-place when this option is toggled the Remote task should switch between in-place and remote operation on that object as the option is toggled. The 'Follow selected' option is provided by a Local task and, when on, the last task sent a Message_DoYourStuff is automatically sent a new Message_DoYourStuff every time the 'selected object' changes. Obviously this option only has validity when there is a concept of the 'selected object'.
00000000 50 6c 75 67 20 49 6e 20 43 6f 6d 70 6c 69 61 6e |Plug In Complian| 00000010 74 20 41 70 70 6c 69 63 61 74 69 6f 6e 20 70 72 |t Application pr| 00000020 6f 74 6f 63 6f 6c 0a 3d 3d 3d 3d 3d 3d 3d 3d 3d |otocol.=========| 00000030 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d |================| 00000040 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 0a 0a 0a |=============...| 00000050 0a 50 43 41 20 55 73 65 72 20 49 6e 74 65 72 66 |.PCA User Interf| 00000060 61 63 65 20 73 70 65 63 69 66 69 63 61 74 69 6f |ace specificatio| 00000070 6e 73 0a 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d |ns.=============| 00000080 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d |================| 00000090 3d 3d 3d 3d 0a 0a 0a 41 75 74 68 6f 72 20 3a 20 |====...Author : | 000000a0 52 6f 62 20 44 61 76 69 73 6f 6e 20 28 72 64 61 |Rob Davison (rda| 000000b0 76 69 73 6f 6e 40 78 74 72 61 2e 63 6f 2e 6e 7a |vison@xtra.co.nz| 000000c0 29 0a 44 61 74 65 20 3a 20 31 35 2f 30 38 2f 39 |).Date : 15/08/9| 000000d0 36 0a 53 74 61 74 75 73 20 3a 20 52 65 6c 65 61 |6.Status : Relea| 000000e0 73 65 20 31 0a 0a 54 68 69 73 20 64 6f 63 75 6d |se 1..This docum| 000000f0 65 6e 74 73 20 74 68 65 20 73 75 67 67 65 73 74 |ents the suggest| 00000100 65 64 20 75 73 65 72 2d 69 6e 74 65 72 66 61 63 |ed user-interfac| 00000110 65 20 61 6e 64 20 67 65 6e 65 72 61 6c 20 6d 65 |e and general me| 00000120 73 73 61 67 65 20 68 61 6e 64 6c 69 6e 67 0a 72 |ssage handling.r| 00000130 65 71 75 69 72 65 6d 65 6e 74 73 20 66 6f 72 20 |equirements for | 00000140 61 70 70 6c 69 63 61 74 69 6f 6e 73 20 6f 6e 20 |applications on | 00000150 62 6f 74 68 20 73 69 64 65 73 20 6f 66 20 74 68 |both sides of th| 00000160 65 20 50 43 41 20 70 72 6f 74 6f 63 6f 6c 2e 20 |e PCA protocol. | 00000170 59 6f 75 20 73 68 6f 75 6c 64 0a 6e 6f 74 65 20 |You should.note | 00000180 74 68 61 74 20 69 74 20 69 73 20 70 6f 73 73 69 |that it is possi| 00000190 62 6c 65 20 66 6f 72 20 61 70 70 6c 69 63 61 74 |ble for applicat| 000001a0 69 6f 6e 73 20 74 6f 20 69 6d 70 6c 65 6d 65 6e |ions to implemen| 000001b0 74 20 65 69 74 68 65 72 20 6f 72 20 62 6f 74 68 |t either or both| 000001c0 20 73 69 64 65 73 0a 6f 66 20 74 68 65 20 70 72 | sides.of the pr| 000001d0 6f 74 6f 63 6f 6c 2e 0a 0a 0a 4c 6f 63 61 6c 20 |otocol....Local | 000001e0 61 70 70 6c 69 63 61 74 69 6f 6e 0a 2d 2d 2d 2d |application.----| 000001f0 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 54 |-------------..T| 00000200 68 65 20 6c 6f 63 61 6c 20 61 70 70 6c 69 63 61 |he local applica| 00000210 74 69 6f 6e 20 6d 75 73 74 20 70 6f 6c 6c 20 74 |tion must poll t| 00000220 68 65 20 50 43 41 20 73 79 73 74 65 6d 20 77 69 |he PCA system wi| 00000230 74 68 20 4d 65 73 73 61 67 65 5f 57 68 6f 73 41 |th Message_WhosA| 00000240 62 6f 75 74 20 61 6e 64 0a 70 72 65 73 65 6e 74 |bout and.present| 00000250 20 74 68 61 74 20 69 6e 66 6f 72 6d 61 74 69 6f | that informatio| 00000260 6e 20 74 6f 20 74 68 65 20 75 73 65 72 2e 20 49 |n to the user. I| 00000270 74 20 69 73 20 72 65 63 6f 6d 6d 65 6e 64 65 64 |t is recommended| 00000280 20 74 68 61 74 20 79 6f 75 20 70 72 6f 76 69 64 | that you provid| 00000290 65 0a 73 65 76 65 72 61 6c 20 6d 65 74 68 6f 64 |e.several method| 000002a0 73 20 6f 66 20 64 6f 69 6e 67 20 74 68 69 73 3a |s of doing this:| 000002b0 0a 0a 0a 49 6e 76 6f 6b 69 6e 67 20 74 68 65 20 |...Invoking the | 000002c0 70 72 6f 74 6f 63 6f 6c 0a 2d 2d 2d 2d 2d 2d 2d |protocol.-------| 000002d0 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a |--------------..| 000002e0 49 6e 76 6f 6b 69 6e 67 20 74 68 65 20 70 72 6f |Invoking the pro| 000002f0 74 6f 63 6f 6c 20 73 63 61 6e 73 20 74 68 65 20 |tocol scans the | 00000300 61 63 74 69 76 65 20 74 61 73 6b 73 20 61 6e 64 |active tasks and| 00000310 20 70 72 65 73 65 6e 74 73 20 61 20 6c 69 73 74 | presents a list| 00000320 20 6f 66 20 74 68 65 0a 61 76 61 69 6c 61 62 6c | of the.availabl| 00000330 65 20 75 74 69 6c 69 74 69 65 73 2e 20 54 68 69 |e utilities. Thi| 00000340 73 20 6c 69 73 74 20 63 61 6e 20 62 65 20 70 72 |s list can be pr| 00000350 65 73 65 6e 74 65 64 20 69 6e 20 74 77 6f 20 77 |esented in two w| 00000360 61 79 73 3b 20 61 73 20 61 20 73 69 6d 70 6c 65 |ays; as a simple| 00000370 0a 52 49 53 43 20 4f 53 20 6d 65 6e 75 20 6f 72 |.RISC OS menu or| 00000380 20 61 73 20 61 20 67 72 61 70 68 69 63 61 6c 20 | as a graphical | 00000390 27 70 6f 70 2d 75 70 27 20 77 69 6e 64 6f 77 2e |'pop-up' window.| 000003a0 20 59 6f 75 20 73 68 6f 75 6c 64 20 73 75 70 70 | You should supp| 000003b0 6f 72 74 20 62 6f 74 68 0a 6d 65 74 68 6f 64 73 |ort both.methods| 000003c0 20 69 6e 20 79 6f 75 72 20 61 70 70 6c 69 63 61 | in your applica| 000003d0 74 69 6f 6e 73 20 62 79 20 70 72 6f 76 69 64 69 |tions by providi| 000003e0 6e 67 20 61 20 70 72 65 66 65 72 65 6e 63 65 73 |ng a preferences| 000003f0 20 6f 70 74 69 6f 6e 20 74 6f 20 74 68 65 20 75 | option to the u| 00000400 73 65 72 2e 0a 54 6f 20 69 6e 76 6f 6b 65 20 74 |ser..To invoke t| 00000410 68 65 20 70 6f 70 75 70 20 43 74 72 6c 2d 53 68 |he popup Ctrl-Sh| 00000420 69 66 74 2d 44 6f 75 62 6c 65 20 43 6c 69 63 6b |ift-Double Click| 00000430 20 69 73 20 72 65 63 6f 6d 6d 65 6e 64 65 64 2e | is recommended.| 00000440 20 49 66 20 74 68 61 74 20 73 68 6f 72 74 63 75 | If that shortcu| 00000450 74 0a 69 73 20 6e 6f 74 20 66 72 65 65 20 61 6e |t.is not free an| 00000460 6f 74 68 65 72 20 63 6f 6d 62 69 6e 61 74 69 6f |other combinatio| 00000470 6e 20 69 73 20 61 63 63 65 70 74 61 62 6c 65 2c |n is acceptable,| 00000480 20 70 72 65 66 65 72 61 62 6c 79 20 72 65 6c 61 | preferably rela| 00000490 74 65 64 20 69 6e 20 73 6f 6d 65 0a 77 61 79 20 |ted in some.way | 000004a0 74 6f 20 74 68 65 20 43 74 72 6c 2d 44 6f 75 62 |to the Ctrl-Doub| 000004b0 6c 65 20 63 6c 69 63 6b 20 41 63 6f 72 6e 20 4f |le click Acorn O| 000004c0 4c 45 2d 31 20 73 74 61 6e 64 61 72 64 2e 0a 0a |LE-1 standard...| 000004d0 49 6e 20 61 64 64 69 74 69 6f 6e 2c 20 61 64 64 |In addition, add| 000004e0 20 74 68 65 20 50 43 41 20 74 6f 20 79 6f 75 72 | the PCA to your| 000004f0 20 6d 65 6e 75 20 73 74 72 75 63 74 75 72 65 2e | menu structure.| 00000500 20 54 68 65 20 73 75 62 2d 6d 65 6e 75 20 69 74 | The sub-menu it| 00000510 65 6d 0a 22 55 74 69 6c 69 74 69 65 73 20 3e 22 |em."Utilities >"| 00000520 20 69 73 20 61 70 70 72 6f 70 72 69 61 74 65 2e | is appropriate.| 00000530 20 41 6e 6f 74 68 65 72 20 61 6c 74 65 72 6e 61 | Another alterna| 00000540 74 69 76 65 20 69 73 20 74 6f 20 61 64 64 20 61 |tive is to add a| 00000550 20 62 75 74 74 6f 6e 20 74 6f 20 79 6f 75 72 0a | button to your.| 00000560 74 6f 6f 6c 62 61 72 20 74 6f 20 69 6e 76 6f 6b |toolbar to invok| 00000570 65 20 74 68 65 20 70 72 6f 74 6f 63 6f 6c 2e 0a |e the protocol..| 00000580 20 20 20 0a 54 68 65 20 77 69 64 74 68 20 6f 66 | .The width of| 00000590 20 74 68 69 73 20 64 69 61 6c 6f 67 75 65 20 73 | this dialogue s| 000005a0 68 6f 75 6c 64 20 62 65 20 73 65 74 20 74 6f 20 |hould be set to | 000005b0 74 68 65 20 77 69 64 74 68 20 6f 66 20 74 68 65 |the width of the| 000005c0 20 6c 6f 6e 67 65 73 74 20 74 6f 6f 6c 0a 6e 61 | longest tool.na| 000005d0 6d 65 20 72 65 74 75 72 6e 65 64 20 69 6e 20 74 |me returned in t| 000005e0 68 65 20 20 4d 65 73 73 61 67 65 5f 49 6d 48 65 |he Message_ImHe| 000005f0 72 65 20 6d 65 73 73 61 67 65 73 20 28 77 68 69 |re messages (whi| 00000600 63 68 20 6d 61 79 20 62 65 20 66 6f 75 6e 64 20 |ch may be found | 00000610 6f 6e 20 74 68 65 0a 52 69 73 63 50 43 20 75 73 |on the.RiscPC us| 00000620 69 6e 67 20 53 57 49 20 57 69 6d 70 5f 54 65 78 |ing SWI Wimp_Tex| 00000630 74 4f 70 29 2e 20 41 64 64 20 32 32 30 20 4f 53 |tOp). Add 220 OS| 00000640 2d 75 6e 69 74 73 20 74 6f 20 74 68 65 20 77 69 |-units to the wi| 00000650 64 74 68 20 6f 66 20 61 6c 6c 20 69 74 65 6d 73 |dth of all items| 00000660 20 74 6f 0a 61 6c 6c 6f 77 20 66 6f 72 20 74 68 | to.allow for th| 00000670 65 20 54 6f 6f 6c 20 69 63 6f 6e 20 61 6e 64 20 |e Tool icon and | 00000680 49 6e 66 6f 20 62 75 74 74 6f 6e 73 2e 20 54 68 |Info buttons. Th| 00000690 65 20 68 65 69 67 68 74 20 6f 66 20 65 61 63 68 |e height of each| 000006a0 20 69 74 65 6d 20 69 73 20 66 69 78 65 64 0a 61 | item is fixed.a| 000006b0 74 20 39 36 20 4f 53 2d 75 6e 69 74 73 2e 0a 0a |t 96 OS-units...| 000006c0 54 68 65 20 74 6f 6f 6c 20 69 63 6f 6e 20 69 73 |The tool icon is| 000006d0 20 70 72 65 73 65 6e 74 20 69 6e 20 74 68 65 20 | present in the | 000006e0 57 69 6d 70 20 73 70 72 69 74 65 20 70 6f 6f 6c |Wimp sprite pool| 000006f0 20 61 6e 64 20 69 73 20 75 73 75 61 6c 6c 79 20 | and is usually | 00000700 74 68 65 20 50 43 41 0a 61 70 70 6c 69 63 61 74 |the PCA.applicat| 00000710 69 6f 6e 73 20 69 63 6f 6e 2e 20 41 70 70 6c 69 |ions icon. Appli| 00000720 63 61 74 69 6f 6e 73 20 77 68 69 63 68 20 70 72 |cations which pr| 00000730 6f 76 69 64 65 20 6d 75 6c 74 69 70 6c 65 20 27 |ovide multiple '| 00000740 74 6f 6f 6c 73 27 20 63 61 6e 20 72 65 67 69 73 |tools' can regis| 00000750 74 65 72 0a 6d 6f 72 65 20 74 68 61 6e 20 6f 6e |ter.more than on| 00000760 63 65 2c 20 70 61 73 73 69 6e 67 20 61 20 75 6e |ce, passing a un| 00000770 69 71 75 65 20 27 74 6f 6f 6c 6e 75 6d 62 65 72 |ique 'toolnumber| 00000780 27 20 77 69 74 68 20 4d 65 73 73 61 67 65 5f 49 |' with Message_I| 00000790 6d 48 65 72 65 20 2e 20 0a 0a 54 68 65 20 70 6f |mHere . ..The po| 000007a0 70 75 70 20 73 68 6f 75 6c 64 20 62 65 20 6f 70 |pup should be op| 000007b0 65 6e 65 64 20 73 75 63 68 20 74 68 61 74 20 74 |ened such that t| 000007c0 68 65 20 70 6f 69 6e 74 65 72 20 69 73 20 63 65 |he pointer is ce| 000007d0 6e 74 72 65 64 20 6f 76 65 72 20 74 68 65 20 74 |ntred over the t| 000007e0 6f 70 0a 74 6f 6f 6c 20 6e 61 6d 65 20 61 6e 64 |op.tool name and| 000007f0 20 61 73 20 61 20 6d 65 6e 75 20 73 6f 20 69 74 | as a menu so it| 00000800 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 63 | automatically c| 00000810 6c 6f 73 65 73 20 6f 6e 20 61 6e 79 20 6d 6f 75 |loses on any mou| 00000820 73 65 20 61 63 63 65 73 73 0a 6f 75 74 73 69 64 |se access.outsid| 00000830 65 20 69 74 2e 20 49 66 20 74 68 65 72 65 20 61 |e it. If there a| 00000840 72 65 20 6d 6f 72 65 20 74 68 61 6e 20 66 69 76 |re more than fiv| 00000850 65 20 50 43 41 73 20 61 76 61 69 6c 61 62 6c 65 |e PCAs available| 00000860 20 74 68 65 20 70 6f 70 75 70 20 64 69 61 6c 6f | the popup dialo| 00000870 67 75 65 0a 73 68 6f 75 6c 64 20 62 65 20 67 69 |gue.should be gi| 00000880 76 65 6e 20 61 20 76 65 72 74 69 63 61 6c 20 73 |ven a vertical s| 00000890 63 72 6f 6c 6c 62 61 72 20 61 6e 64 20 74 68 65 |crollbar and the| 000008a0 20 69 6e 69 74 69 61 6c 20 73 69 7a 65 20 6c 69 | initial size li| 000008b0 6d 69 74 65 64 20 74 6f 20 66 69 76 65 0a 69 74 |mited to five.it| 000008c0 65 6d 73 2e 20 46 6f 72 20 61 20 6d 6f 72 65 20 |ems. For a more | 000008d0 64 65 74 61 69 6c 65 64 20 65 78 61 6d 70 6c 65 |detailed example| 000008e0 2c 20 73 65 65 20 74 68 65 20 50 43 41 20 76 65 |, see the PCA ve| 000008f0 72 73 69 6f 6e 20 6f 66 20 43 6f 6d 70 6f 73 69 |rsion of Composi| 00000900 74 69 6f 6e 20 6f 72 0a 74 68 65 20 64 69 61 6c |tion or.the dial| 00000910 6f 67 75 65 20 63 72 65 61 74 69 6f 6e 20 61 6e |ogue creation an| 00000920 64 20 72 65 64 72 61 77 20 63 6f 64 65 20 69 6e |d redraw code in| 00000930 20 21 53 70 61 69 6e 74 2e 20 0a 0a 4f 74 68 65 | !Spaint. ..Othe| 00000940 72 20 6f 70 74 69 6f 6e 73 20 0a 0a 53 65 76 65 |r options ..Seve| 00000950 72 61 6c 20 6f 74 68 65 72 20 6f 70 74 69 6f 6e |ral other option| 00000960 73 20 6d 61 79 20 62 65 20 6f 66 66 65 72 65 64 |s may be offered| 00000970 20 74 6f 20 74 68 65 20 75 73 65 72 20 62 79 20 | to the user by | 00000980 61 20 4c 6f 63 61 6c 20 74 61 73 6b 2e 20 57 68 |a Local task. Wh| 00000990 69 63 68 20 61 72 65 0a 70 72 61 63 74 69 63 61 |ich are.practica| 000009a0 6c 20 64 65 70 65 6e 64 73 20 6f 6e 20 74 68 65 |l depends on the| 000009b0 20 61 70 70 6c 69 63 61 74 69 6f 6e 20 69 6e 20 | application in | 000009c0 71 75 65 73 74 69 6f 6e 20 62 75 74 20 74 68 65 |question but the| 000009d0 20 66 6f 6c 6c 6f 77 69 6e 67 20 6d 61 79 20 62 | following may b| 000009e0 65 0a 61 70 70 72 6f 70 72 69 61 74 65 20 66 6f |e.appropriate fo| 000009f0 72 20 61 20 74 61 73 6b 20 77 68 69 63 68 20 73 |r a task which s| 00000a00 75 70 70 6f 72 74 73 20 62 6f 74 68 20 73 69 64 |upports both sid| 00000a10 65 73 20 6f 66 20 74 68 65 20 70 72 6f 74 6f 63 |es of the protoc| 00000a20 6f 6c 3a 0a 0a 54 68 65 20 64 69 73 70 6c 61 79 |ol:..The display| 00000a30 20 72 61 64 69 6f 20 62 75 74 74 6f 6e 73 20 61 | radio buttons a| 00000a40 6c 6c 6f 77 20 74 68 65 20 75 73 65 72 20 74 6f |llow the user to| 00000a50 20 63 68 6f 6f 73 65 20 74 68 65 20 66 6f 72 6d | choose the form| 00000a60 20 6f 66 20 70 6f 70 75 70 20 77 68 69 63 68 0a | of popup which.| 00000a70 77 69 6c 6c 20 62 65 20 70 72 65 73 65 6e 74 65 |will be presente| 00000a80 64 20 74 6f 20 74 68 65 20 75 73 65 72 2e 20 4d |d to the user. M| 00000a90 65 6e 75 73 20 61 72 65 20 73 69 6d 70 6c 65 72 |enus are simpler| 00000aa0 20 61 6e 64 20 74 61 6b 65 20 75 70 20 6c 65 73 | and take up les| 00000ab0 73 20 64 65 73 6b 74 6f 70 0a 73 70 61 63 65 2e |s desktop.space.| 00000ac0 20 44 69 61 6c 6f 67 75 65 20 62 6f 78 65 73 20 | Dialogue boxes | 00000ad0 6c 6f 6f 6b 20 62 65 74 74 65 72 20 61 6e 64 20 |look better and | 00000ae0 70 72 6f 76 69 64 65 20 6d 6f 72 65 20 69 6e 66 |provide more inf| 00000af0 6f 72 6d 61 74 69 6f 6e 2e 0a 0a 54 68 65 20 49 |ormation...The I| 00000b00 6e 2d 70 6c 61 63 65 20 65 64 69 74 69 6e 67 20 |n-place editing | 00000b10 6f 70 74 69 6f 6e 20 73 68 6f 75 6c 64 20 62 65 |option should be| 00000b20 20 70 72 6f 76 69 64 65 64 20 62 79 20 61 20 52 | provided by a R| 00000b30 65 6d 6f 74 65 20 74 61 73 6b 2e 20 49 66 20 6e |emote task. If n| 00000b40 6f 0a 6f 62 6a 65 63 74 73 20 61 72 65 20 62 65 |o.objects are be| 00000b50 69 6e 67 20 65 64 69 74 65 64 20 74 68 65 6e 20 |ing edited then | 00000b60 74 6f 67 67 6c 69 6e 67 20 74 68 69 73 20 6f 70 |toggling this op| 00000b70 74 69 6f 6e 20 73 69 6d 70 6c 79 20 70 72 65 76 |tion simply prev| 00000b80 65 6e 74 73 20 6f 72 20 61 6c 6c 6f 77 73 0a 62 |ents or allows.b| 00000b90 69 74 20 34 20 6f 66 20 74 68 65 20 66 6c 61 67 |it 4 of the flag| 00000ba0 73 20 77 6f 72 64 20 74 6f 20 62 65 20 73 65 74 |s word to be set| 00000bb0 20 69 6e 20 73 75 62 73 65 71 75 65 6e 74 20 20 | in subsequent | 00000bc0 4d 65 73 73 61 67 65 5f 49 6d 48 65 72 65 20 6d |Message_ImHere m| 00000bd0 65 73 73 61 67 65 73 0a 67 65 6e 65 72 61 74 65 |essages.generate| 00000be0 64 2e 20 49 66 20 61 6e 20 6f 62 6a 65 63 74 20 |d. If an object | 00000bf0 69 73 20 62 65 69 6e 67 20 65 64 69 74 65 64 20 |is being edited | 00000c00 69 6e 2d 70 6c 61 63 65 20 77 68 65 6e 20 74 68 |in-place when th| 00000c10 69 73 20 6f 70 74 69 6f 6e 20 69 73 20 74 6f 67 |is option is tog| 00000c20 67 6c 65 64 0a 74 68 65 20 52 65 6d 6f 74 65 20 |gled.the Remote | 00000c30 74 61 73 6b 20 73 68 6f 75 6c 64 20 73 77 69 74 |task should swit| 00000c40 63 68 20 62 65 74 77 65 65 6e 20 69 6e 2d 70 6c |ch between in-pl| 00000c50 61 63 65 20 61 6e 64 20 72 65 6d 6f 74 65 20 6f |ace and remote o| 00000c60 70 65 72 61 74 69 6f 6e 20 6f 6e 20 74 68 61 74 |peration on that| 00000c70 0a 6f 62 6a 65 63 74 20 61 73 20 74 68 65 20 6f |.object as the o| 00000c80 70 74 69 6f 6e 20 69 73 20 74 6f 67 67 6c 65 64 |ption is toggled| 00000c90 2e 0a 0a 54 68 65 20 27 46 6f 6c 6c 6f 77 20 73 |...The 'Follow s| 00000ca0 65 6c 65 63 74 65 64 27 20 6f 70 74 69 6f 6e 20 |elected' option | 00000cb0 69 73 20 70 72 6f 76 69 64 65 64 20 62 79 20 61 |is provided by a| 00000cc0 20 4c 6f 63 61 6c 20 74 61 73 6b 20 61 6e 64 2c | Local task and,| 00000cd0 20 77 68 65 6e 20 6f 6e 2c 20 74 68 65 0a 6c 61 | when on, the.la| 00000ce0 73 74 20 74 61 73 6b 20 73 65 6e 74 20 61 20 20 |st task sent a | 00000cf0 4d 65 73 73 61 67 65 5f 44 6f 59 6f 75 72 53 74 |Message_DoYourSt| 00000d00 75 66 66 20 69 73 20 61 75 74 6f 6d 61 74 69 63 |uff is automatic| 00000d10 61 6c 6c 79 20 73 65 6e 74 20 61 20 6e 65 77 0a |ally sent a new.| 00000d20 4d 65 73 73 61 67 65 5f 44 6f 59 6f 75 72 53 74 |Message_DoYourSt| 00000d30 75 66 66 20 65 76 65 72 79 20 74 69 6d 65 20 74 |uff every time t| 00000d40 68 65 20 27 73 65 6c 65 63 74 65 64 20 6f 62 6a |he 'selected obj| 00000d50 65 63 74 27 20 63 68 61 6e 67 65 73 2e 20 4f 62 |ect' changes. Ob| 00000d60 76 69 6f 75 73 6c 79 20 74 68 69 73 0a 6f 70 74 |viously this.opt| 00000d70 69 6f 6e 20 6f 6e 6c 79 20 68 61 73 20 76 61 6c |ion only has val| 00000d80 69 64 69 74 79 20 77 68 65 6e 20 74 68 65 72 65 |idity when there| 00000d90 20 69 73 20 61 20 63 6f 6e 63 65 70 74 20 6f 66 | is a concept of| 00000da0 20 74 68 65 20 27 73 65 6c 65 63 74 65 64 20 6f | the 'selected o| 00000db0 62 6a 65 63 74 27 2e |bject'.| 00000db7
.