Service_TaskManagerAcknowledgements
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 Code to call with text information: | |
| Entry | |
| R0 = Priority (usually &1000) | |
| R1 = Module title,0 | |
| R2 = Licence text or other message,0 | |
| 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.
Note that this API does not define a Workspace pointer for the Code, so the caller will probably require a veneer, sadly.
The text provided to the Code will not necessarily 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 |
(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.