<!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::Event Struct 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="structAccessibility_1_1Event.html">Accessibility::Event</a> </li>
</ul>
</div>
</div>
<div class="header">
<div class="summary">
<a href="#pub-attribs">Data Fields</a> </div>
<div class="headertitle">
<h1>Accessibility::Event Struct Reference</h1> </div>
</div>
<div class="contents">
<!-- doxytag: class="Accessibility::Event" -->
<p><code>import "<a class="el" href="Accessibility__Event_8idl_source.html">Accessibility_Event.idl</a>";</code></p>
<table class="memberdecls">
<tr><td colspan="2"><h2><a name="pub-attribs"></a>
Data Fields</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">string </td><td class="memItemRight" valign="bottom"><a class="el" href="structAccessibility_1_1Event.html#add8793ed6ba9e3da7edb62e8b9ff291d">type</a></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="interfaceAccessibility_1_1Accessible.html">Accessible</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="structAccessibility_1_1Event.html#ace0e5a1515bbead9835cd1e2d67197f8">source</a></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">long </td><td class="memItemRight" valign="bottom"><a class="el" href="structAccessibility_1_1Event.html#a5d00a887725f56942984809dd1d867ad">detail1</a></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">long </td><td class="memItemRight" valign="bottom"><a class="el" href="structAccessibility_1_1Event.html#a2780595084742aa316bfe8e07be7c5a0">detail2</a></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">any </td><td class="memItemRight" valign="bottom"><a class="el" href="structAccessibility_1_1Event.html#aae26223efe095483514bd121c365c128">any_data</a></td></tr>
</table>
<hr/><a name="_details"></a><h2>Detailed Description</h2>
<p>A structure encapsulating information about an event for which notification was requested. Usually such notification is requested via a call to <a class="el" href="interfaceAccessibility_1_1Registry.html#adbb76f310f6cbeb67a56b5b5f54cc438">Registry::registerGlobalEventListener</a>. The structure contains a colon-delimited string indicating the event type, a reference to the generating <a class="el" href="interfaceAccessibility_1_1Accessible.html">Accessible</a>, two detail fields whose interpretation is event-type-specific, and a final field containing event-type-specific data.</p>
<dl class="note"><dt><b>Note:</b></dt><dd>Since AT-SPI 1.7.0 the 'any' field contains an <a class="el" href="structAccessibility_1_1EventDetails.html">EventDetails</a> struct, which encapsulates additional information about the event and its generating object. </dd></dl>
<hr/><h2>Field Documentation</h2>
<a class="anchor" id="aae26223efe095483514bd121c365c128"></a><!-- doxytag: member="Accessibility::Event::any_data" ref="aae26223efe095483514bd121c365c128" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">any <a class="el" href="structAccessibility_1_1Event.html#aae26223efe095483514bd121c365c128">Accessibility::Event::any_data</a></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>A generic storage location for event-type-specific data which provides more specific information about the event; for instance, in AT-SPI versions prior to 1.7.0, in the case of ¨object:text-changed:insert¨ events, this field contains a string indicating the inserted text.</p>
<dl class="note"><dt><b>Note:</b></dt><dd>Since AT-SPI 1.7.0, the data contained in this field is an <a class="el" href="structAccessibility_1_1EventDetails.html">EventDetails</a> struct. </dd></dl>
</div>
</div>
<a class="anchor" id="a5d00a887725f56942984809dd1d867ad"></a><!-- doxytag: member="Accessibility::Event::detail1" ref="a5d00a887725f56942984809dd1d867ad" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">long <a class="el" href="structAccessibility_1_1Event.html#a5d00a887725f56942984809dd1d867ad">Accessibility::Event::detail1</a></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>An integer whose meaning is event type dependent. It may indicate the offset of text being inserted, in the case of ¨object:text-changed:insert¨, or the index of a newly added child in the case of ¨object:children-changed:add¨. </p>
<dl class="note"><dt><b>Note:</b></dt><dd>since most AT-SPI clients react to events via an asynchronous queue, for performance reasons, this field may be of limited utility unless the client maintains a large client-side cache of the hierarchy and contained data. This is because by the time such an event is asynchronously processed, the state of the originating object may have changed. In other words, the data in the detail1 member is not state-coherent outside of the event handler. More useful results are gotten by examination of the 'any_data' field. </dd></dl>
</div>
</div>
<a class="anchor" id="a2780595084742aa316bfe8e07be7c5a0"></a><!-- doxytag: member="Accessibility::Event::detail2" ref="a2780595084742aa316bfe8e07be7c5a0" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">long <a class="el" href="structAccessibility_1_1Event.html#a2780595084742aa316bfe8e07be7c5a0">Accessibility::Event::detail2</a></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>see description of detail2 </p>
</div>
</div>
<a class="anchor" id="ace0e5a1515bbead9835cd1e2d67197f8"></a><!-- doxytag: member="Accessibility::Event::source" ref="ace0e5a1515bbead9835cd1e2d67197f8" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="interfaceAccessibility_1_1Accessible.html">Accessible</a> <a class="el" href="structAccessibility_1_1Event.html#ace0e5a1515bbead9835cd1e2d67197f8">Accessibility::Event::source</a></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>The <a class="el" href="interfaceAccessibility_1_1Accessible.html">Accessible</a> object which is the source of the event. The source object is the object to which the change inferred by the event emission occurs; for instance, the object emitting a ¨object:parent-changed¨ event is the child, not the parent. Likewise, the event source of an ¨object:children-changed:insert¨ event is the parent, not the inserted child. </p>
</div>
</div>
<a class="anchor" id="add8793ed6ba9e3da7edb62e8b9ff291d"></a><!-- doxytag: member="Accessibility::Event::type" ref="add8793ed6ba9e3da7edb62e8b9ff291d" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">string <a class="el" href="structAccessibility_1_1Event.html#add8793ed6ba9e3da7edb62e8b9ff291d">Accessibility::Event::type</a></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>A colon-delimited string indicating the type of the event. The string can be interpreted as <code>class:type:subtype</code> For instance ¨object:text-changed:insert¨ is an event from the 'Object' class, which corresponds to <a class="el" href="interfaceAccessibility_1_1Accessible.html">Accessible</a> objects general, the type of the event is a ¨text-changed¨ event (i.e. a change in the content of an implementor of the <a class="el" href="interfaceAccessibility_1_1Text.html">Text</a> interface), and the specific subtype of the change is an insertion event.</p>
<p><a class="el" href="structAccessibility_1_1Event.html">Event</a> classes include the following: </p>
<ul>
<li>focus: an object has received keyboard focus. This event has no type or subtype. </li>
<li>window: a toplevel window has changed state. </li>
<li>object: an object (i.e. <a class="el" href="interfaceAccessibility_1_1Accessible.html">Accessible</a>) has undergone some change in state, content, or hierarchy </li>
<li>document:a change to a document's content has occurred, or its content loading status has changed. </li>
<li>mouse: an event originating from the pointing device. Rarely used; in most cases clients will wish to register for pointer events via the DeviceEventController::registerDeviceEvent method instead. </li>
<li>keyboard: an event indicating that the keyboard state (for example, the modifier state) has changed significantly. "keyboard:" events are not sent for individual keystrokes except as a side-effect of certain keys, for instance modifier keys. Clients interested in key events should listen for DeviceEvents via <a class="el" href="interfaceAccessibility_1_1DeviceEventController.html#ae821dc139bf3a8cec84d72833ea33b78">DeviceEventController::registerKeystrokeListener</a> instead.</li>
</ul>
<dl class="note"><dt><b>Note:</b></dt><dd>For more information on specific event types, see the documentation for each of the individual interfaces supported by some <a class="el" href="interfaceAccessibility_1_1Accessible.html">Accessible</a> objects.</dd></dl>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="interfaceAccessibility_1_1Accessible.html">Accessible</a>, <a class="el" href="interfaceAccessibility_1_1Component.html">Component</a>, <a class="el" href="interfaceAccessibility_1_1Image.html">Image</a>, <a class="el" href="interfaceAccessibility_1_1Selection.html">Selection</a>, <a class="el" href="interfaceAccessibility_1_1Table.html">Table</a>, <a class="el" href="interfaceAccessibility_1_1Text.html">Text</a>, <a class="el" href="interfaceAccessibility_1_1Value.html">Value</a>. </dd></dl>
</div>
</div>
<hr/>The documentation for this struct was generated from the following file:<ul>
<li>/home/liyuan/src/at-spi/idl/<a class="el" href="Accessibility__Event_8idl_source.html">Accessibility_Event.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>
