<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en_US" lang="en_US">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<!-- qaccessible.cpp -->
<title>Qt 4.8: QAccessible Class Reference</title>
<link rel="stylesheet" type="text/css" href="style/style.css" />
<script src="scripts/jquery.js" type="text/javascript"></script>
<script src="scripts/functions.js" type="text/javascript"></script>
<link rel="stylesheet" type="text/css" href="style/superfish.css" />
<link rel="stylesheet" type="text/css" href="style/narrow.css" />
<!--[if IE]>
<meta name="MSSmartTagsPreventParsing" content="true">
<meta http-equiv="imagetoolbar" content="no">
<![endif]-->
<!--[if lt IE 7]>
<link rel="stylesheet" type="text/css" href="style/style_ie6.css">
<![endif]-->
<!--[if IE 7]>
<link rel="stylesheet" type="text/css" href="style/style_ie7.css">
<![endif]-->
<!--[if IE 8]>
<link rel="stylesheet" type="text/css" href="style/style_ie8.css">
<![endif]-->
<script src="scripts/superfish.js" type="text/javascript"></script>
<script src="scripts/narrow.js" type="text/javascript"></script>
</head>
<body class="" onload="CheckEmptyAndLoadList();">
<div class="header" id="qtdocheader">
<div class="content">
<div id="nav-logo">
<a href="index.html">Home</a></div>
<a href="index.html" class="qtref"><span>Qt Reference Documentation</span></a>
<div id="narrowsearch"></div>
<div id="nav-topright">
<ul>
<li class="nav-topright-home"><a href="http://qt.digia.com/">Qt HOME</a></li>
<li class="nav-topright-dev"><a href="http://qt-project.org/">DEV</a></li>
<li class="nav-topright-doc nav-topright-doc-active"><a href="http://qt-project.org/doc/">
DOC</a></li>
<li class="nav-topright-blog"><a href="http://blog.qt.digia.com/">BLOG</a></li>
</ul>
</div>
<div id="shortCut">
<ul>
<li class="shortCut-topleft-inactive"><span><a href="index.html">Qt 4.8</a></span></li>
<li class="shortCut-topleft-active"><a href="http://qt-project.org/doc/">ALL VERSIONS </a></li>
</ul>
</div>
<ul class="sf-menu" id="narrowmenu">
<li><a href="#">API Lookup</a>
<ul>
<li><a href="classes.html">Class index</a></li>
<li><a href="functions.html">Function index</a></li>
<li><a href="modules.html">Modules</a></li>
<li><a href="namespaces.html">Namespaces</a></li>
<li><a href="qtglobal.html">Global Declarations</a></li>
<li><a href="qdeclarativeelements.html">QML elements</a></li>
</ul>
</li>
<li><a href="#">Qt Topics</a>
<ul>
<li><a href="qt-basic-concepts.html">Programming with Qt</a></li>
<li><a href="qtquick.html">Device UIs & Qt Quick</a></li>
<li><a href="qt-gui-concepts.html">UI Design with Qt</a></li>
<li><a href="supported-platforms.html">Supported Platforms</a></li>
<li><a href="technology-apis.html">Qt and Key Technologies</a></li>
<li><a href="best-practices.html">How-To's and Best Practices</a></li>
</ul>
</li>
<li><a href="#">Examples</a>
<ul>
<li><a href="all-examples.html">Examples</a></li>
<li><a href="tutorials.html">Tutorials</a></li>
<li><a href="demos.html">Demos</a></li>
<li><a href="qdeclarativeexamples.html">QML Examples</a></li>
</ul>
</li>
</ul>
</div>
</div>
<div class="wrapper">
<div class="hd">
<span></span>
</div>
<div class="bd group">
<div class="sidebar">
<div class="searchlabel">
Search index:</div>
<div class="search" id="sidebarsearch">
<form id="qtdocsearch" action="" onsubmit="return false;">
<fieldset>
<input type="text" name="searchstring" id="pageType" value="" />
<div id="resultdialog">
<a href="#" id="resultclose">Close</a>
<p id="resultlinks" class="all"><a href="#" id="showallresults">All</a> | <a href="#" id="showapiresults">API</a> | <a href="#" id="showarticleresults">Articles</a> | <a href="#" id="showexampleresults">Examples</a></p>
<p id="searchcount" class="all"><span id="resultcount"></span><span id="apicount"></span><span id="articlecount"></span><span id="examplecount"></span> results:</p>
<ul id="resultlist" class="all">
</ul>
</div>
</fieldset>
</form>
</div>
<div class="box first bottombar" id="lookup">
<h2 title="API Lookup"><span></span>
API Lookup</h2>
<div id="list001" class="list">
<ul id="ul001" >
<li class="defaultLink"><a href="classes.html">Class index</a></li>
<li class="defaultLink"><a href="functions.html">Function index</a></li>
<li class="defaultLink"><a href="modules.html">Modules</a></li>
<li class="defaultLink"><a href="namespaces.html">Namespaces</a></li>
<li class="defaultLink"><a href="qtglobal.html">Global Declarations</a></li>
<li class="defaultLink"><a href="qdeclarativeelements.html">QML elements</a></li>
</ul>
</div>
</div>
<div class="box bottombar" id="topics">
<h2 title="Qt Topics"><span></span>
Qt Topics</h2>
<div id="list002" class="list">
<ul id="ul002" >
<li class="defaultLink"><a href="qt-basic-concepts.html">Programming with Qt</a></li>
<li class="defaultLink"><a href="qtquick.html">Device UIs & Qt Quick</a></li>
<li class="defaultLink"><a href="qt-gui-concepts.html">UI Design with Qt</a></li>
<li class="defaultLink"><a href="supported-platforms.html">Supported Platforms</a></li>
<li class="defaultLink"><a href="technology-apis.html">Qt and Key Technologies</a></li>
<li class="defaultLink"><a href="best-practices.html">How-To's and Best Practices</a></li>
</ul>
</div>
</div>
<div class="box" id="examples">
<h2 title="Examples"><span></span>
Examples</h2>
<div id="list003" class="list">
<ul id="ul003">
<li class="defaultLink"><a href="all-examples.html">Examples</a></li>
<li class="defaultLink"><a href="tutorials.html">Tutorials</a></li>
<li class="defaultLink"><a href="demos.html">Demos</a></li>
<li class="defaultLink"><a href="qdeclarativeexamples.html">QML Examples</a></li>
</ul>
</div>
</div>
</div>
<div class="wrap">
<div class="toolbar">
<div class="breadcrumb toolblock">
<ul>
<li class="first"><a href="index.html">Home</a></li>
<!-- Breadcrumbs go here -->
<li><a href="modules.html">Modules</a></li>
<li><a href="qtgui.html">QtGui</a></li>
<li>QAccessible</li>
</ul>
</div>
<div class="toolbuttons toolblock">
<ul>
<li id="smallA" class="t_button">A</li>
<li id="medA" class="t_button active">A</li>
<li id="bigA" class="t_button">A</li>
<li id="print" class="t_button"><a href="javascript:this.print();">
<span>Print</span></a></li>
</ul>
</div>
</div>
<div class="content mainContent">
<div class="toc">
<h3><a name="toc">Contents</a></h3>
<ul>
<li class="level1"><a href="#public-types">Public Types</a></li>
<li class="level1"><a href="#static-public-members">Static Public Members</a></li>
<li class="level1"><a href="#details">Detailed Description</a></li>
</ul>
</div>
<h1 class="title">QAccessible Class Reference</h1>
<!-- $$$QAccessible-brief -->
<p>The QAccessible class provides enums and static functions relating to accessibility. <a href="#details">More...</a></p>
<!-- @@@QAccessible -->
<pre class="cpp"> <span class="preprocessor">#include <QAccessible></span></pre><p><b>Inherited by: </b><a href="qaccessibleinterface.html">QAccessibleInterface</a> and <a href="qaccessibleplugin.html">QAccessiblePlugin</a>.</p>
<ul>
<li><a href="qaccessible-members.html">List of all members, including inherited members</a></li>
</ul>
<a name="public-types"></a>
<h2>Public Types</h2>
<table class="alignedsummary">
<tr><td class="memItemLeft rightAlign topAlign"> enum </td><td class="memItemRight bottomAlign"><b><a href="qaccessible.html#Action-enum">Action</a></b> { DefaultAction, Press, SetFocus, Increase, ..., LastStandardAction }</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> enum </td><td class="memItemRight bottomAlign"><b><a href="qaccessible.html#Event-enum">Event</a></b> { AcceleratorChanged, ActionChanged, ActiveDescendantChanged, Alert, ..., VisibleDataChanged }</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> typedef </td><td class="memItemRight bottomAlign"><b><a href="qaccessible.html#InterfaceFactory-typedef">InterfaceFactory</a></b></td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> enum </td><td class="memItemRight bottomAlign"><b><a href="qaccessible.html#Method-enum">Method</a></b> { ListSupportedMethods, SetCursorPosition, GetCursorPosition }</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> flags </td><td class="memItemRight bottomAlign"><b><a href="qaccessible.html#RelationFlag-enum">Relation</a></b></td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> enum </td><td class="memItemRight bottomAlign"><b><a href="qaccessible.html#RelationFlag-enum">RelationFlag</a></b> { Unrelated, Self, Ancestor, Child, ..., Controlled }</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> enum </td><td class="memItemRight bottomAlign"><b><a href="qaccessible.html#Role-enum">Role</a></b> { AlertMessage, Animation, Application, Assistant, ..., Window }</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> flags </td><td class="memItemRight bottomAlign"><b><a href="qaccessible.html#StateFlag-enum">State</a></b></td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> enum </td><td class="memItemRight bottomAlign"><b><a href="qaccessible.html#StateFlag-enum">StateFlag</a></b> { Animated, Busy, Checked, Collapsed, ..., Unavailable }</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> enum </td><td class="memItemRight bottomAlign"><b><a href="qaccessible.html#Text-enum">Text</a></b> { Name, Description, Value, Help, Accelerator, UserText }</td></tr>
</table>
<a name="static-public-members"></a>
<h2>Static Public Members</h2>
<table class="alignedsummary">
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qaccessible.html#installFactory">installFactory</a></b> ( InterfaceFactory <i>factory</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> RootObjectHandler </td><td class="memItemRight bottomAlign"><b><a href="qaccessible.html#installRootObjectHandler">installRootObjectHandler</a></b> ( RootObjectHandler <i>handler</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qaccessible.html#isActive">isActive</a></b> ()</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QAccessibleInterface * </td><td class="memItemRight bottomAlign"><b><a href="qaccessible.html#queryAccessibleInterface">queryAccessibleInterface</a></b> ( QObject * <i>object</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qaccessible.html#removeFactory">removeFactory</a></b> ( InterfaceFactory <i>factory</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qaccessible.html#setRootObject">setRootObject</a></b> ( QObject * <i>object</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qaccessible.html#updateAccessibility">updateAccessibility</a></b> ( QObject * <i>object</i>, int <i>child</i>, Event <i>reason</i> )</td></tr>
</table>
<a name="details"></a>
<!-- $$$QAccessible-description -->
<div class="descr">
<h2>Detailed Description</h2>
<p>The QAccessible class provides enums and static functions relating to accessibility.</p>
<p>Accessible applications can be used by people who are not able to use applications by conventional means.</p>
<p>The functions in this class are used for communication between accessible applications (also called AT Servers) and accessibility tools (AT Clients), such as screen readers and braille displays. Clients and servers communicate in the following way:</p>
<ul>
<li><i>AT Servers</i> notify the clients about events through calls to the <a href="qaccessible.html#updateAccessibility">updateAccessibility</a>() function.</li>
<li><i>AT Clients</i> request information about the objects in the server. The <a href="qaccessibleinterface.html">QAccessibleInterface</a> class is the core interface, and encapsulates this information in a pure virtual API. Implementations of the interface are provided by Qt through the <a href="qaccessible.html#queryAccessibleInterface">queryAccessibleInterface</a>() API.</li>
</ul>
<p>The communication between servers and clients is initialized by the <a href="qaccessible.html#setRootObject">setRootObject</a>() function. Function pointers can be installed to replace or extend the default behavior of the static functions in QAccessible.</p>
<p>Qt supports Microsoft Active Accessibility (MSAA), Mac OS X Accessibility, and the Unix/X11 AT-SPI standard. Other backends can be supported using <a href="qaccessiblebridge.html">QAccessibleBridge</a>.</p>
<p>In addition to QAccessible's static functions, Qt offers one generic interface, <a href="qaccessibleinterface.html">QAccessibleInterface</a>, that can be used to wrap all widgets and objects (e.g., <a href="qpushbutton.html">QPushButton</a>). This single interface provides all the metadata necessary for the assistive technologies. Qt provides implementations of this interface for its built-in widgets as plugins.</p>
<p>When you develop custom widgets, you can create custom subclasses of <a href="qaccessibleinterface.html">QAccessibleInterface</a> and distribute them as plugins (using <a href="qaccessibleplugin.html">QAccessiblePlugin</a>) or compile them into the application. Likewise, Qt's predefined accessibility support can be built as plugin (the default) or directly into the Qt library. The main advantage of using plugins is that the accessibility classes are only loaded into memory if they are actually used; they don't slow down the common case where no assistive technology is being used.</p>
<p>Qt also includes two convenience classes, <a href="qaccessibleobject.html">QAccessibleObject</a> and <a href="qaccessiblewidget.html">QAccessibleWidget</a>, that inherit from <a href="qaccessibleinterface.html">QAccessibleInterface</a> and provide the lowest common denominator of metadata (e.g., widget geometry, window title, basic help text). You can use them as base classes when wrapping your custom <a href="qobject.html">QObject</a> or <a href="qwidget.html">QWidget</a> subclasses.</p>
</div>
<p><b>See also </b><a href="qaccessibleinterface.html">QAccessibleInterface</a>.</p>
<!-- @@@QAccessible -->
<div class="types">
<h2>Member Type Documentation</h2>
<!-- $$$Action$$$DefaultAction$$$Press$$$FirstStandardAction$$$SetFocus$$$Increase$$$Decrease$$$Accept$$$Cancel$$$Select$$$ClearSelection$$$RemoveSelection$$$ExtendSelection$$$AddToSelection$$$LastStandardAction -->
<h3 class="fn"><a name="Action-enum"></a>enum QAccessible::<span class="name">Action</span></h3>
<p>This enum describes the possible types of action that can occur.</p>
<table class="valuelist"><tr><th class="tblConst">Constant</th><th class="tblVal">Value</th></tr>
<tr><td class="topAlign"><tt>QAccessible::DefaultAction</tt></td><td class="topAlign"><tt>0</tt></td></tr>
<tr><td class="topAlign"><tt>QAccessible::Press</tt></td><td class="topAlign"><tt>-1</tt></td></tr>
<tr><td class="topAlign"><tt>QAccessible::SetFocus</tt></td><td class="topAlign"><tt>-2</tt></td></tr>
<tr><td class="topAlign"><tt>QAccessible::Increase</tt></td><td class="topAlign"><tt>-3</tt></td></tr>
<tr><td class="topAlign"><tt>QAccessible::Decrease</tt></td><td class="topAlign"><tt>-4</tt></td></tr>
<tr><td class="topAlign"><tt>QAccessible::Accept</tt></td><td class="topAlign"><tt>-5</tt></td></tr>
<tr><td class="topAlign"><tt>QAccessible::Cancel</tt></td><td class="topAlign"><tt>-6</tt></td></tr>
<tr><td class="topAlign"><tt>QAccessible::Select</tt></td><td class="topAlign"><tt>-7</tt></td></tr>
<tr><td class="topAlign"><tt>QAccessible::ClearSelection</tt></td><td class="topAlign"><tt>-8</tt></td></tr>
<tr><td class="topAlign"><tt>QAccessible::RemoveSelection</tt></td><td class="topAlign"><tt>-9</tt></td></tr>
<tr><td class="topAlign"><tt>QAccessible::ExtendSelection</tt></td><td class="topAlign"><tt>-10</tt></td></tr>
<tr><td class="topAlign"><tt>QAccessible::AddToSelection</tt></td><td class="topAlign"><tt>-11</tt></td></tr>
<tr><td class="topAlign"><tt>QAccessible::FirstStandardAction</tt></td><td class="topAlign"><tt>Press</tt></td></tr>
<tr><td class="topAlign"><tt>QAccessible::LastStandardAction</tt></td><td class="topAlign"><tt>AddToSelection</tt></td></tr>
</table>
<!-- @@@Action -->
<!-- $$$Event$$$SoundPlayed$$$Alert$$$ForegroundChanged$$$MenuStart$$$MenuEnd$$$PopupMenuStart$$$PopupMenuEnd$$$ContextHelpStart$$$ContextHelpEnd$$$DragDropStart$$$DragDropEnd$$$DialogStart$$$DialogEnd$$$ScrollingStart$$$ScrollingEnd$$$MenuCommand$$$ActionChanged$$$ActiveDescendantChanged$$$AttributeChanged$$$DocumentContentChanged$$$DocumentLoadComplete$$$DocumentLoadStopped$$$DocumentReload$$$HyperlinkEndIndexChanged$$$HyperlinkNumberOfAnchorsChanged$$$HyperlinkSelectedLinkChanged$$$HypertextLinkActivated$$$HypertextLinkSelected$$$HyperlinkStartIndexChanged$$$HypertextChanged$$$HypertextNLinksChanged$$$ObjectAttributeChanged$$$PageChanged$$$SectionChanged$$$TableCaptionChanged$$$TableColumnDescriptionChanged$$$TableColumnHeaderChanged$$$TableModelChanged$$$TableRowDescriptionChanged$$$TableRowHeaderChanged$$$TableSummaryChanged$$$TextAttributeChanged$$$TextCaretMoved$$$TextColumnChanged$$$TextInserted$$$TextRemoved$$$TextUpdated$$$TextSelectionChanged$$$VisibleDataChanged$$$ObjectCreated$$$ObjectDestroyed$$$ObjectShow$$$ObjectHide$$$ObjectReorder$$$Focus$$$Selection$$$SelectionAdd$$$SelectionRemove$$$SelectionWithin$$$StateChanged$$$LocationChanged$$$NameChanged$$$DescriptionChanged$$$ValueChanged$$$ParentChanged$$$HelpChanged$$$DefaultActionChanged$$$AcceleratorChanged -->
<h3 class="fn"><a name="Event-enum"></a>enum QAccessible::<span class="name">Event</span></h3>
<p>This enum type defines accessible event types.</p>
<table class="valuelist"><tr valign="top" class="odd"><th class="tblConst">Constant</th><th class="tblval">Value</th><th class="tbldscr">Description</th></tr>
<tr><td class="topAlign"><tt>QAccessible::AcceleratorChanged</tt></td><td class="topAlign"><tt>0x80C0</tt></td><td class="topAlign">The keyboard accelerator for an action has been changed.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::ActionChanged</tt></td><td class="topAlign"><tt>0x0101</tt></td><td class="topAlign">An action has been changed.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::ActiveDescendantChanged</tt></td><td class="topAlign"><tt>0x0102</tt></td><td class="topAlign"> </td></tr>
<tr><td class="topAlign"><tt>QAccessible::Alert</tt></td><td class="topAlign"><tt>0x0002</tt></td><td class="topAlign">A system alert (e.g., a message from a <a href="qmessagebox.html">QMessageBox</a>)</td></tr>
<tr><td class="topAlign"><tt>QAccessible::AttributeChanged</tt></td><td class="topAlign"><tt>0x0103</tt></td><td class="topAlign"> </td></tr>
<tr><td class="topAlign"><tt>QAccessible::ContextHelpEnd</tt></td><td class="topAlign"><tt>0x000D</tt></td><td class="topAlign">Context help (<a href="qwhatsthis.html">QWhatsThis</a>) for an object is finished.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::ContextHelpStart</tt></td><td class="topAlign"><tt>0x000C</tt></td><td class="topAlign">Context help (<a href="qwhatsthis.html">QWhatsThis</a>) for an object is initiated.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::DefaultActionChanged</tt></td><td class="topAlign"><tt>0x80B0</tt></td><td class="topAlign">The default <a href="qaccessible.html#Action-enum">QAccessible::Action</a> for the accessible object has changed.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::DescriptionChanged</tt></td><td class="topAlign"><tt>0x800D</tt></td><td class="topAlign">The object's <a href="qaccessible.html#Text-enum">QAccessible::Description</a> changed.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::DialogEnd</tt></td><td class="topAlign"><tt>0x0011</tt></td><td class="topAlign">A dialog (<a href="qdialog.html">QDialog</a>) has been hidden</td></tr>
<tr><td class="topAlign"><tt>QAccessible::DialogStart</tt></td><td class="topAlign"><tt>0x0010</tt></td><td class="topAlign">A dialog (<a href="qdialog.html">QDialog</a>) has been set visible.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::DocumentContentChanged</tt></td><td class="topAlign"><tt>0x0104</tt></td><td class="topAlign">The contents of a text document have changed.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::DocumentLoadComplete</tt></td><td class="topAlign"><tt>0x0105</tt></td><td class="topAlign">A document has been loaded.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::DocumentLoadStopped</tt></td><td class="topAlign"><tt>0x0106</tt></td><td class="topAlign">A document load has been stopped.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::DocumentReload</tt></td><td class="topAlign"><tt>0x0107</tt></td><td class="topAlign">A document reload has been initiated.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::DragDropEnd</tt></td><td class="topAlign"><tt>0x000F</tt></td><td class="topAlign">A drag and drop operation is about to finished.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::DragDropStart</tt></td><td class="topAlign"><tt>0x000E</tt></td><td class="topAlign">A drag and drop operation is about to be initiated.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::Focus</tt></td><td class="topAlign"><tt>0x8005</tt></td><td class="topAlign">An object has gained keyboard focus.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::ForegroundChanged</tt></td><td class="topAlign"><tt>0x0003</tt></td><td class="topAlign">A window has been activated (i.e., a new window has gained focus on the desktop).</td></tr>
<tr><td class="topAlign"><tt>QAccessible::HelpChanged</tt></td><td class="topAlign"><tt>0x80A0</tt></td><td class="topAlign">The <a href="qaccessible.html#Text-enum">QAccessible::Help</a> text property of an object has changed.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::HyperlinkEndIndexChanged</tt></td><td class="topAlign"><tt>0x0108</tt></td><td class="topAlign">The end position of the display text for a hypertext link has changed.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::HyperlinkNumberOfAnchorsChanged</tt></td><td class="topAlign"><tt>0x0109</tt></td><td class="topAlign">The number of anchors in a hypertext link has changed, perhaps because the display text has been split to provide more than one link.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::HyperlinkSelectedLinkChanged</tt></td><td class="topAlign"><tt>0x010A</tt></td><td class="topAlign">The link for the selected hypertext link has changed.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::HyperlinkStartIndexChanged</tt></td><td class="topAlign"><tt>0x010D</tt></td><td class="topAlign">The start position of the display text for a hypertext link has changed.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::HypertextChanged</tt></td><td class="topAlign"><tt>0x010E</tt></td><td class="topAlign">The display text for a hypertext link has changed.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::HypertextLinkActivated</tt></td><td class="topAlign"><tt>0x010B</tt></td><td class="topAlign">A hypertext link has been activated, perhaps by being clicked or via a key press.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::HypertextLinkSelected</tt></td><td class="topAlign"><tt>0x010C</tt></td><td class="topAlign">A hypertext link has been selected.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::HypertextNLinksChanged</tt></td><td class="topAlign"><tt>0x010F</tt></td><td class="topAlign"> </td></tr>
<tr><td class="topAlign"><tt>QAccessible::LocationChanged</tt></td><td class="topAlign"><tt>0x800B</tt></td><td class="topAlign">An object's location on the screen has changed.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::MenuCommand</tt></td><td class="topAlign"><tt>0x0018</tt></td><td class="topAlign">A menu item is triggered.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::MenuEnd</tt></td><td class="topAlign"><tt>0x0005</tt></td><td class="topAlign">A menu has been closed (Qt uses PopupMenuEnd for all menus).</td></tr>
<tr><td class="topAlign"><tt>QAccessible::MenuStart</tt></td><td class="topAlign"><tt>0x0004</tt></td><td class="topAlign">A menu has been opened on the menubar (Qt uses PopupMenuStart for all menus).</td></tr>
<tr><td class="topAlign"><tt>QAccessible::NameChanged</tt></td><td class="topAlign"><tt>0x800C</tt></td><td class="topAlign">The <a href="qaccessible.html#Text-enum">QAccessible::Name</a> property of an object has changed.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::ObjectAttributeChanged</tt></td><td class="topAlign"><tt>0x0110</tt></td><td class="topAlign"> </td></tr>
<tr><td class="topAlign"><tt>QAccessible::ObjectCreated</tt></td><td class="topAlign"><tt>0x8000</tt></td><td class="topAlign">A new object is created.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::ObjectDestroyed</tt></td><td class="topAlign"><tt>0x8001</tt></td><td class="topAlign">An object is deleted.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::ObjectHide</tt></td><td class="topAlign"><tt>0x8003</tt></td><td class="topAlign">An object is hidden; for example, with <a href="qwidget.html#hide">QWidget::hide</a>(). Any children the object that is hidden has do not send this event. It is not sent when an object is hidden as it is being obcured by others.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::ObjectReorder</tt></td><td class="topAlign"><tt>0x8004</tt></td><td class="topAlign">A layout or item view has added, removed, or moved an object (Qt does not use this event).</td></tr>
<tr><td class="topAlign"><tt>QAccessible::ObjectShow</tt></td><td class="topAlign"><tt>0x8002</tt></td><td class="topAlign">An object is displayed; for example, with <a href="qwidget.html#show">QWidget::show</a>().</td></tr>
<tr><td class="topAlign"><tt>QAccessible::PageChanged</tt></td><td class="topAlign"><tt>0x0111</tt></td><td class="topAlign"> </td></tr>
<tr><td class="topAlign"><tt>QAccessible::ParentChanged</tt></td><td class="topAlign"><tt>0x800F</tt></td><td class="topAlign">An object's parent object changed.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::PopupMenuEnd</tt></td><td class="topAlign"><tt>0x0007</tt></td><td class="topAlign">A pop-up menu has closed.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::PopupMenuStart</tt></td><td class="topAlign"><tt>0x0006</tt></td><td class="topAlign">A pop-up menu has opened.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::ScrollingEnd</tt></td><td class="topAlign"><tt>0x0013</tt></td><td class="topAlign">A scrollbar scroll operation has ended (the mouse has released the slider handle).</td></tr>
<tr><td class="topAlign"><tt>QAccessible::ScrollingStart</tt></td><td class="topAlign"><tt>0x0012</tt></td><td class="topAlign">A scrollbar scroll operation is about to start; this may be caused by a mouse press on the slider handle, for example.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::SectionChanged</tt></td><td class="topAlign"><tt>0x0112</tt></td><td class="topAlign"> </td></tr>
<tr><td class="topAlign"><tt>QAccessible::SelectionAdd</tt></td><td class="topAlign"><tt>0x8007</tt></td><td class="topAlign">An item has been added to the selection in an item view.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::SelectionRemove</tt></td><td class="topAlign"><tt>0x8008</tt></td><td class="topAlign">An item has been removed from an item view selection.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::Selection</tt></td><td class="topAlign"><tt>0x8006</tt></td><td class="topAlign">The selection has changed in a menu or item view.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::SelectionWithin</tt></td><td class="topAlign"><tt>0x8009</tt></td><td class="topAlign">Several changes to a selection has occurred in an item view.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::SoundPlayed</tt></td><td class="topAlign"><tt>0x0001</tt></td><td class="topAlign">A sound has been played by an object</td></tr>
<tr><td class="topAlign"><tt>QAccessible::StateChanged</tt></td><td class="topAlign"><tt>0x800A</tt></td><td class="topAlign">The <a href="qaccessible.html#StateFlag-enum">QAccessible::State</a> of an object has changed.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::TableCaptionChanged</tt></td><td class="topAlign"><tt>0x0113</tt></td><td class="topAlign">A table caption has been changed.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::TableColumnDescriptionChanged</tt></td><td class="topAlign"><tt>0x0114</tt></td><td class="topAlign">The description of a table column, typically found in the column's header, has been changed.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::TableColumnHeaderChanged</tt></td><td class="topAlign"><tt>0x0115</tt></td><td class="topAlign">A table column header has been changed.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::TableModelChanged</tt></td><td class="topAlign"><tt>0x0116</tt></td><td class="topAlign">The model providing data for a table has been changed.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::TableRowDescriptionChanged</tt></td><td class="topAlign"><tt>0x0117</tt></td><td class="topAlign">The description of a table row, typically found in the row's header, has been changed.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::TableRowHeaderChanged</tt></td><td class="topAlign"><tt>0x0118</tt></td><td class="topAlign">A table row header has been changed.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::TableSummaryChanged</tt></td><td class="topAlign"><tt>0x0119</tt></td><td class="topAlign">The summary of a table has been changed.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::TextAttributeChanged</tt></td><td class="topAlign"><tt>0x011A</tt></td><td class="topAlign"> </td></tr>
<tr><td class="topAlign"><tt>QAccessible::TextCaretMoved</tt></td><td class="topAlign"><tt>0x011B</tt></td><td class="topAlign">The caret has moved in an editable widget. The caret represents the cursor position in an editable widget with the input focus.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::TextColumnChanged</tt></td><td class="topAlign"><tt>0x011D</tt></td><td class="topAlign">A text column has been changed.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::TextInserted</tt></td><td class="topAlign"><tt>0x011E</tt></td><td class="topAlign">Text has been inserted into an editable widget.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::TextRemoved</tt></td><td class="topAlign"><tt>0x011F</tt></td><td class="topAlign">Text has been removed from an editable widget.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::TextSelectionChanged</tt></td><td class="topAlign"><tt>0x0121</tt></td><td class="topAlign">The selected text has changed in an editable widget.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::TextUpdated</tt></td><td class="topAlign"><tt>0x0120</tt></td><td class="topAlign">The text has been update in an editable widget.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::ValueChanged</tt></td><td class="topAlign"><tt>0x800E</tt></td><td class="topAlign">The <a href="qaccessible.html#Text-enum">QAccessible::Value</a> of an object has changed.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::VisibleDataChanged</tt></td><td class="topAlign"><tt>0x0122</tt></td><td class="topAlign"> </td></tr>
</table>
<p>The values for this enum are defined to be the same as those defined in the <a href="http://accessibility.linuxfoundation.org/a11yspecs/ia2/docs/html/_accessible_event_i_d_8idl.html">IAccessible2</a> and <a href="http://msdn.microsoft.com/en-us/library/dd318066.aspx">MSAA</a> specifications.</p>
<!-- @@@Event -->
<!-- $$$InterfaceFactory -->
<h3 class="fn"><a name="InterfaceFactory-typedef"></a>typedef QAccessible::<span class="name">InterfaceFactory</span></h3>
<p>This is a typedef for a pointer to a function with the following signature:</p>
<pre class="cpp"> <span class="keyword">typedef</span> <span class="type"><a href="qaccessibleinterface.html">QAccessibleInterface</a></span><span class="operator">*</span> myFactoryFunction(<span class="keyword">const</span> <span class="type"><a href="qstring.html">QString</a></span> <span class="operator">&</span>key<span class="operator">,</span> <span class="type"><a href="qobject.html">QObject</a></span> <span class="operator">*</span>);</pre>
<p>The function receives a <a href="qstring.html">QString</a> and a <a href="qobject.html">QObject</a> pointer, where the <a href="qstring.html">QString</a> is the key identifying the interface. The <a href="qobject.html">QObject</a> is used to pass on to the <a href="qaccessibleinterface.html">QAccessibleInterface</a> so that it can hold a reference to it.</p>
<p>If the key and the <a href="qobject.html">QObject</a> does not have a corresponding <a href="qaccessibleinterface.html">QAccessibleInterface</a>, a null-pointer will be returned.</p>
<p>Installed factories are called by queryAccessibilityInterface() until one provides an interface.</p>
<!-- @@@InterfaceFactory -->
<!-- $$$Method$$$ListSupportedMethods$$$SetCursorPosition$$$GetCursorPosition$$$ForegroundColor$$$BackgroundColor -->
<h3 class="fn"><a name="Method-enum"></a>enum QAccessible::<span class="name">Method</span></h3>
<p>This enum describes the possible types of methods that can be invoked on an accessible object.</p>
<table class="valuelist"><tr><th class="tblConst">Constant</th><th class="tblVal">Value</th></tr>
<tr><td class="topAlign"><tt>QAccessible::ListSupportedMethods</tt></td><td class="topAlign"><tt>0</tt></td></tr>
<tr><td class="topAlign"><tt>QAccessible::SetCursorPosition</tt></td><td class="topAlign"><tt>1</tt></td></tr>
<tr><td class="topAlign"><tt>QAccessible::GetCursorPosition</tt></td><td class="topAlign"><tt>2</tt></td></tr>
</table>
<p><b>See also </b><a href="qaccessibleinterface.html#invokeMethod">QAccessibleInterface::invokeMethod</a>().</p>
<!-- @@@Method -->
<!-- $$$RelationFlag$$$Unrelated$$$Self$$$Ancestor$$$Child$$$Descendent$$$Sibling$$$HierarchyMask$$$Up$$$Down$$$Left$$$Right$$$Covers$$$Covered$$$GeometryMask$$$FocusChild$$$Label$$$Labelled$$$Controller$$$Controlled$$$LogicalMask -->
<h3 class="flags"><a name="RelationFlag-enum"></a>enum QAccessible::<span class="name">RelationFlag</span><br/>flags QAccessible::<span class="name">Relation</span></h3>
<p>This enum type defines bit flags that can be combined to indicate the relationship between two accessible objects.</p>
<table class="valuelist"><tr valign="top" class="odd"><th class="tblConst">Constant</th><th class="tblval">Value</th><th class="tbldscr">Description</th></tr>
<tr><td class="topAlign"><tt>QAccessible::Unrelated</tt></td><td class="topAlign"><tt>0x00000000</tt></td><td class="topAlign">The objects are unrelated.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::Self</tt></td><td class="topAlign"><tt>0x00000001</tt></td><td class="topAlign">The objects are the same.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::Ancestor</tt></td><td class="topAlign"><tt>0x00000002</tt></td><td class="topAlign">The first object is a parent of the second object.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::Child</tt></td><td class="topAlign"><tt>0x00000004</tt></td><td class="topAlign">The first object is a direct child of the second object.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::Descendent</tt></td><td class="topAlign"><tt>0x00000008</tt></td><td class="topAlign">The first object is an indirect child of the second object.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::Sibling</tt></td><td class="topAlign"><tt>0x00000010</tt></td><td class="topAlign">The objects are siblings.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::Up</tt></td><td class="topAlign"><tt>0x00000100</tt></td><td class="topAlign">The first object is above the second object.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::Down</tt></td><td class="topAlign"><tt>0x00000200</tt></td><td class="topAlign">The first object is below the second object.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::Left</tt></td><td class="topAlign"><tt>0x00000400</tt></td><td class="topAlign">The first object is left of the second object.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::Right</tt></td><td class="topAlign"><tt>0x00000800</tt></td><td class="topAlign">The first object is right of the second object.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::Covers</tt></td><td class="topAlign"><tt>0x00001000</tt></td><td class="topAlign">The first object covers the second object.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::Covered</tt></td><td class="topAlign"><tt>0x00002000</tt></td><td class="topAlign">The first object is covered by the second object.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::FocusChild</tt></td><td class="topAlign"><tt>0x00010000</tt></td><td class="topAlign">The first object is the second object's focus child.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::Label</tt></td><td class="topAlign"><tt>0x00020000</tt></td><td class="topAlign">The first object is the label of the second object.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::Labelled</tt></td><td class="topAlign"><tt>0x00040000</tt></td><td class="topAlign">The first object is labelled by the second object.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::Controller</tt></td><td class="topAlign"><tt>0x00080000</tt></td><td class="topAlign">The first object controls the second object.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::Controlled</tt></td><td class="topAlign"><tt>0x00100000</tt></td><td class="topAlign">The first object is controlled by the second object.</td></tr>
</table>
<p>Implementations of relationTo() return a combination of these flags. Some values are mutually exclusive.</p>
<p>Implementations of navigate() can accept only one distinct value.</p>
<p>The Relation type is a typedef for <a href="qflags.html">QFlags</a><RelationFlag>. It stores an OR combination of RelationFlag values.</p>
<!-- @@@RelationFlag -->
<!-- $$$Role$$$NoRole$$$TitleBar$$$MenuBar$$$ScrollBar$$$Grip$$$Sound$$$Cursor$$$Caret$$$AlertMessage$$$Window$$$Client$$$PopupMenu$$$MenuItem$$$ToolTip$$$Application$$$Document$$$Pane$$$Chart$$$Dialog$$$Border$$$Grouping$$$Separator$$$ToolBar$$$StatusBar$$$Table$$$ColumnHeader$$$RowHeader$$$Column$$$Row$$$Cell$$$Link$$$HelpBalloon$$$Assistant$$$List$$$ListItem$$$Tree$$$TreeItem$$$PageTab$$$PropertyPage$$$Indicator$$$Graphic$$$StaticText$$$EditableText$$$PushButton$$$CheckBox$$$RadioButton$$$ComboBox$$$ProgressBar$$$Dial$$$HotkeyField$$$Slider$$$SpinBox$$$Canvas$$$Animation$$$Equation$$$ButtonDropDown$$$ButtonMenu$$$ButtonDropGrid$$$Whitespace$$$PageTabList$$$Clock$$$Splitter$$$LayeredPane$$$Terminal$$$Desktop$$$UserRole -->
<h3 class="fn"><a name="Role-enum"></a>enum QAccessible::<span class="name">Role</span></h3>
<p>This enum defines the role of an accessible object. The roles are:</p>
<table class="valuelist"><tr valign="top" class="odd"><th class="tblConst">Constant</th><th class="tblval">Value</th><th class="tbldscr">Description</th></tr>
<tr><td class="topAlign"><tt>QAccessible::AlertMessage</tt></td><td class="topAlign"><tt>0x00000008</tt></td><td class="topAlign">An object that is used to alert the user.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::Animation</tt></td><td class="topAlign"><tt>0x00000036</tt></td><td class="topAlign">An object that displays an animation.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::Application</tt></td><td class="topAlign"><tt>0x0000000E</tt></td><td class="topAlign">The application's main window.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::Assistant</tt></td><td class="topAlign"><tt>0x00000020</tt></td><td class="topAlign">An object that provids interactive help.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::Border</tt></td><td class="topAlign"><tt>0x00000013</tt></td><td class="topAlign">An object that represents a border.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::ButtonDropDown</tt></td><td class="topAlign"><tt>0x00000038</tt></td><td class="topAlign">A button that drops down a list of items.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::ButtonDropGrid</tt></td><td class="topAlign"><tt>0x0000003A</tt></td><td class="topAlign">A button that drops down a grid.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::ButtonMenu</tt></td><td class="topAlign"><tt>0x00000039</tt></td><td class="topAlign">A button that drops down a menu.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::Canvas</tt></td><td class="topAlign"><tt>0x00000035</tt></td><td class="topAlign">An object that displays graphics that the user can interact with.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::Caret</tt></td><td class="topAlign"><tt>0x00000007</tt></td><td class="topAlign">An object that represents the system caret (text cursor).</td></tr>
<tr><td class="topAlign"><tt>QAccessible::Cell</tt></td><td class="topAlign"><tt>0x0000001D</tt></td><td class="topAlign">A cell in a table.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::Chart</tt></td><td class="topAlign"><tt>0x00000011</tt></td><td class="topAlign">An object that displays a graphical representation of data.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::CheckBox</tt></td><td class="topAlign"><tt>0x0000002C</tt></td><td class="topAlign">An object that represents an option that can be checked or unchecked. Some options provide a "mixed" state, e.g. neither checked nor unchecked.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::Client</tt></td><td class="topAlign"><tt>0x0000000A</tt></td><td class="topAlign">The client area in a window.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::Clock</tt></td><td class="topAlign"><tt>0x0000003D</tt></td><td class="topAlign">A clock displaying time.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::Column</tt></td><td class="topAlign"><tt>0x0000001B</tt></td><td class="topAlign">A column of cells, usually within a table.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::ColumnHeader</tt></td><td class="topAlign"><tt>0x00000019</tt></td><td class="topAlign">A header for a column of data.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::ComboBox</tt></td><td class="topAlign"><tt>0x0000002E</tt></td><td class="topAlign">A list of choices that the user can select from.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::Cursor</tt></td><td class="topAlign"><tt>0x00000006</tt></td><td class="topAlign">An object that represents the mouse cursor.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::Desktop</tt></td><td class="topAlign"><tt>0x00000041</tt></td><td class="topAlign">The object represents the desktop or workspace.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::Dial</tt></td><td class="topAlign"><tt>0x00000031</tt></td><td class="topAlign">An object that represents a dial or knob.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::Dialog</tt></td><td class="topAlign"><tt>0x00000012</tt></td><td class="topAlign">A dialog box.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::Document</tt></td><td class="topAlign"><tt>0x0000000F</tt></td><td class="topAlign">A document window, usually in an MDI environment.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::EditableText</tt></td><td class="topAlign"><tt>0x0000002A</tt></td><td class="topAlign">Editable text</td></tr>
<tr><td class="topAlign"><tt>QAccessible::Equation</tt></td><td class="topAlign"><tt>0x00000037</tt></td><td class="topAlign">An object that represents a mathematical equation.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::Graphic</tt></td><td class="topAlign"><tt>0x00000028</tt></td><td class="topAlign">A graphic or picture, e.g. an icon.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::Grip</tt></td><td class="topAlign"><tt>0x00000004</tt></td><td class="topAlign">A grip that the user can drag to change the size of widgets.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::Grouping</tt></td><td class="topAlign"><tt>0x00000014</tt></td><td class="topAlign">An object that represents a logical grouping of other objects.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::HelpBalloon</tt></td><td class="topAlign"><tt>0x0000001F</tt></td><td class="topAlign">An object that displays help in a separate, short lived window.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::HotkeyField</tt></td><td class="topAlign"><tt>0x00000032</tt></td><td class="topAlign">A hotkey field that allows the user to enter a key sequence.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::Indicator</tt></td><td class="topAlign"><tt>0x00000027</tt></td><td class="topAlign">An indicator that represents a current value or item.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::LayeredPane</tt></td><td class="topAlign"><tt>0x0000003F</tt></td><td class="topAlign">An object that can contain layered children, e.g. in a stack.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::Link</tt></td><td class="topAlign"><tt>0x0000001E</tt></td><td class="topAlign">A link to something else.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::List</tt></td><td class="topAlign"><tt>0x00000021</tt></td><td class="topAlign">A list of items, from which the user can select one or more items.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::ListItem</tt></td><td class="topAlign"><tt>0x00000022</tt></td><td class="topAlign">An item in a list of items.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::MenuBar</tt></td><td class="topAlign"><tt>0x00000002</tt></td><td class="topAlign">A menu bar from which menus are opened by the user.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::MenuItem</tt></td><td class="topAlign"><tt>0x0000000C</tt></td><td class="topAlign">An item in a menu or menu bar.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::NoRole</tt></td><td class="topAlign"><tt>0x00000000</tt></td><td class="topAlign">The object has no role. This usually indicates an invalid object.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::PageTab</tt></td><td class="topAlign"><tt>0x00000025</tt></td><td class="topAlign">A page tab that the user can select to switch to a different page in a dialog.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::PageTabList</tt></td><td class="topAlign"><tt>0x0000003C</tt></td><td class="topAlign">A list of page tabs.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::Pane</tt></td><td class="topAlign"><tt>0x00000010</tt></td><td class="topAlign">A generic container.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::PopupMenu</tt></td><td class="topAlign"><tt>0x0000000B</tt></td><td class="topAlign">A menu which lists options that the user can select to perform an action.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::ProgressBar</tt></td><td class="topAlign"><tt>0x00000030</tt></td><td class="topAlign">The object displays the progress of an operation in progress.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::PropertyPage</tt></td><td class="topAlign"><tt>0x00000026</tt></td><td class="topAlign">A property page where the user can change options and settings.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::PushButton</tt></td><td class="topAlign"><tt>0x0000002B</tt></td><td class="topAlign">A button.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::RadioButton</tt></td><td class="topAlign"><tt>0x0000002D</tt></td><td class="topAlign">An object that represents an option that is mutually exclusive with other options.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::Row</tt></td><td class="topAlign"><tt>0x0000001C</tt></td><td class="topAlign">A row of cells, usually within a table.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::RowHeader</tt></td><td class="topAlign"><tt>0x0000001A</tt></td><td class="topAlign">A header for a row of data.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::ScrollBar</tt></td><td class="topAlign"><tt>0x00000003</tt></td><td class="topAlign">A scroll bar, which allows the user to scroll the visible area.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::Separator</tt></td><td class="topAlign"><tt>0x00000015</tt></td><td class="topAlign">A separator that divides space into logical areas.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::Slider</tt></td><td class="topAlign"><tt>0x00000033</tt></td><td class="topAlign">A slider that allows the user to select a value within a given range.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::Sound</tt></td><td class="topAlign"><tt>0x00000005</tt></td><td class="topAlign">An object that represents a sound.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::SpinBox</tt></td><td class="topAlign"><tt>0x00000034</tt></td><td class="topAlign">A spin box widget that allows the user to enter a value within a given range.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::Splitter</tt></td><td class="topAlign"><tt>0x0000003E</tt></td><td class="topAlign">A splitter distributing available space between its child widgets.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::StaticText</tt></td><td class="topAlign"><tt>0x00000029</tt></td><td class="topAlign">Static text, such as labels for other widgets.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::StatusBar</tt></td><td class="topAlign"><tt>0x00000017</tt></td><td class="topAlign">A status bar.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::Table</tt></td><td class="topAlign"><tt>0x00000018</tt></td><td class="topAlign">A table representing data in a grid of rows and columns.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::Terminal</tt></td><td class="topAlign"><tt>0x00000040</tt></td><td class="topAlign">A terminal or command line interface.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::TitleBar</tt></td><td class="topAlign"><tt>0x00000001</tt></td><td class="topAlign">The title bar caption of a window.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::ToolBar</tt></td><td class="topAlign"><tt>0x00000016</tt></td><td class="topAlign">A tool bar, which groups widgets that the user accesses frequently.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::ToolTip</tt></td><td class="topAlign"><tt>0x0000000D</tt></td><td class="topAlign">A tool tip which provides information about other objects.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::Tree</tt></td><td class="topAlign"><tt>0x00000023</tt></td><td class="topAlign">A list of items in a tree structure.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::TreeItem</tt></td><td class="topAlign"><tt>0x00000024</tt></td><td class="topAlign">An item in a tree structure.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::UserRole</tt></td><td class="topAlign"><tt>0x0000ffff</tt></td><td class="topAlign">The first value to be used for user defined roles.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::Whitespace</tt></td><td class="topAlign"><tt>0x0000003B</tt></td><td class="topAlign">Blank space between other objects.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::Window</tt></td><td class="topAlign"><tt>0x00000009</tt></td><td class="topAlign">A top level window.</td></tr>
</table>
<!-- @@@Role -->
<!-- $$$StateFlag$$$Normal$$$Unavailable$$$Selected$$$Focused$$$Pressed$$$Checked$$$Mixed$$$ReadOnly$$$HotTracked$$$DefaultButton$$$Expanded$$$Collapsed$$$Busy$$$Marqueed$$$Animated$$$Invisible$$$Offscreen$$$Sizeable$$$Movable$$$Moveable$$$SelfVoicing$$$Focusable$$$Selectable$$$Linked$$$Traversed$$$MultiSelectable$$$ExtSelectable$$$Protected$$$HasPopup$$$Modal$$$HasInvokeExtension -->
<h3 class="flags"><a name="StateFlag-enum"></a>enum QAccessible::<span class="name">StateFlag</span><br/>flags QAccessible::<span class="name">State</span></h3>
<p>This enum type defines bit flags that can be combined to indicate the state of an accessible object. The values are:</p>
<table class="valuelist"><tr valign="top" class="odd"><th class="tblConst">Constant</th><th class="tblval">Value</th><th class="tbldscr">Description</th></tr>
<tr><td class="topAlign"><tt>QAccessible::Animated</tt></td><td class="topAlign"><tt>0x00004000</tt></td><td class="topAlign">The object's appearance changes frequently.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::Busy</tt></td><td class="topAlign"><tt>0x00000800</tt></td><td class="topAlign">The object cannot accept input at the moment.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::Checked</tt></td><td class="topAlign"><tt>0x00000010</tt></td><td class="topAlign">The object's check box is checked.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::Collapsed</tt></td><td class="topAlign"><tt>0x00000400</tt></td><td class="topAlign">The object is collapsed, e.g. a closed listview item, or an iconified window.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::DefaultButton</tt></td><td class="topAlign"><tt>0x00000100</tt></td><td class="topAlign">The object represents the default button in a dialog.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::Expanded</tt></td><td class="topAlign"><tt>0x00000200</tt></td><td class="topAlign">The object is expandable, and currently the children are visible.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::ExtSelectable</tt></td><td class="topAlign"><tt>0x02000000</tt></td><td class="topAlign">The object supports extended selection.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::Focusable</tt></td><td class="topAlign"><tt>0x00100000</tt></td><td class="topAlign">The object can receive focus. Only objects in the active window can receive focus.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::Focused</tt></td><td class="topAlign"><tt>0x00000004</tt></td><td class="topAlign">The object has keyboard focus.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::HasPopup</tt></td><td class="topAlign"><tt>0x40000000</tt></td><td class="topAlign">The object opens a popup.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::HotTracked</tt></td><td class="topAlign"><tt>0x00000080</tt></td><td class="topAlign">The object's appearance is sensitive to the mouse cursor position.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::Invisible</tt></td><td class="topAlign"><tt>0x00008000</tt></td><td class="topAlign">The object is not visible to the user.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::Linked</tt></td><td class="topAlign"><tt>0x00400000</tt></td><td class="topAlign">The object is linked to another object, e.g. a hyperlink.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::Marqueed</tt></td><td class="topAlign"><tt>0x00002000</tt></td><td class="topAlign">The object displays scrolling contents, e.g. a log view.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::Mixed</tt></td><td class="topAlign"><tt>0x00000020</tt></td><td class="topAlign">The state of the object is not determined, e.g. a tri-state check box that is neither checked nor unchecked.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::Modal</tt></td><td class="topAlign"><tt>0x80000000</tt></td><td class="topAlign">The object blocks input from other objects.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::Movable</tt></td><td class="topAlign"><tt>0x00040000</tt></td><td class="topAlign">The object can be moved.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::MultiSelectable</tt></td><td class="topAlign"><tt>0x01000000</tt></td><td class="topAlign">The object supports multiple selected items.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::Normal</tt></td><td class="topAlign"><tt>0x00000000</tt></td><td class="topAlign">The normal state.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::Offscreen</tt></td><td class="topAlign"><tt>0x00010000</tt></td><td class="topAlign">The object is clipped by the visible area. Objects that are off screen are also invisible.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::Pressed</tt></td><td class="topAlign"><tt>0x00000008</tt></td><td class="topAlign">The object is pressed.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::Protected</tt></td><td class="topAlign"><tt>0x20000000</tt></td><td class="topAlign">The object is password protected, e.g. a line edit for entering a Password.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::ReadOnly</tt></td><td class="topAlign"><tt>0x00000040</tt></td><td class="topAlign">The object can usually be edited, but is explicitly set to read-only.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::Selectable</tt></td><td class="topAlign"><tt>0x00200000</tt></td><td class="topAlign">The object is selectable.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::Selected</tt></td><td class="topAlign"><tt>0x00000002</tt></td><td class="topAlign">The object is selected.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::SelfVoicing</tt></td><td class="topAlign"><tt>0x00080000</tt></td><td class="topAlign">The object describes itself through speech or sound.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::Sizeable</tt></td><td class="topAlign"><tt>0x00020000</tt></td><td class="topAlign">The object can be resized, e.g. top-level windows.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::Traversed</tt></td><td class="topAlign"><tt>0x00800000</tt></td><td class="topAlign">The object is linked and has been visited.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::Unavailable</tt></td><td class="topAlign"><tt>0x00000001</tt></td><td class="topAlign">The object is unavailable to the user, e.g. a disabled widget.</td></tr>
</table>
<p>Implementations of <a href="qaccessibleinterface.html#state">QAccessibleInterface::state</a>() return a combination of these flags.</p>
<p>The State type is a typedef for <a href="qflags.html">QFlags</a><StateFlag>. It stores an OR combination of StateFlag values.</p>
<!-- @@@StateFlag -->
<!-- $$$Text$$$Name$$$Description$$$Value$$$Help$$$Accelerator$$$UserText -->
<h3 class="fn"><a name="Text-enum"></a>enum QAccessible::<span class="name">Text</span></h3>
<p>This enum specifies string information that an accessible object returns.</p>
<table class="valuelist"><tr valign="top" class="odd"><th class="tblConst">Constant</th><th class="tblval">Value</th><th class="tbldscr">Description</th></tr>
<tr><td class="topAlign"><tt>QAccessible::Name</tt></td><td class="topAlign"><tt>0</tt></td><td class="topAlign">The name of the object. This can be used both as an identifier or a short description by accessible clients.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::Description</tt></td><td class="topAlign"><tt>1</tt></td><td class="topAlign">A short text describing the object.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::Value</tt></td><td class="topAlign"><tt>2</tt></td><td class="topAlign">The value of the object.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::Help</tt></td><td class="topAlign"><tt>3</tt></td><td class="topAlign">A longer text giving information about how to use the object.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::Accelerator</tt></td><td class="topAlign"><tt>4</tt></td><td class="topAlign">The keyboard shortcut that executes the object's default action.</td></tr>
<tr><td class="topAlign"><tt>QAccessible::UserText</tt></td><td class="topAlign"><tt>0x0000ffff</tt></td><td class="topAlign">The first value to be used for user defined text.</td></tr>
</table>
<!-- @@@Text -->
</div>
<div class="func">
<h2>Member Function Documentation</h2>
<!-- $$$installFactory[overload1]$$$installFactoryInterfaceFactory -->
<h3 class="fn"><a name="installFactory"></a><span class="type">void</span> QAccessible::<span class="name">installFactory</span> ( <span class="type"><a href="qaccessible.html#InterfaceFactory-typedef">InterfaceFactory</a></span> <i>factory</i> )<tt> [static]</tt></h3>
<p>Installs the <a href="qaccessible.html#InterfaceFactory-typedef">InterfaceFactory</a> <i>factory</i>. The last factory added is the first one used by <a href="qaccessible.html#queryAccessibleInterface">queryAccessibleInterface</a>().</p>
<!-- @@@installFactory -->
<!-- $$$installRootObjectHandler[overload1]$$$installRootObjectHandlerRootObjectHandler -->
<h3 class="fn"><a name="installRootObjectHandler"></a><span class="type">RootObjectHandler</span> QAccessible::<span class="name">installRootObjectHandler</span> ( <span class="type">RootObjectHandler</span> <i>handler</i> )<tt> [static]</tt></h3>
<p>Installs the given <i>handler</i> as the function to be used by <a href="qaccessible.html#setRootObject">setRootObject</a>(), and returns the previously installed handler.</p>
<!-- @@@installRootObjectHandler -->
<!-- $$$isActive[overload1]$$$isActive -->
<h3 class="fn"><a name="isActive"></a><span class="type">bool</span> QAccessible::<span class="name">isActive</span> ()<tt> [static]</tt></h3>
<p>Returns true if an accessibility implementation has been requested during the runtime of the application; otherwise returns false.</p>
<p>Use this function to prevent potentially expensive notifications via <a href="qaccessible.html#updateAccessibility">updateAccessibility</a>().</p>
<!-- @@@isActive -->
<!-- $$$queryAccessibleInterface[overload1]$$$queryAccessibleInterfaceQObject* -->
<h3 class="fn"><a name="queryAccessibleInterface"></a><span class="type"><a href="qaccessibleinterface.html">QAccessibleInterface</a></span> * QAccessible::<span class="name">queryAccessibleInterface</span> ( <span class="type"><a href="qobject.html">QObject</a></span> * <i>object</i> )<tt> [static]</tt></h3>
<p>If a <a href="qaccessibleinterface.html">QAccessibleInterface</a> implementation exists for the given <i>object</i>, this function returns a pointer to the implementation; otherwise it returns 0.</p>
<p>The function calls all installed factory functions (from most recently installed to least recently installed) until one is found that provides an interface for the class of <i>object</i>. If no factory can provide an accessibility implementation for the class the function loads installed accessibility plugins, and tests if any of the plugins can provide the implementation.</p>
<p>If no implementation for the object's class is available, the function tries to find an implementation for the object's parent class, using the above strategy.</p>
<p><b>Warning:</b> The caller is responsible for deleting the returned interface after use.</p>
<!-- @@@queryAccessibleInterface -->
<!-- $$$removeFactory[overload1]$$$removeFactoryInterfaceFactory -->
<h3 class="fn"><a name="removeFactory"></a><span class="type">void</span> QAccessible::<span class="name">removeFactory</span> ( <span class="type"><a href="qaccessible.html#InterfaceFactory-typedef">InterfaceFactory</a></span> <i>factory</i> )<tt> [static]</tt></h3>
<p>Removes <i>factory</i> from the list of installed InterfaceFactories.</p>
<!-- @@@removeFactory -->
<!-- $$$setRootObject[overload1]$$$setRootObjectQObject* -->
<h3 class="fn"><a name="setRootObject"></a><span class="type">void</span> QAccessible::<span class="name">setRootObject</span> ( <span class="type"><a href="qobject.html">QObject</a></span> * <i>object</i> )<tt> [static]</tt></h3>
<p>Sets the root accessible object of this application to <i>object</i>. All other accessible objects in the application can be reached by the client using object navigation.</p>
<p>You should never need to call this function. Qt sets the <a href="qapplication.html">QApplication</a> object as the root object immediately before the event loop is entered in <a href="qapplication.html#exec">QApplication::exec</a>().</p>
<p>Use <a href="qaccessible.html#installRootObjectHandler">QAccessible::installRootObjectHandler</a>() to redirect the function call to a customized handler function.</p>
<p><b>See also </b><a href="qaccessible.html#queryAccessibleInterface">queryAccessibleInterface</a>().</p>
<!-- @@@setRootObject -->
<!-- $$$updateAccessibility[overload1]$$$updateAccessibilityQObject*intEvent -->
<h3 class="fn"><a name="updateAccessibility"></a><span class="type">void</span> QAccessible::<span class="name">updateAccessibility</span> ( <span class="type"><a href="qobject.html">QObject</a></span> * <i>object</i>, <span class="type">int</span> <i>child</i>, <span class="type"><a href="qaccessible.html#Event-enum">Event</a></span> <i>reason</i> )<tt> [static]</tt></h3>
<p>Notifies accessibility clients about a change in <i>object</i>'s accessibility information.</p>
<p><i>reason</i> specifies the cause of the change, for example, <tt>ValueChange</tt> when the position of a slider has been changed. <i>child</i> is the (1-based) index of the child element that has changed. When <i>child</i> is 0, the object itself has changed.</p>
<p>Call this function whenever the state of your accessible object or one of its sub-elements has been changed either programmatically (e.g. by calling <a href="qlabel.html#text-prop">QLabel::setText</a>()) or by user interaction.</p>
<p>If there are no accessibility tools listening to this event, the performance penalty for calling this function is small, but if determining the parameters of the call is expensive you can test <a href="qaccessible.html#isActive">isActive</a>() to avoid unnecessary computations.</p>
<!-- @@@updateAccessibility -->
</div>
</div>
</div>
</div>
<div class="ft">
<span></span>
</div>
</div>
<div class="footer">
<p>
<acronym title="Copyright">©</acronym> 2015 The Qt Company Ltd.
Documentation contributions included herein are the copyrights of
their respective owners.</p>
<br />
<p>
The documentation provided herein is licensed under the terms of the
<a href="http://www.gnu.org/licenses/fdl.html">GNU Free Documentation
License version 1.3</a> as published by the Free Software Foundation.</p>
<p>
Documentation sources may be obtained from <a href="http://www.qt-project.org">
www.qt-project.org</a>.</p>
<br />
<p>
Qt and respective logos are trademarks of The Qt Company Ltd
in Finland and/or other countries worldwide. All other trademarks are property
of their respective owners. <a title="Privacy Policy"
href="http://en.gitorious.org/privacy_policy/">Privacy Policy</a></p>
</div>
<script src="scripts/functions.js" type="text/javascript"></script>
</body>
</html>
