/usr/share/qt3/doc/html/qaccessibleinterface.html is in qt3-doc 3:3.3.8-b-8ubuntu3.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 | <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<!-- /home/espenr/tmp/qt-3.3.8-espenr-2499/qt-x11-free-3.3.8/src/kernel/qaccessible.cpp:421 -->
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
<title>QAccessibleInterface Class</title>
<style type="text/css"><!--
fn { margin-left: 1cm; text-indent: -1cm; }
a:link { color: #004faf; text-decoration: none }
a:visited { color: #672967; text-decoration: none }
body { background: #ffffff; color: black; }
--></style>
</head>
<body>
<table border="0" cellpadding="0" cellspacing="0" width="100%">
<tr bgcolor="#E5E5E5">
<td valign=center>
<a href="index.html">
<font color="#004faf">Home</font></a>
| <a href="classes.html">
<font color="#004faf">All Classes</font></a>
| <a href="mainclasses.html">
<font color="#004faf">Main Classes</font></a>
| <a href="annotated.html">
<font color="#004faf">Annotated</font></a>
| <a href="groups.html">
<font color="#004faf">Grouped Classes</font></a>
| <a href="functions.html">
<font color="#004faf">Functions</font></a>
</td>
<td align="right" valign="center"><img src="logo32.png" align="right" width="64" height="32" border="0"></td></tr></table><h1 align=center>QAccessibleInterface Class Reference</h1>
<p>The QAccessibleInterface class defines an interface that exposes information about accessible objects.
<a href="#details">More...</a>
<p><tt>#include <<a href="qaccessible-h.html">qaccessible.h</a>></tt>
<p>Inherits <a href="qaccessible.html">QAccessible</a>.
<p>Inherited by <a href="qaccessibleobject.html">QAccessibleObject</a>.
<p><a href="qaccessibleinterface-members.html">List of all member functions.</a>
<h2>Public Members</h2>
<ul>
<li class=fn>virtual bool <a href="#isValid"><b>isValid</b></a> () const = 0</li>
<li class=fn>virtual int <a href="#childCount"><b>childCount</b></a> () const = 0</li>
<li class=fn>virtual QRESULT <a href="#queryChild"><b>queryChild</b></a> ( int control, QAccessibleInterface ** iface ) const = 0</li>
<li class=fn>virtual QRESULT <a href="#queryParent"><b>queryParent</b></a> ( QAccessibleInterface ** iface ) const = 0</li>
<li class=fn>virtual int <a href="#controlAt"><b>controlAt</b></a> ( int x, int y ) const = 0</li>
<li class=fn>virtual QRect <a href="#rect"><b>rect</b></a> ( int control ) const = 0</li>
<li class=fn>virtual int <a href="#navigate"><b>navigate</b></a> ( NavDirection direction, int startControl ) const = 0</li>
<li class=fn>virtual QString <a href="#text"><b>text</b></a> ( Text t, int control ) const = 0</li>
<li class=fn>virtual void <a href="#setText"><b>setText</b></a> ( Text t, int control, const QString & text ) = 0</li>
<li class=fn>virtual Role <a href="#role"><b>role</b></a> ( int control ) const = 0</li>
<li class=fn>virtual State <a href="#state"><b>state</b></a> ( int control ) const = 0</li>
<li class=fn>virtual QMemArray<int> <a href="#selection"><b>selection</b></a> () const = 0</li>
<li class=fn>virtual bool <a href="#doDefaultAction"><b>doDefaultAction</b></a> ( int control ) = 0</li>
<li class=fn>virtual bool <a href="#setFocus"><b>setFocus</b></a> ( int control ) = 0</li>
<li class=fn>virtual bool <a href="#setSelected"><b>setSelected</b></a> ( int control, bool on, bool extend ) = 0</li>
<li class=fn>virtual void <a href="#clearSelection"><b>clearSelection</b></a> () = 0</li>
</ul>
<hr><a name="details"></a><h2>Detailed Description</h2>
The QAccessibleInterface class defines an interface that exposes information about accessible objects.
<p>
<p>See also <a href="misc.html">Miscellaneous Classes</a>.
<hr><h2>Member Function Documentation</h2>
<h3 class=fn>int <a name="childCount"></a>QAccessibleInterface::childCount () const<tt> [pure virtual]</tt>
</h3>
<p> Returns the number of children that belong to this object. A child
can provide accessibility information on it's own (e.g. a child
widget), or be a sub-element of this accessible object.
<p> All objects provide this information.
<p> <p>See also <a href="#queryChild">queryChild</a>().
<h3 class=fn>void <a name="clearSelection"></a>QAccessibleInterface::clearSelection ()<tt> [pure virtual]</tt>
</h3>
<p> Removes any selection from the object.
<p> <p>See also <a href="#setSelected">setSelected</a>().
<h3 class=fn>int <a name="controlAt"></a>QAccessibleInterface::controlAt ( int x, int y ) const<tt> [pure virtual]</tt>
</h3>
<p> Returns the ID of the child that contains the screen coordinates
(<em>x</em>, <em>y</em>). This function returns 0 if the point is positioned
on the object itself. If the tested point is outside the
boundaries of the object this function returns -1.
<p> All visual objects provide this information.
<h3 class=fn>bool <a name="doDefaultAction"></a>QAccessibleInterface::doDefaultAction ( int control )<tt> [pure virtual]</tt>
</h3>
<p> Calling this function performs the default action of the child
object specified by <em>control</em>, or the default action of the
object itself if <em>control</em> is 0.
<h3 class=fn>bool <a name="isValid"></a>QAccessibleInterface::isValid () const<tt> [pure virtual]</tt>
</h3>
<p> Returns TRUE if all the data necessary to use this interface
implementation is valid (e.g. all pointers are non-null),
otherwise returns FALSE.
<h3 class=fn>int <a name="navigate"></a>QAccessibleInterface::navigate ( <a href="qaccessible.html#NavDirection-enum">NavDirection</a> direction, int startControl ) const<tt> [pure virtual]</tt>
</h3>
<p> This function traverses to another object, or to a sub-element of
the current object. <em>direction</em> specifies in which direction to
navigate, and <em>startControl</em> specifies the start point of the
navigation, which is either 0 if the navigation starts at the
object itself, or an ID of one of the object's sub-elements.
<p> The function returns the ID of the sub-element located in the <em>direction</em> specified. If there is nothing in the navigated <em>direction</em>, this function returns -1.
<p> All objects support navigation.
<h3 class=fn>QRESULT <a name="queryChild"></a>QAccessibleInterface::queryChild ( int control, <a href="qaccessibleinterface.html">QAccessibleInterface</a> ** iface ) const<tt> [pure virtual]</tt>
</h3>
<p> Sets <em>iface</em> to point to the implementation of the
QAccessibleInterface for the child specified with <em>control</em>. If
the child doesn't provide accessibility information on it's own,
the value of <em>iface</em> is set to 0. For those elements, this
object is responsible for exposing the child's properties.
<p> All objects provide this information.
<p> <p>See also <a href="#childCount">childCount</a>() and <a href="#queryParent">queryParent</a>().
<h3 class=fn>QRESULT <a name="queryParent"></a>QAccessibleInterface::queryParent ( <a href="qaccessibleinterface.html">QAccessibleInterface</a> ** iface ) const<tt> [pure virtual]</tt>
</h3>
<p> Sets <em>iface</em> to point to the implementation of the
QAccessibleInterface for the parent object, or to 0 if there is
no such implementation or object.
<p> All objects provide this information.
<p> <p>See also <a href="#queryChild">queryChild</a>().
<h3 class=fn><a href="qrect.html">QRect</a> <a name="rect"></a>QAccessibleInterface::rect ( int control ) const<tt> [pure virtual]</tt>
</h3>
<p> Returns the location of the child specified with <em>control</em> in
screen coordinates. This function returns the location of the
object itself if <em>control</em> is 0.
<p> All visual objects provide this information.
<h3 class=fn><a href="qaccessible.html#Role-enum">Role</a> <a name="role"></a>QAccessibleInterface::role ( int control ) const<tt> [pure virtual]</tt>
</h3>
<p> Returns the role of the object if <em>control</em> is 0, or the role of
the object's sub-element with ID <em>control</em>. The role of an object
is usually static. All accessible objects have a role.
<p> <p>See also <a href="#text">text</a>(), <a href="#state">state</a>(), and <a href="#selection">selection</a>().
<h3 class=fn><a href="qmemarray.html">QMemArray</a><int> <a name="selection"></a>QAccessibleInterface::selection () const<tt> [pure virtual]</tt>
</h3>
<p> Returns the list of all the element IDs that are selected.
<p> <p>See also <a href="#text">text</a>(), <a href="#role">role</a>(), and <a href="#state">state</a>().
<h3 class=fn>bool <a name="setFocus"></a>QAccessibleInterface::setFocus ( int control )<tt> [pure virtual]</tt>
</h3>
<p> Gives the focus to the child object specified by <em>control</em>, or to
the object itself if <em>control</em> is 0.
<p> Returns TRUE if the focus could be set; otherwise returns FALSE.
<h3 class=fn>bool <a name="setSelected"></a>QAccessibleInterface::setSelected ( int control, bool on, bool extend )<tt> [pure virtual]</tt>
</h3>
<p> Sets the selection of the child object with ID <em>control</em> to <em>on</em>. If <em>extend</em> is TRUE, all child elements between the focused
item and the specified child object have their selection set to <em>on</em>.
<p> Returns TRUE if the selection could be set; otherwise returns
FALSE.
<p> <p>See also <a href="#setFocus">setFocus</a>() and <a href="#clearSelection">clearSelection</a>().
<h3 class=fn>void <a name="setText"></a>QAccessibleInterface::setText ( <a href="qaccessible.html#Text-enum">Text</a> t, int control, const <a href="qstring.html">QString</a> & text )<tt> [pure virtual]</tt>
</h3>
<p> Sets the text property <em>t</em> of the child object <em>control</em> to <em>text</em>. If <em>control</em> is 0, the text property of the object itself
is set.
<h3 class=fn><a href="qaccessible.html#State-enum">State</a> <a name="state"></a>QAccessibleInterface::state ( int control ) const<tt> [pure virtual]</tt>
</h3>
<p> Returns the current state of the object if <em>control</em> is 0, or the
state of the object's sub-element element with ID <em>control</em>. All
objects have a state.
<p> <p>See also <a href="#text">text</a>(), <a href="#role">role</a>(), and <a href="#selection">selection</a>().
<h3 class=fn><a href="qstring.html">QString</a> <a name="text"></a>QAccessibleInterface::text ( <a href="qaccessible.html#Text-enum">Text</a> t, int control ) const<tt> [pure virtual]</tt>
</h3>
<p> Returns a string property <em>t</em> of the child object specified by <em>control</em>, or the string property of the object itself if <em>control</em>
is 0.
<p> The <em>Name</em> is a string used by clients to identify, find or
announce an accessible object for the user. All objects must have
a name that is unique within their container.
<p> An accessible object's <em>Description</em> provides textual information
about an object's visual appearance. The description is primarily
used to provide greater context for low-vision or blind users, but
is also used for context searching or other applications. Not all
objects have a description. An "OK" button would not need a
description, but a toolbutton that shows a picture of a smiley
would.
<p> The <em>Value</em> of an accessible object represents visual information
contained by the object, e.g. the text in a line edit. Usually,
the value can be modified by the user. Not all objects have a
value, e.g. static text labels don't, and some objects have a
state that already is the value, e.g. toggle buttons.
<p> The <em>Help</em> text provides information about the function and
usage of an accessible object. Not all objects provide this
information.
<p> An accessible object's <em>DefaultAction</em> describes the object's
primary method of manipulation, and should be a verb or a short
phrase, e.g. "Press" for a button.
<p> The accelerator is a keyboard shortcut that activates the default
action of the object. A keyboard shortcut is the underlined
character in the text of a menu, menu item or control, and is
either the character itself, or a combination of this character
and a modifier key like ALT, CTRL or SHIFT. Command controls like
tool buttons also have shortcut keys and usually display them in
their tooltip.
<p> <p>See also <a href="#role">role</a>(), <a href="#state">state</a>(), and <a href="#selection">selection</a>().
<!-- eof -->
<hr><p>
This file is part of the <a href="index.html">Qt toolkit</a>.
Copyright © 1995-2007
<a href="http://www.trolltech.com/">Trolltech</a>. All Rights Reserved.<p><address><hr><div align=center>
<table width=100% cellspacing=0 border=0><tr>
<td>Copyright © 2007
<a href="troll.html">Trolltech</a><td align=center><a href="trademarks.html">Trademarks</a>
<td align=right><div align=right>Qt 3.3.8</div>
</table></div></address></body>
</html>
|