A fast and easily customised operating system
for ARM devices
Page "Tests:Hierarchy" does not exist. Please create it now, or hit the "back" button in your browser.
Wimp_UpdateWindow
Programmer's Reference Manuals
» Part 7 - The Desktop
» The Window Manager
» SWI Calls
» Wimp_UpdateWindow
Wimp_UpdateWindow
(SWI &400C9)
| Entry | |
|---|---|
| R1 | Pointer to block |
| Block | |
| +0 | Window handle |
| +4 | Work area rectangle minimum x (inclusive) |
| +8 | Work area rectangle minimum y (inclusive) |
| +12 | Work area rectangle maximum x (exclusive) |
| +16 | Work area rectangle maximum 7 (exclusive) |
| Exit | |
|---|---|
| R0 | Corrupt |
Use
The purpose of this call is to redraw the parts of a window that needs updating.
Notes
This call is similar to Wimp_GetRectangle, but with some important differences.
- Not all of the window has to be updated, only the specified rectangular area.
- Invalid rectangles are not cleared by the Wimp after redrawing using this call.
- Wimp_UpdateWindow can be called at anytime – not just in response to a Redraw_Window_Request.
This call exits via Wimp_GetRectangle, which specifies the co-ordinates of the rectangular parts needing updating (one at a time).
An of how to use this call is shown in pseudo code form below:
SYS"Wimp_UpdateWindow",,blk TO rectangles WHILE rectangles update the contents of the returned rectangle SYS"Wimp_GetRectangle",,blk TO rectangles ENDWHILE