<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<title>at-spi-idl: Accessibility::LoginHelper Interface Reference</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<link href="doxygen.css" rel="stylesheet" type="text/css"/>
</head>
<body>
<!-- Generated by Doxygen 1.7.1 -->
<div class="navigation" id="top">
<div class="tabs">
<ul class="tablist">
<li><a href="index.html"><span>Main Page</span></a></li>
<li><a href="namespaces.html"><span>Namespaces</span></a></li>
<li class="current"><a href="annotated.html"><span>Data Structures</span></a></li>
<li><a href="files.html"><span>Files</span></a></li>
<li><a href="dirs.html"><span>Directories</span></a></li>
</ul>
</div>
<div class="tabs2">
<ul class="tablist">
<li><a href="annotated.html"><span>Data Structures</span></a></li>
<li><a href="hierarchy.html"><span>Class Hierarchy</span></a></li>
<li><a href="functions.html"><span>Data Fields</span></a></li>
</ul>
</div>
<div class="navpath">
<ul>
<li><a class="el" href="namespaceAccessibility.html">Accessibility</a> </li>
<li><a class="el" href="interfaceAccessibility_1_1LoginHelper.html">Accessibility::LoginHelper</a> </li>
</ul>
</div>
</div>
<div class="header">
<div class="summary">
<a href="#nested-classes">Data Structures</a> |
<a href="#pub-types">Public Types</a> |
<a href="#pub-methods">Public Member Functions</a> </div>
<div class="headertitle">
<h1>Accessibility::LoginHelper Interface Reference</h1> </div>
</div>
<div class="contents">
<!-- doxytag: class="Accessibility::LoginHelper" -->
<p>An interface for use by assistive technologies by which they can access system information and services on a 'need to know' basis while the screen is locked, during user authentication, or during other sensitive operations.
<a href="#_details">More...</a></p>
<p><code>import "<a class="el" href="Accessibility__LoginHelper_8idl_source.html">Accessibility_LoginHelper.idl</a>";</code></p>
<table class="memberdecls">
<tr><td colspan="2"><h2><a name="nested-classes"></a>
Data Structures</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">struct </td><td class="memItemRight" valign="bottom"><a class="el" href="structAccessibility_1_1LoginHelper_1_1WindowInfo.html">WindowInfo</a></td></tr>
<tr><td colspan="2"><h2><a name="pub-types"></a>
Public Types</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">enum </td><td class="memItemRight" valign="bottom"><a class="el" href="interfaceAccessibility_1_1LoginHelper.html#a96c54815de99ea5d719e16903124d6f9">DeviceReq</a> { <br/>
<a class="el" href="interfaceAccessibility_1_1LoginHelper.html#a96c54815de99ea5d719e16903124d6f9ae96f817f93565ea439b785c1362c2cfe">GUI_EVENTS</a>,
<a class="el" href="interfaceAccessibility_1_1LoginHelper.html#a96c54815de99ea5d719e16903124d6f9ab97aebd5e1eb8b00b0278c254e019264">CORE_KEYBOARD</a>,
<a class="el" href="interfaceAccessibility_1_1LoginHelper.html#a96c54815de99ea5d719e16903124d6f9ac17a0b801fb8b0a48672fad3e197b1ba">CORE_POINTER</a>,
<a class="el" href="interfaceAccessibility_1_1LoginHelper.html#a96c54815de99ea5d719e16903124d6f9a8ac05bc85a66981e56829245d76f25ad">EXT_INPUT</a>,
<br/>
<a class="el" href="interfaceAccessibility_1_1LoginHelper.html#a96c54815de99ea5d719e16903124d6f9a398b25b638d1d996100fdb066ceb52ab">POST_WINDOWS</a>,
<a class="el" href="interfaceAccessibility_1_1LoginHelper.html#a96c54815de99ea5d719e16903124d6f9ab43bfa0d3328413ad27b1057efbb92a0">AUDIO_OUT</a>,
<a class="el" href="interfaceAccessibility_1_1LoginHelper.html#a96c54815de99ea5d719e16903124d6f9a6ff16907677268b5df99b712c70edf5b">AUDIO_IN</a>,
<a class="el" href="interfaceAccessibility_1_1LoginHelper.html#a96c54815de99ea5d719e16903124d6f9a26e8349447009fc4b4baefbcff168d6d">NETWORK</a>,
<br/>
<a class="el" href="interfaceAccessibility_1_1LoginHelper.html#a96c54815de99ea5d719e16903124d6f9a63cdcd9ff6250053b8250c67dfd5cc07">LOCALHOST</a>,
<a class="el" href="interfaceAccessibility_1_1LoginHelper.html#a96c54815de99ea5d719e16903124d6f9a4db81f527e2238730f1c1b2a80122589">SERIAL_OUT</a>,
<a class="el" href="interfaceAccessibility_1_1LoginHelper.html#a96c54815de99ea5d719e16903124d6f9a3fef699a96461b99a15c6ae1711ce49d">SERIAL_IN</a>
<br/>
}</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">typedef sequence< <a class="el" href="structAccessibility_1_1LoginHelper_1_1WindowInfo.html">WindowInfo</a> > </td><td class="memItemRight" valign="bottom"><a class="el" href="interfaceAccessibility_1_1LoginHelper.html#ac61afe2b489437473868a80ac6e8d89f">WindowList</a></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">typedef sequence< <a class="el" href="interfaceAccessibility_1_1LoginHelper.html#a96c54815de99ea5d719e16903124d6f9">DeviceReq</a> > </td><td class="memItemRight" valign="bottom"><a class="el" href="interfaceAccessibility_1_1LoginHelper.html#a45840eff7599173fecd762ce95771f00">DeviceReqList</a></td></tr>
<tr><td colspan="2"><h2><a name="pub-methods"></a>
Public Member Functions</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">boolean </td><td class="memItemRight" valign="bottom"><a class="el" href="interfaceAccessibility_1_1LoginHelper.html#a895b1ad1c9bd21ab25d0d10b8ac60b7b">setSafe</a> (in boolean safe_mode)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="interfaceAccessibility_1_1LoginHelper.html#a45840eff7599173fecd762ce95771f00">DeviceReqList</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="interfaceAccessibility_1_1LoginHelper.html#ad32e9a5c54fb815db24bb46f854cf5ff">getDeviceReqs</a> ()</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="interfaceAccessibility_1_1LoginHelper.html#ac61afe2b489437473868a80ac6e8d89f">WindowList</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="interfaceAccessibility_1_1LoginHelper.html#a5b98b4e00cb612ebf190115252b9e472">getRaiseWindows</a> ()</td></tr>
</table>
<hr/><a name="_details"></a><h2>Detailed Description</h2>
<p>An interface for use by assistive technologies by which they can access system information and services on a 'need to know' basis while the screen is locked, during user authentication, or during other sensitive operations. </p>
<p>This interface is intended for use by assistive technologies and related user-enabling services, and by applications and utilities which may wish to restrict access to certain system devices and services during security-sensitive states, e.g. when the screen is locked or during authentication into some secure service.</p>
<p>Such 'applications' (for instance, screen lock dialogs and security-enabled web browsers) use the LoginHelper client interfaces, and the bonobo-activation query service, to query for assistive technologies which advertise the LoginHelper service. The client then queries these assistive technologies for their device I/O requirements, via the getDeviceReqs call. The client may then issue the advisory request setSafe (TRUE), which requests that the LoginHelper -implementing service make a best-effort attempt to make itself more secure (for instance, an onscreen keyboard might turn off word prediction, and a screenreader may turn off keyboard echo via speech). The return value of setSafe is an advisory indication of whether this attempt was successful (no specific guarantees are implied). Once the 'security sensitive' state is exited, the client should call setSafe (FALSE).</p>
<p>The return values from getDeviceReqs inform the client of which services the LoginHelper service (e. g. assistive technology) needs in order to do its job. The client may use this information to loosen any restrictions on access which it may currently have in place (for instance, keyboard grabs, etc.). If it does not do so, the likely outcome is that the end-user will experience loss of access to the system. </p>
<hr/><h2>Member Typedef Documentation</h2>
<a class="anchor" id="a45840eff7599173fecd762ce95771f00"></a><!-- doxytag: member="Accessibility::LoginHelper::DeviceReqList" ref="a45840eff7599173fecd762ce95771f00" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">typedef sequence<<a class="el" href="interfaceAccessibility_1_1LoginHelper.html#a96c54815de99ea5d719e16903124d6f9">DeviceReq</a>> <a class="el" href="interfaceAccessibility_1_1LoginHelper.html#a45840eff7599173fecd762ce95771f00">Accessibility::LoginHelper::DeviceReqList</a></td>
</tr>
</table>
</div>
<div class="memdoc">
</div>
</div>
<a class="anchor" id="ac61afe2b489437473868a80ac6e8d89f"></a><!-- doxytag: member="Accessibility::LoginHelper::WindowList" ref="ac61afe2b489437473868a80ac6e8d89f" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">typedef sequence<<a class="el" href="structAccessibility_1_1LoginHelper_1_1WindowInfo.html">WindowInfo</a>> <a class="el" href="interfaceAccessibility_1_1LoginHelper.html#ac61afe2b489437473868a80ac6e8d89f">Accessibility::LoginHelper::WindowList</a></td>
</tr>
</table>
</div>
<div class="memdoc">
</div>
</div>
<hr/><h2>Member Enumeration Documentation</h2>
<a class="anchor" id="a96c54815de99ea5d719e16903124d6f9"></a><!-- doxytag: member="Accessibility::LoginHelper::DeviceReq" ref="a96c54815de99ea5d719e16903124d6f9" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">enum <a class="el" href="interfaceAccessibility_1_1LoginHelper.html#a96c54815de99ea5d719e16903124d6f9">Accessibility::LoginHelper::DeviceReq</a></td>
</tr>
</table>
</div>
<div class="memdoc">
<dl><dt><b>Enumerator: </b></dt><dd><table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"><em><a class="anchor" id="a96c54815de99ea5d719e16903124d6f9ae96f817f93565ea439b785c1362c2cfe"></a><!-- doxytag: member="GUI_EVENTS" ref="a96c54815de99ea5d719e16903124d6f9ae96f817f93565ea439b785c1362c2cfe" args="" -->GUI_EVENTS</em> </td><td>
<p>: Needs access to the GUI event subsystem (e.g. Xserver) </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="a96c54815de99ea5d719e16903124d6f9ab97aebd5e1eb8b00b0278c254e019264"></a><!-- doxytag: member="CORE_KEYBOARD" ref="a96c54815de99ea5d719e16903124d6f9ab97aebd5e1eb8b00b0278c254e019264" args="" -->CORE_KEYBOARD</em> </td><td>
<p>: Needs access to the system keyboard events (read and write) </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="a96c54815de99ea5d719e16903124d6f9ac17a0b801fb8b0a48672fad3e197b1ba"></a><!-- doxytag: member="CORE_POINTER" ref="a96c54815de99ea5d719e16903124d6f9ac17a0b801fb8b0a48672fad3e197b1ba" args="" -->CORE_POINTER</em> </td><td>
<p>: Needs access to the onscreen pointer (e.g. mouse pointer) </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="a96c54815de99ea5d719e16903124d6f9a8ac05bc85a66981e56829245d76f25ad"></a><!-- doxytag: member="EXT_INPUT" ref="a96c54815de99ea5d719e16903124d6f9a8ac05bc85a66981e56829245d76f25ad" args="" -->EXT_INPUT</em> </td><td>
<p>: Reads XInput extended input devices </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="a96c54815de99ea5d719e16903124d6f9a398b25b638d1d996100fdb066ceb52ab"></a><!-- doxytag: member="POST_WINDOWS" ref="a96c54815de99ea5d719e16903124d6f9a398b25b638d1d996100fdb066ceb52ab" args="" -->POST_WINDOWS</em> </td><td>
<p>: Posts Windows, and needs for toplevel windows to be visible </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="a96c54815de99ea5d719e16903124d6f9ab43bfa0d3328413ad27b1057efbb92a0"></a><!-- doxytag: member="AUDIO_OUT" ref="a96c54815de99ea5d719e16903124d6f9ab43bfa0d3328413ad27b1057efbb92a0" args="" -->AUDIO_OUT</em> </td><td>
<p>: Writes to audio device </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="a96c54815de99ea5d719e16903124d6f9a6ff16907677268b5df99b712c70edf5b"></a><!-- doxytag: member="AUDIO_IN" ref="a96c54815de99ea5d719e16903124d6f9a6ff16907677268b5df99b712c70edf5b" args="" -->AUDIO_IN</em> </td><td>
<p>: Reads from audio device </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="a96c54815de99ea5d719e16903124d6f9a26e8349447009fc4b4baefbcff168d6d"></a><!-- doxytag: member="NETWORK" ref="a96c54815de99ea5d719e16903124d6f9a26e8349447009fc4b4baefbcff168d6d" args="" -->NETWORK</em> </td><td>
<p>: Requires access to general network services, including remote access </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="a96c54815de99ea5d719e16903124d6f9a63cdcd9ff6250053b8250c67dfd5cc07"></a><!-- doxytag: member="LOCALHOST" ref="a96c54815de99ea5d719e16903124d6f9a63cdcd9ff6250053b8250c67dfd5cc07" args="" -->LOCALHOST</em> </td><td>
<p>: Requires network services hosted on LOCALHOST only </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="a96c54815de99ea5d719e16903124d6f9a4db81f527e2238730f1c1b2a80122589"></a><!-- doxytag: member="SERIAL_OUT" ref="a96c54815de99ea5d719e16903124d6f9a4db81f527e2238730f1c1b2a80122589" args="" -->SERIAL_OUT</em> </td><td>
<p>: Writes to a serial port </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="a96c54815de99ea5d719e16903124d6f9a3fef699a96461b99a15c6ae1711ce49d"></a><!-- doxytag: member="SERIAL_IN" ref="a96c54815de99ea5d719e16903124d6f9a3fef699a96461b99a15c6ae1711ce49d" args="" -->SERIAL_IN</em> </td><td>
<p>: Reads from a serial port </p>
</td></tr>
</table>
</dd>
</dl>
</div>
</div>
<hr/><h2>Member Function Documentation</h2>
<a class="anchor" id="ad32e9a5c54fb815db24bb46f854cf5ff"></a><!-- doxytag: member="Accessibility::LoginHelper::getDeviceReqs" ref="ad32e9a5c54fb815db24bb46f854cf5ff" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="interfaceAccessibility_1_1LoginHelper.html#a45840eff7599173fecd762ce95771f00">DeviceReqList</a> Accessibility::LoginHelper::getDeviceReqs </td>
<td>(</td>
<td class="paramname"></td>
<td> ) </td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>getDeviceReqs:</p>
<p>Query a LoginHelper for the types of device I/O it requires, in order to do its job. For instance, a LoginHelper which needs to receive keyboard events will include Accessibility_LoginHelper_CORE_KEYBOARD in this list.</p>
<dl class="return"><dt><b>Returns:</b></dt><dd>: A sequence of LoginHelper_DeviceReq indicating the device I/O required in order to facilitate end-user access to the system. </dd></dl>
</div>
</div>
<a class="anchor" id="a5b98b4e00cb612ebf190115252b9e472"></a><!-- doxytag: member="Accessibility::LoginHelper::getRaiseWindows" ref="a5b98b4e00cb612ebf190115252b9e472" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="interfaceAccessibility_1_1LoginHelper.html#ac61afe2b489437473868a80ac6e8d89f">WindowList</a> Accessibility::LoginHelper::getRaiseWindows </td>
<td>(</td>
<td class="paramname"></td>
<td> ) </td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>getRaiseWindows:</p>
<p>Get a list of window IDs that need raising on login.</p>
<dl class="return"><dt><b>Returns:</b></dt><dd>: a sequence containing window IDS for toplevels which need to be raised/made visible during user authentication, in order for the LoginHelper to facilitate end-user access to the system. </dd></dl>
</div>
</div>
<a class="anchor" id="a895b1ad1c9bd21ab25d0d10b8ac60b7b"></a><!-- doxytag: member="Accessibility::LoginHelper::setSafe" ref="a895b1ad1c9bd21ab25d0d10b8ac60b7b" args="(in boolean safe_mode)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">boolean Accessibility::LoginHelper::setSafe </td>
<td>(</td>
<td class="paramtype">in boolean </td>
<td class="paramname"> <em>safe_mode</em></td>
<td> ) </td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>setSafe: </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>safe_mode,:</em> </td><td><code>TRUE</code> if the client is requesting that 'safe mode' be initiated, <code>FALSE</code> if the client is advising that 'safe mode' may be exited, i.e. normal operation may be resumed.</td></tr>
</table>
</dd>
</dl>
<p>Request a <a class="el" href="interfaceAccessibility_1_1LoginHelper.html" title="An interface for use by assistive technologies by which they can access system information and servic...">LoginHelper</a> to enter "safe" mode, or inform <a class="el" href="interfaceAccessibility_1_1LoginHelper.html" title="An interface for use by assistive technologies by which they can access system information and servic...">LoginHelper</a> that "safe" mode may be exited. If <em>safe_mode</em> is <code>TRUE</code>, but the return value is <code>FALSE</code>, the requesting client may wish to deny services to the LoginHelper, for instance avoid raising its toplevels. The return value is purely advisory, and no guarantees are intended about what the implementing <a class="el" href="interfaceAccessibility_1_1LoginHelper.html" title="An interface for use by assistive technologies by which they can access system information and servic...">LoginHelper</a> will do to improve security when in "safe" mode.</p>
<dl class="return"><dt><b>Returns:</b></dt><dd>: whether the LoginHelper is now "safe" or not. </dd></dl>
</div>
</div>
<hr/>The documentation for this interface was generated from the following file:<ul>
<li>/home/liyuan/src/at-spi/idl/<a class="el" href="Accessibility__LoginHelper_8idl_source.html">Accessibility_LoginHelper.idl</a></li>
</ul>
</div>
<hr class="footer"/><address class="footer"><small>Generated on Mon Sep 27 2010 16:50:43 for at-spi-idl by
<a href="http://www.doxygen.org/index.html">
<img class="footer" src="doxygen.png" alt="doxygen"/></a> 1.7.1 </small></address>
</body>
</html>
