AcornSearch - Acorn and RISC OS information searching
RISC OS Search
containing
"Nutty quip goes here!"
Home  |  About  |  Filebase Archive  |  StrongHelp Manuals  |  Newsgroups  |  Module Database
WimpExtension provides a couple of SWIs and a validation command to make
providing multitasking help easier. The validation command is:

'wh' (help)
Syntax:
wh<message>

When the pointer is over the icon, Acorn's Help application would display the
message specified.

If you set bit 5 of R2 when you called WimpExt_Initialise, specifying
'semi-automatic' help then instead of sending the message to Help for you,
WimpExtension will instead give YOU a message, &45783, giving you the
suggested help string. This feature was suggested by Peter Greenham, so that
help strings can be converted via MsgTrans. The message format is as
follows:
R1+0     40
R1+16     &45783
R1+20     Mouse X
R1+24     Mouse Y
R1+28     Button state
R1+32     Window handle (-1 for background, -2 for icon bar, -3 for requester window)
R1+36     Icon handle
R1+40     Suggested text

You may notice that this is the same as message &502, with the message number
changed and the suggested text tagged on the end. To send this on unchanged,
you would use:
SYS "WimpExt_SendHelp",q%+40,q%

Related SWIs: WimpExt_SendHelpWimpExt_SendWimpHelp.

[sh-index] Back to list of manuals