A fast and easily customised operating system
for ARM devices
User_Message
Programmer's Reference Manuals
» Part 7 - The Desktop
» The Window Manager
» SWI Calls
» Wimp_Poll
» Reason Codes
» User_Message
User_Message
(Reason Code 17)
| Exit | |
|---|---|
| Block | |
| +0 | Length of block |
| +4 | Handle of sender |
| +8 | My ref (senders reference number for this message) |
| +12 | 0 |
| +16 | Message Code |
| +20 | … data… |
Use
This code is returned from Wimp_Poll and indicates that another task has broadcast a message to any of the following:
- this specific task
- a specific window belonging to this task
- to all tasks
Notes
The message code determines the meaning of the message sent.
No acknowledgement of receiving this message is required by the message sender.
The number of message codes is very large, and not every code needs to be supported, however, every task must take action when receiving Message_Quit. This code is broadcast when a task is asked to quit via the Task Display window (via Task Manager).
A task that does not understand a message code should simply ignore it. Tasks should not respond to messages for no reason.