Service_TaskManagerAcknowledgements (changes)
Showing changes from revision #1 to #2:
Added | Removed | Changed
Programmer's Reference Manuals
» Service Calls
» Service_TaskManagerAcknowledgements
Service_TaskManagerAcknowledgements
(Service &42680)
Also known as Service_GetCredits.
| Entry | |
|---|---|
| R1 | &42680 |
| R2 | 0 to inform of a change |
| otherwise ptr to |
|
| Entry | |
| R0 = Priority (usually &1000) | |
| R1 = Module |
|
| R2 = Licence text or other |
|
| Exit | |
| all preserved |
| Exit | |
|---|---|
| R1 | Preserve (if claimed, nothing will be displayed) |
| R2 | Preserve |
Use
This service allows modules to provide licence information, copyright or other messages. It is used by the TaskManager in RO4/6 to compile the text displayed when the Information button is pressed in the OS version window.
On Note initialisation or finalisation, a module that responds to this service must call it with R2=0 to tell TaskManager or other interested parties to discard their cached text.API does not define a Workspace pointer for the Code, so the caller will probably require a veneer, sadly.
The priority text is provided used to sort the messages Code before will display. not Example necessarily priorities: persist afterwards, so must be copied by the Code.
As the caller may cache the results, modules that respond to this service must issue it with R2=0 on initialisation/finalisation to tell interested parties to discard their cached text.
The priority is used to sort the messages before display, low to high. Messages of the same priority are sorted in reverse chronological order. Example priorities:
| 0 | OS modules |
| &1000 | SpriteExtend |
| &2000 | AppleTalk |
| &5000 | CDFSSoftATAPI |
| 1<<20 | nemo’s ModCredits module |
Messages of the same priority are sorted in reverse chronological order.
(The ModCredits module adds all the Module copyright strings to the collected information)
See also
Social
and
ROOL Store
Buy RISC OS Open merchandise here, including SD cards for Raspberry Pi and more.