Documentation: Wimp_Initialise
Programmer’s Reference Manuals
» Part 7 – The Desktop
» The Window Manager
» SWI Calls
» Wimp_Initialise
Wimp_Initialise
(SWI &400C0)
| Entry | |
|---|---|
| R0 | Wimp Version x 100 |
| R1 | “TASK” (&4B534154) |
| R2 | Pointer to description to display in Task Manager |
| R3 | Pointer to list of acceptable User Messages |
| Exit | |
|---|---|
| R0 | Current Wimp version x 100 |
| R1 | Task handle |
Use
The purpose of this call is to register a task with the Wimp.
Notes
This call should only be used once when starting up. And before a task closes, it should call Wimp_CloseDown.
R3 stores the list of user message numbers that are acceptable. This is terminated by a 0 word, unless the value in R3 is less than 300.
A value of 0 in R3 means that no messages are classified as important except for the ‘Quit’ message.
When a list of user messages is supplied via R3, the task will not be polled in for other messages. This results in a more responsive system.
The task can add or delete messages that it can respond to by Wimp_AddMessages and Wimp_RemoveMessages.
