RISC OS Open
A fast and easily customised operating system for ARM devices
ROOL
Home | News | Software | Bugs | Bounties | Forum | Documents | Photos | Contact us
Account

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.

See also

  • User Messages?
  • Wimp_AddMessages
  • Wimp_CloseDown
  • Wimp_Poll
  • Wimp_RemoveMessages
Created on June 7, 2009 15:20:11 by Alan Robertson (52)? (127.0.0.1)
Edit | Views: Print | Source | Linked from: The Window Manager SWI Calls, The Window Manager Relocatable Modules, Service_Memory, Service_StartWimp, Service_WimpCloseDown, Wimp_CloseDown, Wimp_CommandWindow, Wimp Items, Wimp_StartTask, Message_TaskInitialise, TaskManager_TaskNameFromHandle, Service_StartFiler

Search the Wiki

Commercial use

For commercial enquiries, please contact the owners of RISC OS, Castle Technology Ltd.

ROOL Store

The official C/C++ Development kit and more here.

Donate! Why?

Help ROOL make things happen – please consider donating!

Navigation

  • Home Page
  • All Pages
  • Recently Revised
  • Authors
  • Feeds
Site design © RISC OS Open Limited 2011 except where indicated
The RISC OS Open Instiki theme is based on Insitki's default layout

Valid XHTML 1.0  |  Valid CSS

Instiki 0.19.1(MML+)
This site runs on Rails

Hosted by Arachsys