summaryrefslogtreecommitdiffstats
path: root/doc/html/qaccessibleinterface.html
blob: 5b11b16e4d0eeb8818cf7d8deb31441cfcfab529 (plain)
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>TQAccessibleInterface 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&nbsp;Classes</font></a>
 | <a href="mainclasses.html">
<font color="#004faf">Main&nbsp;Classes</font></a>
 | <a href="annotated.html">
<font color="#004faf">Annotated</font></a>
 | <a href="groups.html">
<font color="#004faf">Grouped&nbsp;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>TQAccessibleInterface Class Reference</h1>

<p>The TQAccessibleInterface class defines an interface that exposes information about accessible objects.
<a href="#details">More...</a>
<p><tt>#include &lt;<a href="qaccessible-h.html">qaccessible.h</a>&gt;</tt>
<p>Inherits <a href="qaccessible.html">TQAccessible</a>.
<p>Inherited by <a href="qaccessibleobject.html">TQAccessibleObject</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 TQRESULT <a href="#queryChild"><b>queryChild</b></a> ( int&nbsp;control, TQAccessibleInterface&nbsp;**&nbsp;iface ) const = 0</li>
<li class=fn>virtual TQRESULT <a href="#queryParent"><b>queryParent</b></a> ( TQAccessibleInterface&nbsp;**&nbsp;iface ) const = 0</li>
<li class=fn>virtual int <a href="#controlAt"><b>controlAt</b></a> ( int&nbsp;x, int&nbsp;y ) const = 0</li>
<li class=fn>virtual TQRect <a href="#rect"><b>rect</b></a> ( int&nbsp;control ) const = 0</li>
<li class=fn>virtual int <a href="#navigate"><b>navigate</b></a> ( NavDirection&nbsp;direction, int&nbsp;startControl ) const = 0</li>
<li class=fn>virtual TQString <a href="#text"><b>text</b></a> ( Text&nbsp;t, int&nbsp;control ) const = 0</li>
<li class=fn>virtual void <a href="#setText"><b>setText</b></a> ( Text&nbsp;t, int&nbsp;control, const&nbsp;TQString&nbsp;&amp;&nbsp;text ) = 0</li>
<li class=fn>virtual Role <a href="#role"><b>role</b></a> ( int&nbsp;control ) const = 0</li>
<li class=fn>virtual State <a href="#state"><b>state</b></a> ( int&nbsp;control ) const = 0</li>
<li class=fn>virtual TQMemArray&lt;int&gt; <a href="#selection"><b>selection</b></a> () const = 0</li>
<li class=fn>virtual bool <a href="#doDefaultAction"><b>doDefaultAction</b></a> ( int&nbsp;control ) = 0</li>
<li class=fn>virtual bool <a href="#setFocus"><b>setFocus</b></a> ( int&nbsp;control ) = 0</li>
<li class=fn>virtual bool <a href="#setSelected"><b>setSelected</b></a> ( int&nbsp;control, bool&nbsp;on, bool&nbsp;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 TQAccessibleInterface 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>TQAccessibleInterface::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>TQAccessibleInterface::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>TQAccessibleInterface::controlAt ( int&nbsp;x, int&nbsp;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>TQAccessibleInterface::doDefaultAction ( int&nbsp;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>TQAccessibleInterface::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>TQAccessibleInterface::navigate ( <a href="qaccessible.html#NavDirection-enum">NavDirection</a>&nbsp;direction, int&nbsp;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>TQRESULT <a name="queryChild"></a>TQAccessibleInterface::queryChild ( int&nbsp;control, <a href="qaccessibleinterface.html">TQAccessibleInterface</a>&nbsp;**&nbsp;iface ) const<tt> [pure virtual]</tt>
</h3>

<p> Sets <em>iface</em> to point to the implementation of the
TQAccessibleInterface 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>TQRESULT <a name="queryParent"></a>TQAccessibleInterface::queryParent ( <a href="qaccessibleinterface.html">TQAccessibleInterface</a>&nbsp;**&nbsp;iface ) const<tt> [pure virtual]</tt>
</h3>

<p> Sets <em>iface</em> to point to the implementation of the
TQAccessibleInterface 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">TQRect</a> <a name="rect"></a>TQAccessibleInterface::rect ( int&nbsp;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>TQAccessibleInterface::role ( int&nbsp;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">TQMemArray</a>&lt;int&gt; <a name="selection"></a>TQAccessibleInterface::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>TQAccessibleInterface::setFocus ( int&nbsp;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>TQAccessibleInterface::setSelected ( int&nbsp;control, bool&nbsp;on, bool&nbsp;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>TQAccessibleInterface::setText ( <a href="qaccessible.html#Text-enum">Text</a>&nbsp;t, int&nbsp;control, const&nbsp;<a href="qstring.html">TQString</a>&nbsp;&amp;&nbsp;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>TQAccessibleInterface::state ( int&nbsp;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">TQString</a> <a name="text"></a>TQAccessibleInterface::text ( <a href="qaccessible.html#Text-enum">Text</a>&nbsp;t, int&nbsp;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">TQt toolkit</a>.
Copyright &copy; 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 &copy; 2007
<a href="troll.html">Trolltech</a><td align=center><a href="trademarks.html">Trademarks</a>
<td align=right><div align=right>TQt 3.3.8</div>
</table></div></address></body>
</html>