4
4
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5
5
<title>AccessibleImage Interface</title>
6
<meta name="generator" content="DocBook XSL Stylesheets V1.75.1">
7
<link rel="home" href="index.html" title="AT-SPI C Bindings Reference Manual">
6
<meta name="generator" content="DocBook XSL Stylesheets V1.69.1">
7
<link rel="start" href="index.html" title="AT-SPI C Bindings Reference Manual">
8
8
<link rel="up" href="spi-component.html" title="Subinterface Methods">
9
9
<link rel="prev" href="at-spi-cspi-AccessibleHypertext-Interface.html" title="AccessibleHypertext Interface">
10
10
<link rel="next" href="at-spi-cspi-AccessibleSelection-Interface.html" title="AccessibleSelection Interface">
31
31
<a href="#at-spi-cspi-AccessibleImage-Interface.description" class="shortcut">Description</a>
34
<div class="refentry" title="AccessibleImage Interface">
34
<div class="refentry" lang="en">
35
35
<a name="at-spi-cspi-AccessibleImage-Interface"></a><div class="titlepage"></div>
36
36
<div class="refnamediv"><table width="100%"><tr>
38
38
<h2><span class="refentrytitle"><a name="at-spi-cspi-AccessibleImage-Interface.top_of_page"></a>AccessibleImage Interface</span></h2>
39
<p>AccessibleImage Interface</p>
39
<p>AccessibleImage Interface — </p>
41
41
<td valign="top" align="right"></td>
42
42
</tr></table></div>
43
<div class="refsynopsisdiv" title="Synopsis">
43
<div class="refsynopsisdiv">
44
44
<a name="at-spi-cspi-AccessibleImage-Interface.synopsis"></a><h2>Synopsis</h2>
45
45
<pre class="synopsis">
46
void <a class="link" href="at-spi-cspi-AccessibleImage-Interface.html#AccessibleImage-ref" title="AccessibleImage_ref ()">AccessibleImage_ref</a> (AccessibleImage *obj);
47
void <a class="link" href="at-spi-cspi-AccessibleImage-Interface.html#AccessibleImage-unref" title="AccessibleImage_unref ()">AccessibleImage_unref</a> (AccessibleImage *obj);
48
char * <a class="link" href="at-spi-cspi-AccessibleImage-Interface.html#AccessibleImage-getImageDescription" title="AccessibleImage_getImageDescription ()">AccessibleImage_getImageDescription</a> (AccessibleImage *obj);
49
void <a class="link" href="at-spi-cspi-AccessibleImage-Interface.html#AccessibleImage-getImageSize" title="AccessibleImage_getImageSize ()">AccessibleImage_getImageSize</a> (AccessibleImage *obj,
46
void <a href="at-spi-cspi-AccessibleImage-Interface.html#AccessibleImage-ref" title="AccessibleImage_ref ()">AccessibleImage_ref</a> (AccessibleImage *obj);
47
void <a href="at-spi-cspi-AccessibleImage-Interface.html#AccessibleImage-unref" title="AccessibleImage_unref ()">AccessibleImage_unref</a> (AccessibleImage *obj);
48
char * <a href="at-spi-cspi-AccessibleImage-Interface.html#AccessibleImage-getImageDescription" title="AccessibleImage_getImageDescription ()">AccessibleImage_getImageDescription</a> (AccessibleImage *obj);
49
void <a href="at-spi-cspi-AccessibleImage-Interface.html#AccessibleImage-getImageSize" title="AccessibleImage_getImageSize ()">AccessibleImage_getImageSize</a> (AccessibleImage *obj,
52
void <a class="link" href="at-spi-cspi-AccessibleImage-Interface.html#AccessibleImage-getImagePosition" title="AccessibleImage_getImagePosition ()">AccessibleImage_getImagePosition</a> (AccessibleImage *obj,
52
void <a href="at-spi-cspi-AccessibleImage-Interface.html#AccessibleImage-getImagePosition" title="AccessibleImage_getImagePosition ()">AccessibleImage_getImagePosition</a> (AccessibleImage *obj,
55
<a class="link" href="at-spi-cspi-AccessibleComponent-Interface.html#AccessibleCoordType" title="enum AccessibleCoordType">AccessibleCoordType</a> ctype);
56
void <a class="link" href="at-spi-cspi-AccessibleImage-Interface.html#AccessibleImage-getImageExtents" title="AccessibleImage_getImageExtents ()">AccessibleImage_getImageExtents</a> (AccessibleImage *obj,
55
<a href="at-spi-cspi-AccessibleComponent-Interface.html#AccessibleCoordType" title="enum AccessibleCoordType">AccessibleCoordType</a> ctype);
56
void <a href="at-spi-cspi-AccessibleImage-Interface.html#AccessibleImage-getImageExtents" title="AccessibleImage_getImageExtents ()">AccessibleImage_getImageExtents</a> (AccessibleImage *obj,
61
<a class="link" href="at-spi-cspi-AccessibleComponent-Interface.html#AccessibleCoordType" title="enum AccessibleCoordType">AccessibleCoordType</a> ctype);
62
char * <a class="link" href="at-spi-cspi-AccessibleImage-Interface.html#AccessibleImage-getImageLocale" title="AccessibleImage_getImageLocale ()">AccessibleImage_getImageLocale</a> (AccessibleImage *obj);
61
<a href="at-spi-cspi-AccessibleComponent-Interface.html#AccessibleCoordType" title="enum AccessibleCoordType">AccessibleCoordType</a> ctype);
62
char * <a href="at-spi-cspi-AccessibleImage-Interface.html#AccessibleImage-getImageLocale" title="AccessibleImage_getImageLocale ()">AccessibleImage_getImageLocale</a> (AccessibleImage *obj);
65
<div class="refsect1" title="Description">
65
<div class="refsect1" lang="en">
66
66
<a name="at-spi-cspi-AccessibleImage-Interface.description"></a><h2>Description</h2>
70
<div class="refsect1" title="Details">
70
<div class="refsect1" lang="en">
71
71
<a name="at-spi-cspi-AccessibleImage-Interface.details"></a><h2>Details</h2>
72
<div class="refsect2" title="AccessibleImage_ref ()">
72
<div class="refsect2" lang="en">
73
73
<a name="AccessibleImage-ref"></a><h3>AccessibleImage_ref ()</h3>
74
74
<pre class="programlisting">void AccessibleImage_ref (AccessibleImage *obj);</pre>
79
79
<div class="variablelist"><table border="0">
80
80
<col align="left" valign="top">
82
<td><p><span class="term"><em class="parameter"><code>obj</code></em> :</span></p></td>
83
<span class="term"><em class="parameter"><code>obj</code></em> :</span></td>
83
84
<td> a pointer to the <span class="type">AccessibleImage</span> implementor on which to operate.
89
<div class="refsect2" title="AccessibleImage_unref ()">
90
<div class="refsect2" lang="en">
90
91
<a name="AccessibleImage-unref"></a><h3>AccessibleImage_unref ()</h3>
91
92
<pre class="programlisting">void AccessibleImage_unref (AccessibleImage *obj);</pre>
96
97
<div class="variablelist"><table border="0">
97
98
<col align="left" valign="top">
99
<td><p><span class="term"><em class="parameter"><code>obj</code></em> :</span></p></td>
101
<span class="term"><em class="parameter"><code>obj</code></em> :</span></td>
100
102
<td> a pointer to the <span class="type">AccessibleImage</span> implementor on which to operate.
106
<div class="refsect2" title="AccessibleImage_getImageDescription ()">
108
<div class="refsect2" lang="en">
107
109
<a name="AccessibleImage-getImageDescription"></a><h3>AccessibleImage_getImageDescription ()</h3>
108
110
<pre class="programlisting">char * AccessibleImage_getImageDescription (AccessibleImage *obj);</pre>
114
116
<col align="left" valign="top">
117
<td><p><span class="term"><em class="parameter"><code>obj</code></em> :</span></p></td>
120
<span class="term"><em class="parameter"><code>obj</code></em> :</span></td>
118
121
<td> a pointer to the <span class="type">AccessibleImage</span> implementor on which to operate.
122
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
126
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
123
127
<td> a UTF-8 string describing the image.
140
144
<col align="left" valign="top">
143
<td><p><span class="term"><em class="parameter"><code>obj</code></em> :</span></p></td>
148
<span class="term"><em class="parameter"><code>obj</code></em> :</span></td>
144
149
<td> a pointer to the <span class="type">AccessibleImage</span> to query.
148
<td><p><span class="term"><em class="parameter"><code>width</code></em> :</span></p></td>
154
<span class="term"><em class="parameter"><code>width</code></em> :</span></td>
149
155
<td> a pointer to a <span class="type">long</span> into which the x extents (width) will be returned.
153
<td><p><span class="term"><em class="parameter"><code>height</code></em> :</span></p></td>
160
<span class="term"><em class="parameter"><code>height</code></em> :</span></td>
154
161
<td> a pointer to a <span class="type">long</span> into which the y extents (height) will be returned.
161
<div class="refsect2" title="AccessibleImage_getImagePosition ()">
168
<div class="refsect2" lang="en">
162
169
<a name="AccessibleImage-getImagePosition"></a><h3>AccessibleImage_getImagePosition ()</h3>
163
170
<pre class="programlisting">void AccessibleImage_getImagePosition (AccessibleImage *obj,
166
<a class="link" href="at-spi-cspi-AccessibleComponent-Interface.html#AccessibleCoordType" title="enum AccessibleCoordType">AccessibleCoordType</a> ctype);</pre>
173
<a href="at-spi-cspi-AccessibleComponent-Interface.html#AccessibleCoordType" title="enum AccessibleCoordType">AccessibleCoordType</a> ctype);</pre>
168
175
Get the minimum x and y coordinates of the image displayed in a
169
176
specified <span class="type">AccessibleImage</span> implementor.</p>
173
180
<col align="left" valign="top">
176
<td><p><span class="term"><em class="parameter"><code>obj</code></em> :</span></p></td>
184
<span class="term"><em class="parameter"><code>obj</code></em> :</span></td>
177
185
<td> a pointer to the <span class="type">AccessibleImage</span> implementor to query.
181
<td><p><span class="term"><em class="parameter"><code>x</code></em> :</span></p></td>
190
<span class="term"><em class="parameter"><code>x</code></em> :</span></td>
182
191
<td> a pointer to a <span class="type">long</span> into which the minimum x coordinate will be returned.
186
<td><p><span class="term"><em class="parameter"><code>y</code></em> :</span></p></td>
196
<span class="term"><em class="parameter"><code>y</code></em> :</span></td>
187
197
<td> a pointer to a <span class="type">long</span> into which the minimum y coordinate will be returned.
191
<td><p><span class="term"><em class="parameter"><code>ctype</code></em> :</span></p></td>
202
<span class="term"><em class="parameter"><code>ctype</code></em> :</span></td>
192
203
<td> the desired coordinate system into which to return the results,
193
204
(e.g. SPI_COORD_TYPE_WINDOW, SPI_COORD_TYPE_SCREEN).
200
<div class="refsect2" title="AccessibleImage_getImageExtents ()">
211
<div class="refsect2" lang="en">
201
212
<a name="AccessibleImage-getImageExtents"></a><h3>AccessibleImage_getImageExtents ()</h3>
202
213
<pre class="programlisting">void AccessibleImage_getImageExtents (AccessibleImage *obj,
206
217
long int *height,
207
<a class="link" href="at-spi-cspi-AccessibleComponent-Interface.html#AccessibleCoordType" title="enum AccessibleCoordType">AccessibleCoordType</a> ctype);</pre>
218
<a href="at-spi-cspi-AccessibleComponent-Interface.html#AccessibleCoordType" title="enum AccessibleCoordType">AccessibleCoordType</a> ctype);</pre>
209
220
Get the bounding box of the image displayed in a
210
221
specified <span class="type">AccessibleImage</span> implementor.</p>
214
225
<col align="left" valign="top">
217
<td><p><span class="term"><em class="parameter"><code>obj</code></em> :</span></p></td>
229
<span class="term"><em class="parameter"><code>obj</code></em> :</span></td>
218
230
<td> a pointer to the <span class="type">AccessibleImage</span> implementor to query.
222
<td><p><span class="term"><em class="parameter"><code>x</code></em> :</span></p></td>
235
<span class="term"><em class="parameter"><code>x</code></em> :</span></td>
223
236
<td> a pointer to a <span class="type">long</span> into which the minimum x coordinate will be returned.
227
<td><p><span class="term"><em class="parameter"><code>y</code></em> :</span></p></td>
241
<span class="term"><em class="parameter"><code>y</code></em> :</span></td>
228
242
<td> a pointer to a <span class="type">long</span> into which the minimum y coordinate will be returned.
232
<td><p><span class="term"><em class="parameter"><code>width</code></em> :</span></p></td>
247
<span class="term"><em class="parameter"><code>width</code></em> :</span></td>
233
248
<td> a pointer to a <span class="type">long</span> into which the image x extent will be returned.
237
<td><p><span class="term"><em class="parameter"><code>height</code></em> :</span></p></td>
253
<span class="term"><em class="parameter"><code>height</code></em> :</span></td>
238
254
<td> a pointer to a <span class="type">long</span> into which the image y extent will be returned.
242
<td><p><span class="term"><em class="parameter"><code>ctype</code></em> :</span></p></td>
259
<span class="term"><em class="parameter"><code>ctype</code></em> :</span></td>
243
260
<td> the desired coordinate system into which to return the results,
244
261
(e.g. SPI_COORD_TYPE_WINDOW, SPI_COORD_TYPE_SCREEN).
259
276
<col align="left" valign="top">
262
<td><p><span class="term"><em class="parameter"><code>obj</code></em> :</span></p></td>
280
<span class="term"><em class="parameter"><code>obj</code></em> :</span></td>
263
281
<td> The <span class="type">AccessibleImage</span> being queried.
267
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
286
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
268
287
<td> A POSIX LC_MESSAGES-style Locale value for image description and text.