Wimp_ReportError (changes)
Showing changes from revision #1 to #2:
Added | Removed | Changed
Programmer's WindowManager Reference Manuals
» Part 7 - The Desktop?SWI Calls
» Wimp_ReportErrorThe Window Manager
» SWI Calls?
» Wimp_ReportError
Wimp_ReportError
(SWI &400DF)
| Entry | |
|---|---|
| R0 | Pointer to standard SWI Error Block |
| R1 | ReportError Flags |
| R2 | Pointer to title text (if R1 bit 4 is set), or |
| Pointer to application name (if R1 bit 4 is not set), or | |
| 0 for basic error box title | |
| R3 | Sprite name (if bit 8 is set) |
| R4 | |
| R5 | Pointer to string containing list of user specific button names (comma delimited) |
| Exit | |
|---|---|
| R0 | Corrupt |
| R1 | 0 = No selection |
| 1 = OK | |
| 2 = Cancel | |
| 3 = Extra Button | |
| 4 = Extra Button | |
| 5 = Extra Button |
Use
The purpose of this call is to display an error box to the user.
Notes
The use of this call should be avoided where possible, due to the non-multitasking nature of these error boxes.
Application specific buttons can be displayed in an error box, by having a list of button names, separated by commas in R5.
The total size for all the user specific button names is 256 characters.
No more than 8 buttons can be displayed in an error box.
A user pressing Return will have the same effect as clicking on the default button.
Pressing Escape is the same as choosing the default cancel option on the error box.
The SWI error block must be zero terminated.
See also
- SWI Error Block
- ReportError Flags
Sprite Area?Sprite Area
Social
Follow us on
and
and
ROOL Store
Buy RISC OS Open merchandise here, including SD cards for Raspberry Pi and more.