Wimp_UpdateWindow (changes)

Showing changes from revision #5 to #6: Added | Removed | Changed

WindowManager

» SWI Calls

» Wimp_UpdateWindow

Wimp_UpdateWindow

(SWI &400C9)

Use

The purpose of this call is to redraw the parts of a window that needs updating.

Notes

“Work area rectangle” means the area you wish to redraw given in user co-ordinates.

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 example 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

See also

• Redraw_Window_Request
• Wimp_GetRectangle
• Wimp_RedrawWindow