/usr/share/doc/sludge/SLUDGEDevKitHelp/onFocusChange.html is in sludge-doc 2.2.1-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 | <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
<html>
<head>
<TITLE>onFocusChange</TITLE>
<link rel="stylesheet" type="text/css" href="style.css" />
</head>
<BODY>
<HR>
<div align="center"><img id="headerGraphic" src="images/sludge300.png" alt="SLUDGE"/></div>
<h2>onFocusChange</h2>
<HR>
<H3>Syntax:</H3>
<P>
<pre class="syntax">onFocusChange (<i>handlerFunction</i>);</pre>
</P>
<P>
<pre class="syntax">onFocusChange ();</pre>
</P>
<H3>Purpose:</H3>
<P>
Tells the computer which function to call when the mouse cursor moves from one area of the screen to another (screen regions, characters and nothing). The value of <i>handlerFunction</i> must be a pointer to a function which takes one parameters. The function will be called every time the area at which the mouse is pointing changes until another call to onFocusChange. The object type at which the mouse is pointing - or NULL if the mouse is pointing at nothing - will be passed into the <i>handlerFunction</i> when it is called. This parameter will be the same as the return value from the <a href="getOverObject.html">getOverObject</a> function.
</P>
<P>
If no parameter is given, the program stops calling the current focus change function. No function will be called when the mouse moves from one area of the screen to another until another call to onFocusChange tells it otherwise.
</P>
<P>
Note that only one handler for focus changes can be used at any one time. A subsequent call to onFocusChange will replace the current handler function.
</P>
<H3>Return value:</H3>
<P>
No return value.
</P>
<H3>See also:</H3>
<P>
<a href="Passing_Functions_as_Variables.html">Passing Functions as Variables</a>
</P>
<P>
<a href="onKeyboard.html">onKeyboard</a>
</P>
<P>
<a href="onLeftMouse.html">onLeftMouse</a>
</P>
<P>
<a href="onLeftMouseUp.html">onLeftMouseUp</a>
</P>
<P>
<a href="onMoveMouse.html">onMoveMouse</a>
</P>
<P>
<a href="onRightMouse.html">onRightMouse</a>
</P>
<P>
<a href="onRightMouseUp.html">onRightMouseUp</a>
</P>
<P class="copyright-notice">SLUDGE and this SLUDGE documentation are <A HREF="Copyright.html">copyright</A> Hungry Software and contributors 2000-2012
</P>
<HR>
</BODY>
</html>
|