Debian Codegraph @

docs/html/GooCanvasItem.html

raw
1 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2 <html>
3 <head>
4 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5 <title>GooCanvasItem: GooCanvas Reference Manual</title>
6 <meta name="generator" content="DocBook XSL Stylesheets V1.78.1">
7 <link rel="home" href="index.html" title="GooCanvas Reference Manual">
8 <link rel="up" href="ch02.html" title="Core Objects">
9 <link rel="prev" href="GooCanvas.html" title="GooCanvas">
10 <link rel="next" href="GooCanvasItemModel.html" title="GooCanvasItemModel">
11 <meta name="generator" content="GTK-Doc V1.26 (XML mode)">
12 <link rel="stylesheet" href="style.css" type="text/css">
13 </head>
14 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
15 <table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="5"><tr valign="middle">
16 <td width="100%" align="left" class="shortcuts">
17 <a href="#" class="shortcut">Top</a><span id="nav_description">  <span class="dim">|</span> 
18 <a href="#GooCanvasItem.description" class="shortcut">Description</a></span><span id="nav_hierarchy">  <span class="dim">|</span> 
19 <a href="#GooCanvasItem.object-hierarchy" class="shortcut">Object Hierarchy</a></span><span id="nav_prerequisites">  <span class="dim">|</span> 
20 <a href="#GooCanvasItem.prerequisites" class="shortcut">Prerequisites</a></span><span id="nav_implementations">  <span class="dim">|</span> 
21 <a href="#GooCanvasItem.implementations" class="shortcut">Known Implementations</a></span><span id="nav_properties">  <span class="dim">|</span> 
22 <a href="#GooCanvasItem.properties" class="shortcut">Properties</a></span><span id="nav_signals">  <span class="dim">|</span> 
23 <a href="#GooCanvasItem.signals" class="shortcut">Signals</a></span>
24 </td>
25 <td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
26 <td><a accesskey="u" href="ch02.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
27 <td><a accesskey="p" href="GooCanvas.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
28 <td><a accesskey="n" href="GooCanvasItemModel.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>
29 </tr></table>
30 <div class="refentry">
31 <a name="GooCanvasItem"></a><div class="titlepage"></div>
32 <div class="refnamediv"><table width="100%"><tr>
33 <td valign="top">
34 <h2><span class="refentrytitle"><a name="GooCanvasItem.top_of_page"></a>GooCanvasItem</span></h2>
35 <p>GooCanvasItem — the interface for canvas items.</p>
36 </td>
37 <td class="gallery_image" valign="top" align="right"></td>
38 </tr></table></div>
39 <div class="refsect1">
40 <a name="GooCanvasItem.functions"></a><h2>Functions</h2>
41 <div class="informaltable"><table width="100%" border="0">
42 <colgroup>
43 <col width="150px" class="functions_return">
44 <col class="functions_name">
45 </colgroup>
46 <tbody>
47 <tr>
48 <td class="function_type">
49 <span class="returnvalue">void</span>
50 </td>
51 <td class="function_name">
52 <a class="link" href="GooCanvasItem.html#goo-canvas-item-translate" title="goo_canvas_item_translate ()">goo_canvas_item_translate</a> <span class="c_punctuation">()</span>
53 </td>
54 </tr>
55 <tr>
56 <td class="function_type">
57 <span class="returnvalue">void</span>
58 </td>
59 <td class="function_name">
60 <a class="link" href="GooCanvasItem.html#goo-canvas-item-scale" title="goo_canvas_item_scale ()">goo_canvas_item_scale</a> <span class="c_punctuation">()</span>
61 </td>
62 </tr>
63 <tr>
64 <td class="function_type">
65 <span class="returnvalue">void</span>
66 </td>
67 <td class="function_name">
68 <a class="link" href="GooCanvasItem.html#goo-canvas-item-rotate" title="goo_canvas_item_rotate ()">goo_canvas_item_rotate</a> <span class="c_punctuation">()</span>
69 </td>
70 </tr>
71 <tr>
72 <td class="function_type">
73 <span class="returnvalue">void</span>
74 </td>
75 <td class="function_name">
76 <a class="link" href="GooCanvasItem.html#goo-canvas-item-skew-x" title="goo_canvas_item_skew_x ()">goo_canvas_item_skew_x</a> <span class="c_punctuation">()</span>
77 </td>
78 </tr>
79 <tr>
80 <td class="function_type">
81 <span class="returnvalue">void</span>
82 </td>
83 <td class="function_name">
84 <a class="link" href="GooCanvasItem.html#goo-canvas-item-skew-y" title="goo_canvas_item_skew_y ()">goo_canvas_item_skew_y</a> <span class="c_punctuation">()</span>
85 </td>
86 </tr>
87 <tr>
88 <td class="function_type">
89 <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
90 </td>
91 <td class="function_name">
92 <a class="link" href="GooCanvasItem.html#goo-canvas-item-get-transform" title="goo_canvas_item_get_transform ()">goo_canvas_item_get_transform</a> <span class="c_punctuation">()</span>
93 </td>
94 </tr>
95 <tr>
96 <td class="function_type">
97 <span class="returnvalue">void</span>
98 </td>
99 <td class="function_name">
100 <a class="link" href="GooCanvasItem.html#goo-canvas-item-set-transform" title="goo_canvas_item_set_transform ()">goo_canvas_item_set_transform</a> <span class="c_punctuation">()</span>
101 </td>
102 </tr>
103 <tr>
104 <td class="function_type">
105 <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
106 </td>
107 <td class="function_name">
108 <a class="link" href="GooCanvasItem.html#goo-canvas-item-get-simple-transform" title="goo_canvas_item_get_simple_transform ()">goo_canvas_item_get_simple_transform</a> <span class="c_punctuation">()</span>
109 </td>
110 </tr>
111 <tr>
112 <td class="function_type">
113 <span class="returnvalue">void</span>
114 </td>
115 <td class="function_name">
116 <a class="link" href="GooCanvasItem.html#goo-canvas-item-set-simple-transform" title="goo_canvas_item_set_simple_transform ()">goo_canvas_item_set_simple_transform</a> <span class="c_punctuation">()</span>
117 </td>
118 </tr>
119 <tr>
120 <td class="function_type">
121 <span class="returnvalue">void</span>
122 </td>
123 <td class="function_name">
124 <a class="link" href="GooCanvasItem.html#goo-canvas-item-get-bounds" title="goo_canvas_item_get_bounds ()">goo_canvas_item_get_bounds</a> <span class="c_punctuation">()</span>
125 </td>
126 </tr>
127 <tr>
128 <td class="function_type">
129 <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
130 </td>
131 <td class="function_name">
132 <a class="link" href="GooCanvasItem.html#goo-canvas-item-is-visible" title="goo_canvas_item_is_visible ()">goo_canvas_item_is_visible</a> <span class="c_punctuation">()</span>
133 </td>
134 </tr>
135 <tr>
136 <td class="function_type">
137 <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
138 </td>
139 <td class="function_name">
140 <a class="link" href="GooCanvasItem.html#goo-canvas-item-get-is-static" title="goo_canvas_item_get_is_static ()">goo_canvas_item_get_is_static</a> <span class="c_punctuation">()</span>
141 </td>
142 </tr>
143 <tr>
144 <td class="function_type">
145 <span class="returnvalue">void</span>
146 </td>
147 <td class="function_name">
148 <a class="link" href="GooCanvasItem.html#goo-canvas-item-set-is-static" title="goo_canvas_item_set_is_static ()">goo_canvas_item_set_is_static</a> <span class="c_punctuation">()</span>
149 </td>
150 </tr>
151 <tr>
152 <td class="function_type">
153 <span class="returnvalue">void</span>
154 </td>
155 <td class="function_name">
156 <a class="link" href="GooCanvasItem.html#goo-canvas-item-animate" title="goo_canvas_item_animate ()">goo_canvas_item_animate</a> <span class="c_punctuation">()</span>
157 </td>
158 </tr>
159 <tr>
160 <td class="function_type">
161 <span class="returnvalue">void</span>
162 </td>
163 <td class="function_name">
164 <a class="link" href="GooCanvasItem.html#goo-canvas-item-stop-animation" title="goo_canvas_item_stop_animation ()">goo_canvas_item_stop_animation</a> <span class="c_punctuation">()</span>
165 </td>
166 </tr>
167 <tr>
168 <td class="function_type">
169 <span class="returnvalue">void</span>
170 </td>
171 <td class="function_name">
172 <a class="link" href="GooCanvasItem.html#goo-canvas-item-raise" title="goo_canvas_item_raise ()">goo_canvas_item_raise</a> <span class="c_punctuation">()</span>
173 </td>
174 </tr>
175 <tr>
176 <td class="function_type">
177 <span class="returnvalue">void</span>
178 </td>
179 <td class="function_name">
180 <a class="link" href="GooCanvasItem.html#goo-canvas-item-lower" title="goo_canvas_item_lower ()">goo_canvas_item_lower</a> <span class="c_punctuation">()</span>
181 </td>
182 </tr>
183 <tr>
184 <td class="function_type">
185 <span class="returnvalue">void</span>
186 </td>
187 <td class="function_name">
188 <a class="link" href="GooCanvasItem.html#goo-canvas-item-remove" title="goo_canvas_item_remove ()">goo_canvas_item_remove</a> <span class="c_punctuation">()</span>
189 </td>
190 </tr>
191 <tr>
192 <td class="function_type">
193 <a class="link" href="GooCanvas.html" title="GooCanvas"><span class="returnvalue">GooCanvas</span></a> *
194 </td>
195 <td class="function_name">
196 <a class="link" href="GooCanvasItem.html#goo-canvas-item-get-canvas" title="goo_canvas_item_get_canvas ()">goo_canvas_item_get_canvas</a> <span class="c_punctuation">()</span>
197 </td>
198 </tr>
199 <tr>
200 <td class="function_type">
201 <span class="returnvalue">void</span>
202 </td>
203 <td class="function_name">
204 <a class="link" href="GooCanvasItem.html#goo-canvas-item-set-canvas" title="goo_canvas_item_set_canvas ()">goo_canvas_item_set_canvas</a> <span class="c_punctuation">()</span>
205 </td>
206 </tr>
207 <tr>
208 <td class="function_type">
209 <a class="link" href="GooCanvasItem.html" title="GooCanvasItem"><span class="returnvalue">GooCanvasItem</span></a> *
210 </td>
211 <td class="function_name">
212 <a class="link" href="GooCanvasItem.html#goo-canvas-item-get-parent" title="goo_canvas_item_get_parent ()">goo_canvas_item_get_parent</a> <span class="c_punctuation">()</span>
213 </td>
214 </tr>
215 <tr>
216 <td class="function_type">
217 <span class="returnvalue">void</span>
218 </td>
219 <td class="function_name">
220 <a class="link" href="GooCanvasItem.html#goo-canvas-item-set-parent" title="goo_canvas_item_set_parent ()">goo_canvas_item_set_parent</a> <span class="c_punctuation">()</span>
221 </td>
222 </tr>
223 <tr>
224 <td class="function_type">
225 <a class="link" href="GooCanvasItemModel.html" title="GooCanvasItemModel"><span class="returnvalue">GooCanvasItemModel</span></a> *
226 </td>
227 <td class="function_name">
228 <a class="link" href="GooCanvasItem.html#goo-canvas-item-get-model" title="goo_canvas_item_get_model ()">goo_canvas_item_get_model</a> <span class="c_punctuation">()</span>
229 </td>
230 </tr>
231 <tr>
232 <td class="function_type">
233 <span class="returnvalue">void</span>
234 </td>
235 <td class="function_name">
236 <a class="link" href="GooCanvasItem.html#goo-canvas-item-set-model" title="goo_canvas_item_set_model ()">goo_canvas_item_set_model</a> <span class="c_punctuation">()</span>
237 </td>
238 </tr>
239 <tr>
240 <td class="function_type">
241 <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
242 </td>
243 <td class="function_name">
244 <a class="link" href="GooCanvasItem.html#goo-canvas-item-is-container" title="goo_canvas_item_is_container ()">goo_canvas_item_is_container</a> <span class="c_punctuation">()</span>
245 </td>
246 </tr>
247 <tr>
248 <td class="function_type">
249 <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>
250 </td>
251 <td class="function_name">
252 <a class="link" href="GooCanvasItem.html#goo-canvas-item-get-n-children" title="goo_canvas_item_get_n_children ()">goo_canvas_item_get_n_children</a> <span class="c_punctuation">()</span>
253 </td>
254 </tr>
255 <tr>
256 <td class="function_type">
257 <a class="link" href="GooCanvasItem.html" title="GooCanvasItem"><span class="returnvalue">GooCanvasItem</span></a> *
258 </td>
259 <td class="function_name">
260 <a class="link" href="GooCanvasItem.html#goo-canvas-item-get-child" title="goo_canvas_item_get_child ()">goo_canvas_item_get_child</a> <span class="c_punctuation">()</span>
261 </td>
262 </tr>
263 <tr>
264 <td class="function_type">
265 <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>
266 </td>
267 <td class="function_name">
268 <a class="link" href="GooCanvasItem.html#goo-canvas-item-find-child" title="goo_canvas_item_find_child ()">goo_canvas_item_find_child</a> <span class="c_punctuation">()</span>
269 </td>
270 </tr>
271 <tr>
272 <td class="function_type">
273 <span class="returnvalue">void</span>
274 </td>
275 <td class="function_name">
276 <a class="link" href="GooCanvasItem.html#goo-canvas-item-add-child" title="goo_canvas_item_add_child ()">goo_canvas_item_add_child</a> <span class="c_punctuation">()</span>
277 </td>
278 </tr>
279 <tr>
280 <td class="function_type">
281 <span class="returnvalue">void</span>
282 </td>
283 <td class="function_name">
284 <a class="link" href="GooCanvasItem.html#goo-canvas-item-move-child" title="goo_canvas_item_move_child ()">goo_canvas_item_move_child</a> <span class="c_punctuation">()</span>
285 </td>
286 </tr>
287 <tr>
288 <td class="function_type">
289 <span class="returnvalue">void</span>
290 </td>
291 <td class="function_name">
292 <a class="link" href="GooCanvasItem.html#goo-canvas-item-remove-child" title="goo_canvas_item_remove_child ()">goo_canvas_item_remove_child</a> <span class="c_punctuation">()</span>
293 </td>
294 </tr>
295 <tr>
296 <td class="function_type">
297 <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
298 </td>
299 <td class="function_name">
300 <a class="link" href="GooCanvasItem.html#goo-canvas-item-get-transform-for-child" title="goo_canvas_item_get_transform_for_child ()">goo_canvas_item_get_transform_for_child</a> <span class="c_punctuation">()</span>
301 </td>
302 </tr>
303 <tr>
304 <td class="function_type">
305 <a class="link" href="GooCanvasStyle.html" title="GooCanvasStyle"><span class="returnvalue">GooCanvasStyle</span></a> *
306 </td>
307 <td class="function_name">
308 <a class="link" href="GooCanvasItem.html#goo-canvas-item-get-style" title="goo_canvas_item_get_style ()">goo_canvas_item_get_style</a> <span class="c_punctuation">()</span>
309 </td>
310 </tr>
311 <tr>
312 <td class="function_type">
313 <span class="returnvalue">void</span>
314 </td>
315 <td class="function_name">
316 <a class="link" href="GooCanvasItem.html#goo-canvas-item-set-style" title="goo_canvas_item_set_style ()">goo_canvas_item_set_style</a> <span class="c_punctuation">()</span>
317 </td>
318 </tr>
319 <tr>
320 <td class="function_type">
321 <span class="returnvalue">void</span>
322 </td>
323 <td class="function_name">
324 <a class="link" href="GooCanvasItem.html#goo-canvas-item-request-update" title="goo_canvas_item_request_update ()">goo_canvas_item_request_update</a> <span class="c_punctuation">()</span>
325 </td>
326 </tr>
327 <tr>
328 <td class="function_type">
329 <span class="returnvalue">void</span>
330 </td>
331 <td class="function_name">
332 <a class="link" href="GooCanvasItem.html#goo-canvas-item-ensure-updated" title="goo_canvas_item_ensure_updated ()">goo_canvas_item_ensure_updated</a> <span class="c_punctuation">()</span>
333 </td>
334 </tr>
335 <tr>
336 <td class="function_type">
337 <span class="returnvalue">void</span>
338 </td>
339 <td class="function_name">
340 <a class="link" href="GooCanvasItem.html#goo-canvas-item-update" title="goo_canvas_item_update ()">goo_canvas_item_update</a> <span class="c_punctuation">()</span>
341 </td>
342 </tr>
343 <tr>
344 <td class="function_type">
345 <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
346 </td>
347 <td class="function_name">
348 <a class="link" href="GooCanvasItem.html#goo-canvas-item-get-requested-area" title="goo_canvas_item_get_requested_area ()">goo_canvas_item_get_requested_area</a> <span class="c_punctuation">()</span>
349 </td>
350 </tr>
351 <tr>
352 <td class="function_type">
353 <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
354 </td>
355 <td class="function_name">
356 <a class="link" href="GooCanvasItem.html#goo-canvas-item-get-requested-area-for-width" title="goo_canvas_item_get_requested_area_for_width ()">goo_canvas_item_get_requested_area_for_width</a> <span class="c_punctuation">()</span>
357 </td>
358 </tr>
359 <tr>
360 <td class="function_type">
361 <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gdouble"><span class="returnvalue">gdouble</span></a>
362 </td>
363 <td class="function_name">
364 <a class="link" href="GooCanvasItem.html#goo-canvas-item-get-requested-height" title="goo_canvas_item_get_requested_height ()">goo_canvas_item_get_requested_height</a> <span class="c_punctuation">()</span>
365 </td>
366 </tr>
367 <tr>
368 <td class="function_type">
369 <span class="returnvalue">void</span>
370 </td>
371 <td class="function_name">
372 <a class="link" href="GooCanvasItem.html#goo-canvas-item-allocate-area" title="goo_canvas_item_allocate_area ()">goo_canvas_item_allocate_area</a> <span class="c_punctuation">()</span>
373 </td>
374 </tr>
375 <tr>
376 <td class="function_type">
377 <a href="/usr/share/gtk-doc/html/glib/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> *
378 </td>
379 <td class="function_name">
380 <a class="link" href="GooCanvasItem.html#goo-canvas-item-get-items-at" title="goo_canvas_item_get_items_at ()">goo_canvas_item_get_items_at</a> <span class="c_punctuation">()</span>
381 </td>
382 </tr>
383 <tr>
384 <td class="function_type">
385 <span class="returnvalue">void</span>
386 </td>
387 <td class="function_name">
388 <a class="link" href="GooCanvasItem.html#goo-canvas-item-paint" title="goo_canvas_item_paint ()">goo_canvas_item_paint</a> <span class="c_punctuation">()</span>
389 </td>
390 </tr>
391 <tr>
392 <td class="function_type">
393 <span class="returnvalue">void</span>
394 </td>
395 <td class="function_name">
396 <a class="link" href="GooCanvasItem.html#goo-canvas-item-class-install-child-property" title="goo_canvas_item_class_install_child_property ()">goo_canvas_item_class_install_child_property</a> <span class="c_punctuation">()</span>
397 </td>
398 </tr>
399 <tr>
400 <td class="function_type">
401 <a href="/usr/share/gtk-doc/html/gobject/gobject-GParamSpec.html#GParamSpec"><span class="returnvalue">GParamSpec</span></a> **
402 </td>
403 <td class="function_name">
404 <a class="link" href="GooCanvasItem.html#goo-canvas-item-class-list-child-properties" title="goo_canvas_item_class_list_child_properties ()">goo_canvas_item_class_list_child_properties</a> <span class="c_punctuation">()</span>
405 </td>
406 </tr>
407 <tr>
408 <td class="function_type">
409 <a href="/usr/share/gtk-doc/html/gobject/gobject-GParamSpec.html#GParamSpec"><span class="returnvalue">GParamSpec</span></a> *
410 </td>
411 <td class="function_name">
412 <a class="link" href="GooCanvasItem.html#goo-canvas-item-class-find-child-property" title="goo_canvas_item_class_find_child_property ()">goo_canvas_item_class_find_child_property</a> <span class="c_punctuation">()</span>
413 </td>
414 </tr>
415 <tr>
416 <td class="function_type">
417 <span class="returnvalue">void</span>
418 </td>
419 <td class="function_name">
420 <a class="link" href="GooCanvasItem.html#goo-canvas-item-get-child-property" title="goo_canvas_item_get_child_property ()">goo_canvas_item_get_child_property</a> <span class="c_punctuation">()</span>
421 </td>
422 </tr>
423 <tr>
424 <td class="function_type">
425 <span class="returnvalue">void</span>
426 </td>
427 <td class="function_name">
428 <a class="link" href="GooCanvasItem.html#goo-canvas-item-set-child-property" title="goo_canvas_item_set_child_property ()">goo_canvas_item_set_child_property</a> <span class="c_punctuation">()</span>
429 </td>
430 </tr>
431 <tr>
432 <td class="function_type">
433 <span class="returnvalue">void</span>
434 </td>
435 <td class="function_name">
436 <a class="link" href="GooCanvasItem.html#goo-canvas-item-get-child-properties" title="goo_canvas_item_get_child_properties ()">goo_canvas_item_get_child_properties</a> <span class="c_punctuation">()</span>
437 </td>
438 </tr>
439 <tr>
440 <td class="function_type">
441 <span class="returnvalue">void</span>
442 </td>
443 <td class="function_name">
444 <a class="link" href="GooCanvasItem.html#goo-canvas-item-get-child-properties-valist" title="goo_canvas_item_get_child_properties_valist ()">goo_canvas_item_get_child_properties_valist</a> <span class="c_punctuation">()</span>
445 </td>
446 </tr>
447 <tr>
448 <td class="function_type">
449 <span class="returnvalue">void</span>
450 </td>
451 <td class="function_name">
452 <a class="link" href="GooCanvasItem.html#goo-canvas-item-set-child-properties" title="goo_canvas_item_set_child_properties ()">goo_canvas_item_set_child_properties</a> <span class="c_punctuation">()</span>
453 </td>
454 </tr>
455 <tr>
456 <td class="function_type">
457 <span class="returnvalue">void</span>
458 </td>
459 <td class="function_name">
460 <a class="link" href="GooCanvasItem.html#goo-canvas-item-set-child-properties-valist" title="goo_canvas_item_set_child_properties_valist ()">goo_canvas_item_set_child_properties_valist</a> <span class="c_punctuation">()</span>
461 </td>
462 </tr>
463 </tbody>
464 </table></div>
465 </div>
466 <div class="refsect1">
467 <a name="GooCanvasItem.properties"></a><h2>Properties</h2>
468 <div class="informaltable"><table border="0">
469 <colgroup>
470 <col width="150px" class="properties_type">
471 <col width="300px" class="properties_name">
472 <col width="200px" class="properties_flags">
473 </colgroup>
474 <tbody>
475 <tr>
476 <td class="property_type"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a></td>
477 <td class="property_name"><a class="link" href="GooCanvasItem.html#GooCanvasItem--can-focus" title="The “can-focus” property">can-focus</a></td>
478 <td class="property_flags">Read / Write</td>
479 </tr>
480 <tr>
481 <td class="property_type">
482 <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</td>
483 <td class="property_name"><a class="link" href="GooCanvasItem.html#GooCanvasItem--description" title="The “description” property">description</a></td>
484 <td class="property_flags">Read / Write</td>
485 </tr>
486 <tr>
487 <td class="property_type">
488 <a class="link" href="GooCanvasItem.html" title="GooCanvasItem"><span class="type">GooCanvasItem</span></a> *</td>
489 <td class="property_name"><a class="link" href="GooCanvasItem.html#GooCanvasItem--parent" title="The “parent” property">parent</a></td>
490 <td class="property_flags">Read / Write</td>
491 </tr>
492 <tr>
493 <td class="property_type"><a class="link" href="goocanvas2-GooCanvas-Types.html#GooCanvasPointerEvents" title="enum GooCanvasPointerEvents"><span class="type">GooCanvasPointerEvents</span></a></td>
494 <td class="property_name"><a class="link" href="GooCanvasItem.html#GooCanvasItem--pointer-events" title="The “pointer-events” property">pointer-events</a></td>
495 <td class="property_flags">Read / Write</td>
496 </tr>
497 <tr>
498 <td class="property_type">
499 <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</td>
500 <td class="property_name"><a class="link" href="GooCanvasItem.html#GooCanvasItem--title" title="The “title” property">title</a></td>
501 <td class="property_flags">Read / Write</td>
502 </tr>
503 <tr>
504 <td class="property_type">
505 <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</td>
506 <td class="property_name"><a class="link" href="GooCanvasItem.html#GooCanvasItem--tooltip" title="The “tooltip” property">tooltip</a></td>
507 <td class="property_flags">Read / Write</td>
508 </tr>
509 <tr>
510 <td class="property_type">
511 <a class="link" href="goocanvas2-GooCanvas-Types.html#GooCairoMatrix"><span class="type">GooCairoMatrix</span></a> *</td>
512 <td class="property_name"><a class="link" href="GooCanvasItem.html#GooCanvasItem--transform" title="The “transform” property">transform</a></td>
513 <td class="property_flags">Read / Write</td>
514 </tr>
515 <tr>
516 <td class="property_type"><a class="link" href="goocanvas2-GooCanvas-Types.html#GooCanvasItemVisibility" title="enum GooCanvasItemVisibility"><span class="type">GooCanvasItemVisibility</span></a></td>
517 <td class="property_name"><a class="link" href="GooCanvasItem.html#GooCanvasItem--visibility" title="The “visibility” property">visibility</a></td>
518 <td class="property_flags">Read / Write</td>
519 </tr>
520 <tr>
521 <td class="property_type"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a></td>
522 <td class="property_name"><a class="link" href="GooCanvasItem.html#GooCanvasItem--visibility-threshold" title="The “visibility-threshold” property">visibility-threshold</a></td>
523 <td class="property_flags">Read / Write</td>
524 </tr>
525 </tbody>
526 </table></div>
527 </div>
528 <div class="refsect1">
529 <a name="GooCanvasItem.signals"></a><h2>Signals</h2>
530 <div class="informaltable"><table border="0">
531 <colgroup>
532 <col width="150px" class="signals_return">
533 <col width="300px" class="signals_name">
534 <col width="200px" class="signals_flags">
535 </colgroup>
536 <tbody>
537 <tr>
538 <td class="signal_type"><span class="returnvalue">void</span></td>
539 <td class="signal_name"><a class="link" href="GooCanvasItem.html#GooCanvasItem-animation-finished" title="The “animation-finished” signal">animation-finished</a></td>
540 <td class="signal_flags"><a href="/usr/share/gtk-doc/html/gobject/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS">Run Last</a></td>
541 </tr>
542 <tr>
543 <td class="signal_type"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a></td>
544 <td class="signal_name"><a class="link" href="GooCanvasItem.html#GooCanvasItem-button-press-event" title="The “button-press-event” signal">button-press-event</a></td>
545 <td class="signal_flags"><a href="/usr/share/gtk-doc/html/gobject/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS">Run Last</a></td>
546 </tr>
547 <tr>
548 <td class="signal_type"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a></td>
549 <td class="signal_name"><a class="link" href="GooCanvasItem.html#GooCanvasItem-button-release-event" title="The “button-release-event” signal">button-release-event</a></td>
550 <td class="signal_flags"><a href="/usr/share/gtk-doc/html/gobject/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS">Run Last</a></td>
551 </tr>
552 <tr>
553 <td class="signal_type"><span class="returnvalue">void</span></td>
554 <td class="signal_name"><a class="link" href="GooCanvasItem.html#GooCanvasItem-child-notify" title="The “child-notify” signal">child-notify</a></td>
555 <td class="signal_flags"><a href="/usr/share/gtk-doc/html/gobject/gobject-Signals.html#G-SIGNAL-NO-HOOKS:CAPS">No Hooks</a></td>
556 </tr>
557 <tr>
558 <td class="signal_type"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a></td>
559 <td class="signal_name"><a class="link" href="GooCanvasItem.html#GooCanvasItem-enter-notify-event" title="The “enter-notify-event” signal">enter-notify-event</a></td>
560 <td class="signal_flags"><a href="/usr/share/gtk-doc/html/gobject/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS">Run Last</a></td>
561 </tr>
562 <tr>
563 <td class="signal_type"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a></td>
564 <td class="signal_name"><a class="link" href="GooCanvasItem.html#GooCanvasItem-focus-in-event" title="The “focus-in-event” signal">focus-in-event</a></td>
565 <td class="signal_flags"><a href="/usr/share/gtk-doc/html/gobject/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS">Run Last</a></td>
566 </tr>
567 <tr>
568 <td class="signal_type"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a></td>
569 <td class="signal_name"><a class="link" href="GooCanvasItem.html#GooCanvasItem-focus-out-event" title="The “focus-out-event” signal">focus-out-event</a></td>
570 <td class="signal_flags"><a href="/usr/share/gtk-doc/html/gobject/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS">Run Last</a></td>
571 </tr>
572 <tr>
573 <td class="signal_type"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a></td>
574 <td class="signal_name"><a class="link" href="GooCanvasItem.html#GooCanvasItem-grab-broken-event" title="The “grab-broken-event” signal">grab-broken-event</a></td>
575 <td class="signal_flags"><a href="/usr/share/gtk-doc/html/gobject/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS">Run Last</a></td>
576 </tr>
577 <tr>
578 <td class="signal_type"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a></td>
579 <td class="signal_name"><a class="link" href="GooCanvasItem.html#GooCanvasItem-key-press-event" title="The “key-press-event” signal">key-press-event</a></td>
580 <td class="signal_flags"><a href="/usr/share/gtk-doc/html/gobject/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS">Run Last</a></td>
581 </tr>
582 <tr>
583 <td class="signal_type"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a></td>
584 <td class="signal_name"><a class="link" href="GooCanvasItem.html#GooCanvasItem-key-release-event" title="The “key-release-event” signal">key-release-event</a></td>
585 <td class="signal_flags"><a href="/usr/share/gtk-doc/html/gobject/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS">Run Last</a></td>
586 </tr>
587 <tr>
588 <td class="signal_type"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a></td>
589 <td class="signal_name"><a class="link" href="GooCanvasItem.html#GooCanvasItem-leave-notify-event" title="The “leave-notify-event” signal">leave-notify-event</a></td>
590 <td class="signal_flags"><a href="/usr/share/gtk-doc/html/gobject/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS">Run Last</a></td>
591 </tr>
592 <tr>
593 <td class="signal_type"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a></td>
594 <td class="signal_name"><a class="link" href="GooCanvasItem.html#GooCanvasItem-motion-notify-event" title="The “motion-notify-event” signal">motion-notify-event</a></td>
595 <td class="signal_flags"><a href="/usr/share/gtk-doc/html/gobject/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS">Run Last</a></td>
596 </tr>
597 <tr>
598 <td class="signal_type"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a></td>
599 <td class="signal_name"><a class="link" href="GooCanvasItem.html#GooCanvasItem-query-tooltip" title="The “query-tooltip” signal">query-tooltip</a></td>
600 <td class="signal_flags"><a href="/usr/share/gtk-doc/html/gobject/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS">Run Last</a></td>
601 </tr>
602 <tr>
603 <td class="signal_type"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a></td>
604 <td class="signal_name"><a class="link" href="GooCanvasItem.html#GooCanvasItem-scroll-event" title="The “scroll-event” signal">scroll-event</a></td>
605 <td class="signal_flags"><a href="/usr/share/gtk-doc/html/gobject/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS">Run Last</a></td>
606 </tr>
607 </tbody>
608 </table></div>
609 </div>
610 <div class="refsect1">
611 <a name="GooCanvasItem.other"></a><h2>Types and Values</h2>
612 <div class="informaltable"><table width="100%" border="0">
613 <colgroup>
614 <col width="150px" class="name">
615 <col class="description">
616 </colgroup>
617 <tbody>
618 <tr>
619 <td class="datatype_keyword"> </td>
620 <td class="function_name"><a class="link" href="GooCanvasItem.html#GooCanvasItem-struct" title="GooCanvasItem">GooCanvasItem</a></td>
621 </tr>
622 <tr>
623 <td class="datatype_keyword">struct</td>
624 <td class="function_name"><a class="link" href="GooCanvasItem.html#GooCanvasItemIface" title="struct GooCanvasItemIface">GooCanvasItemIface</a></td>
625 </tr>
626 </tbody>
627 </table></div>
628 </div>
629 <div class="refsect1">
630 <a name="GooCanvasItem.object-hierarchy"></a><h2>Object Hierarchy</h2>
631 <pre class="screen"> <a href="/usr/share/gtk-doc/html/gobject/GTypeModule.html">GInterface</a>
632 <span class="lineart">╰──</span> GooCanvasItem
633 </pre>
634 </div>
635 <div class="refsect1">
636 <a name="GooCanvasItem.prerequisites"></a><h2>Prerequisites</h2>
637 <p>
638 GooCanvasItem requires
639 <a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject-struct">GObject</a>.</p>
640 </div>
641 <div class="refsect1">
642 <a name="GooCanvasItem.implementations"></a><h2>Known Implementations</h2>
643 <p>
644 GooCanvasItem is implemented by
645 <a class="link" href="GooCanvasEllipse.html" title="GooCanvasEllipse">GooCanvasEllipse</a>, <a class="link" href="GooCanvasGrid.html" title="GooCanvasGrid">GooCanvasGrid</a>, <a class="link" href="GooCanvasGroup.html" title="GooCanvasGroup">GooCanvasGroup</a>, <a class="link" href="GooCanvasImage.html" title="GooCanvasImage">GooCanvasImage</a>, <a class="link" href="GooCanvasItemSimple.html" title="GooCanvasItemSimple">GooCanvasItemSimple</a>, <a class="link" href="GooCanvasPath.html" title="GooCanvasPath">GooCanvasPath</a>, <a class="link" href="GooCanvasPolyline.html" title="GooCanvasPolyline">GooCanvasPolyline</a>, <a class="link" href="GooCanvasRect.html" title="GooCanvasRect">GooCanvasRect</a>, <a class="link" href="GooCanvasTable.html" title="GooCanvasTable">GooCanvasTable</a>, <a class="link" href="GooCanvasText.html" title="GooCanvasText">GooCanvasText</a> and <a class="link" href="GooCanvasWidget.html" title="GooCanvasWidget">GooCanvasWidget</a>.</p>
646 </div>
647 <div class="refsect1">
648 <a name="GooCanvasItem.description"></a><h2>Description</h2>
649 <p><a class="link" href="GooCanvasItem.html" title="GooCanvasItem"><span class="type">GooCanvasItem</span></a> defines the interface that canvas items must implement,
650 and contains methods for operating on canvas items.</p>
651 </div>
652 <div class="refsect1">
653 <a name="GooCanvasItem.functions_details"></a><h2>Functions</h2>
654 <div class="refsect2">
655 <a name="goo-canvas-item-translate"></a><h3>goo_canvas_item_translate ()</h3>
656 <pre class="programlisting"><span class="returnvalue">void</span>
657 goo_canvas_item_translate (<em class="parameter"><code><a class="link" href="GooCanvasItem.html" title="GooCanvasItem"><span class="type">GooCanvasItem</span></a> *item</code></em>,
658 <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> tx</code></em>,
659 <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> ty</code></em>);</pre>
660 <p>Translates the origin of the item's coordinate system by the given amounts.</p>
661 <div class="refsect3">
662 <a name="goo-canvas-item-translate.parameters"></a><h4>Parameters</h4>
663 <div class="informaltable"><table width="100%" border="0">
664 <colgroup>
665 <col width="150px" class="parameters_name">
666 <col class="parameters_description">
667 <col width="200px" class="parameters_annotations">
668 </colgroup>
669 <tbody>
670 <tr>
671 <td class="parameter_name"><p>item</p></td>
672 <td class="parameter_description"><p>an item.</p></td>
673 <td class="parameter_annotations"> </td>
674 </tr>
675 <tr>
676 <td class="parameter_name"><p>tx</p></td>
677 <td class="parameter_description"><p>the amount to move the origin in the horizontal direction.</p></td>
678 <td class="parameter_annotations"> </td>
679 </tr>
680 <tr>
681 <td class="parameter_name"><p>ty</p></td>
682 <td class="parameter_description"><p>the amount to move the origin in the vertical direction.</p></td>
683 <td class="parameter_annotations"> </td>
684 </tr>
685 </tbody>
686 </table></div>
687 </div>
688 </div>
689 <hr>
690 <div class="refsect2">
691 <a name="goo-canvas-item-scale"></a><h3>goo_canvas_item_scale ()</h3>
692 <pre class="programlisting"><span class="returnvalue">void</span>
693 goo_canvas_item_scale (<em class="parameter"><code><a class="link" href="GooCanvasItem.html" title="GooCanvasItem"><span class="type">GooCanvasItem</span></a> *item</code></em>,
694 <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> sx</code></em>,
695 <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> sy</code></em>);</pre>
696 <p>Scales the item's coordinate system by the given amounts.</p>
697 <div class="refsect3">
698 <a name="goo-canvas-item-scale.parameters"></a><h4>Parameters</h4>
699 <div class="informaltable"><table width="100%" border="0">
700 <colgroup>
701 <col width="150px" class="parameters_name">
702 <col class="parameters_description">
703 <col width="200px" class="parameters_annotations">
704 </colgroup>
705 <tbody>
706 <tr>
707 <td class="parameter_name"><p>item</p></td>
708 <td class="parameter_description"><p>an item.</p></td>
709 <td class="parameter_annotations"> </td>
710 </tr>
711 <tr>
712 <td class="parameter_name"><p>sx</p></td>
713 <td class="parameter_description"><p>the amount to scale the horizontal axis.</p></td>
714 <td class="parameter_annotations"> </td>
715 </tr>
716 <tr>
717 <td class="parameter_name"><p>sy</p></td>
718 <td class="parameter_description"><p>the amount to scale the vertical axis.</p></td>
719 <td class="parameter_annotations"> </td>
720 </tr>
721 </tbody>
722 </table></div>
723 </div>
724 </div>
725 <hr>
726 <div class="refsect2">
727 <a name="goo-canvas-item-rotate"></a><h3>goo_canvas_item_rotate ()</h3>
728 <pre class="programlisting"><span class="returnvalue">void</span>
729 goo_canvas_item_rotate (<em class="parameter"><code><a class="link" href="GooCanvasItem.html" title="GooCanvasItem"><span class="type">GooCanvasItem</span></a> *item</code></em>,
730 <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> degrees</code></em>,
731 <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> cx</code></em>,
732 <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> cy</code></em>);</pre>
733 <p>Rotates the item's coordinate system by the given amount, about the given
734 origin.</p>
735 <div class="refsect3">
736 <a name="goo-canvas-item-rotate.parameters"></a><h4>Parameters</h4>
737 <div class="informaltable"><table width="100%" border="0">
738 <colgroup>
739 <col width="150px" class="parameters_name">
740 <col class="parameters_description">
741 <col width="200px" class="parameters_annotations">
742 </colgroup>
743 <tbody>
744 <tr>
745 <td class="parameter_name"><p>item</p></td>
746 <td class="parameter_description"><p>an item.</p></td>
747 <td class="parameter_annotations"> </td>
748 </tr>
749 <tr>
750 <td class="parameter_name"><p>degrees</p></td>
751 <td class="parameter_description"><p>the clockwise angle of rotation.</p></td>
752 <td class="parameter_annotations"> </td>
753 </tr>
754 <tr>
755 <td class="parameter_name"><p>cx</p></td>
756 <td class="parameter_description"><p>the x coordinate of the origin of the rotation.</p></td>
757 <td class="parameter_annotations"> </td>
758 </tr>
759 <tr>
760 <td class="parameter_name"><p>cy</p></td>
761 <td class="parameter_description"><p>the y coordinate of the origin of the rotation.</p></td>
762 <td class="parameter_annotations"> </td>
763 </tr>
764 </tbody>
765 </table></div>
766 </div>
767 </div>
768 <hr>
769 <div class="refsect2">
770 <a name="goo-canvas-item-skew-x"></a><h3>goo_canvas_item_skew_x ()</h3>
771 <pre class="programlisting"><span class="returnvalue">void</span>
772 goo_canvas_item_skew_x (<em class="parameter"><code><a class="link" href="GooCanvasItem.html" title="GooCanvasItem"><span class="type">GooCanvasItem</span></a> *item</code></em>,
773 <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> degrees</code></em>,
774 <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> cx</code></em>,
775 <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> cy</code></em>);</pre>
776 <p>Skews the item's coordinate system along the x axis by the given amount,
777 about the given origin.</p>
778 <div class="refsect3">
779 <a name="goo-canvas-item-skew-x.parameters"></a><h4>Parameters</h4>
780 <div class="informaltable"><table width="100%" border="0">
781 <colgroup>
782 <col width="150px" class="parameters_name">
783 <col class="parameters_description">
784 <col width="200px" class="parameters_annotations">
785 </colgroup>
786 <tbody>
787 <tr>
788 <td class="parameter_name"><p>item</p></td>
789 <td class="parameter_description"><p>an item.</p></td>
790 <td class="parameter_annotations"> </td>
791 </tr>
792 <tr>
793 <td class="parameter_name"><p>degrees</p></td>
794 <td class="parameter_description"><p>the skew angle.</p></td>
795 <td class="parameter_annotations"> </td>
796 </tr>
797 <tr>
798 <td class="parameter_name"><p>cx</p></td>
799 <td class="parameter_description"><p>the x coordinate of the origin of the skew transform.</p></td>
800 <td class="parameter_annotations"> </td>
801 </tr>
802 <tr>
803 <td class="parameter_name"><p>cy</p></td>
804 <td class="parameter_description"><p>the y coordinate of the origin of the skew transform.</p></td>
805 <td class="parameter_annotations"> </td>
806 </tr>
807 </tbody>
808 </table></div>
809 </div>
810 </div>
811 <hr>
812 <div class="refsect2">
813 <a name="goo-canvas-item-skew-y"></a><h3>goo_canvas_item_skew_y ()</h3>
814 <pre class="programlisting"><span class="returnvalue">void</span>
815 goo_canvas_item_skew_y (<em class="parameter"><code><a class="link" href="GooCanvasItem.html" title="GooCanvasItem"><span class="type">GooCanvasItem</span></a> *item</code></em>,
816 <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> degrees</code></em>,
817 <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> cx</code></em>,
818 <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> cy</code></em>);</pre>
819 <p>Skews the item's coordinate system along the y axis by the given amount,
820 about the given origin.</p>
821 <div class="refsect3">
822 <a name="goo-canvas-item-skew-y.parameters"></a><h4>Parameters</h4>
823 <div class="informaltable"><table width="100%" border="0">
824 <colgroup>
825 <col width="150px" class="parameters_name">
826 <col class="parameters_description">
827 <col width="200px" class="parameters_annotations">
828 </colgroup>
829 <tbody>
830 <tr>
831 <td class="parameter_name"><p>item</p></td>
832 <td class="parameter_description"><p>an item.</p></td>
833 <td class="parameter_annotations"> </td>
834 </tr>
835 <tr>
836 <td class="parameter_name"><p>degrees</p></td>
837 <td class="parameter_description"><p>the skew angle.</p></td>
838 <td class="parameter_annotations"> </td>
839 </tr>
840 <tr>
841 <td class="parameter_name"><p>cx</p></td>
842 <td class="parameter_description"><p>the x coordinate of the origin of the skew transform.</p></td>
843 <td class="parameter_annotations"> </td>
844 </tr>
845 <tr>
846 <td class="parameter_name"><p>cy</p></td>
847 <td class="parameter_description"><p>the y coordinate of the origin of the skew transform.</p></td>
848 <td class="parameter_annotations"> </td>
849 </tr>
850 </tbody>
851 </table></div>
852 </div>
853 </div>
854 <hr>
855 <div class="refsect2">
856 <a name="goo-canvas-item-get-transform"></a><h3>goo_canvas_item_get_transform ()</h3>
857 <pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
858 goo_canvas_item_get_transform (<em class="parameter"><code><a class="link" href="GooCanvasItem.html" title="GooCanvasItem"><span class="type">GooCanvasItem</span></a> *item</code></em>,
859 <em class="parameter"><code><a href="/usr/share/gtk-doc/html/cairo/cairo-cairo-matrix-t.html#cairo-matrix-t"><span class="type">cairo_matrix_t</span></a> *transform</code></em>);</pre>
860 <p>Gets the transformation matrix of an item.</p>
861 <div class="refsect3">
862 <a name="goo-canvas-item-get-transform.parameters"></a><h4>Parameters</h4>
863 <div class="informaltable"><table width="100%" border="0">
864 <colgroup>
865 <col width="150px" class="parameters_name">
866 <col class="parameters_description">
867 <col width="200px" class="parameters_annotations">
868 </colgroup>
869 <tbody>
870 <tr>
871 <td class="parameter_name"><p>item</p></td>
872 <td class="parameter_description"><p>an item.</p></td>
873 <td class="parameter_annotations"> </td>
874 </tr>
875 <tr>
876 <td class="parameter_name"><p>transform</p></td>
877 <td class="parameter_description"><p>the place to store the transform. </p></td>
878 <td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span></td>
879 </tr>
880 </tbody>
881 </table></div>
882 </div>
883 <div class="refsect3">
884 <a name="goo-canvas-item-get-transform.returns"></a><h4>Returns</h4>
885 <p> <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if a transform is set.</p>
886 </div>
887 </div>
888 <hr>
889 <div class="refsect2">
890 <a name="goo-canvas-item-set-transform"></a><h3>goo_canvas_item_set_transform ()</h3>
891 <pre class="programlisting"><span class="returnvalue">void</span>
892 goo_canvas_item_set_transform (<em class="parameter"><code><a class="link" href="GooCanvasItem.html" title="GooCanvasItem"><span class="type">GooCanvasItem</span></a> *item</code></em>,
893 <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/cairo/cairo-cairo-matrix-t.html#cairo-matrix-t"><span class="type">cairo_matrix_t</span></a> *transform</code></em>);</pre>
894 <p>Sets the transformation matrix of an item.</p>
895 <div class="refsect3">
896 <a name="goo-canvas-item-set-transform.parameters"></a><h4>Parameters</h4>
897 <div class="informaltable"><table width="100%" border="0">
898 <colgroup>
899 <col width="150px" class="parameters_name">
900 <col class="parameters_description">
901 <col width="200px" class="parameters_annotations">
902 </colgroup>
903 <tbody>
904 <tr>
905 <td class="parameter_name"><p>item</p></td>
906 <td class="parameter_description"><p>an item.</p></td>
907 <td class="parameter_annotations"> </td>
908 </tr>
909 <tr>
910 <td class="parameter_name"><p>transform</p></td>
911 <td class="parameter_description"><p>the new transformation matrix, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to reset the
912 transformation to the identity matrix. </p></td>
913 <td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
914 </tr>
915 </tbody>
916 </table></div>
917 </div>
918 </div>
919 <hr>
920 <div class="refsect2">
921 <a name="goo-canvas-item-get-simple-transform"></a><h3>goo_canvas_item_get_simple_transform ()</h3>
922 <pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
923 goo_canvas_item_get_simple_transform (<em class="parameter"><code><a class="link" href="GooCanvasItem.html" title="GooCanvasItem"><span class="type">GooCanvasItem</span></a> *item</code></em>,
924 <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> *x</code></em>,
925 <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> *y</code></em>,
926 <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> *scale</code></em>,
927 <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> *rotation</code></em>);</pre>
928 <p>This function can be used to get the position, scale and rotation of an
929 item, providing that the item has a simple transformation matrix
930 (e.g. set with <a class="link" href="GooCanvasItem.html#goo-canvas-item-set-simple-transform" title="goo_canvas_item_set_simple_transform ()"><code class="function">goo_canvas_item_set_simple_transform()</code></a>, or using a
931 combination of simple translate, scale and rotate operations). If the item
932 has a complex transformation matrix the results will be incorrect.</p>
933 <div class="refsect3">
934 <a name="goo-canvas-item-get-simple-transform.parameters"></a><h4>Parameters</h4>
935 <div class="informaltable"><table width="100%" border="0">
936 <colgroup>
937 <col width="150px" class="parameters_name">
938 <col class="parameters_description">
939 <col width="200px" class="parameters_annotations">
940 </colgroup>
941 <tbody>
942 <tr>
943 <td class="parameter_name"><p>item</p></td>
944 <td class="parameter_description"><p>an item.</p></td>
945 <td class="parameter_annotations"> </td>
946 </tr>
947 <tr>
948 <td class="parameter_name"><p>x</p></td>
949 <td class="parameter_description"><p>returns the x coordinate of the origin of the item's coordinate space. </p></td>
950 <td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span></td>
951 </tr>
952 <tr>
953 <td class="parameter_name"><p>y</p></td>
954 <td class="parameter_description"><p>returns the y coordinate of the origin of the item's coordinate space. </p></td>
955 <td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span></td>
956 </tr>
957 <tr>
958 <td class="parameter_name"><p>scale</p></td>
959 <td class="parameter_description"><p>returns the scale of the item. </p></td>
960 <td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span></td>
961 </tr>
962 <tr>
963 <td class="parameter_name"><p>rotation</p></td>
964 <td class="parameter_description"><p>returns the clockwise rotation of the item, in degrees (0-360). </p></td>
965 <td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span></td>
966 </tr>
967 </tbody>
968 </table></div>
969 </div>
970 <div class="refsect3">
971 <a name="goo-canvas-item-get-simple-transform.returns"></a><h4>Returns</h4>
972 <p> <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if a transform is set.</p>
973 </div>
974 </div>
975 <hr>
976 <div class="refsect2">
977 <a name="goo-canvas-item-set-simple-transform"></a><h3>goo_canvas_item_set_simple_transform ()</h3>
978 <pre class="programlisting"><span class="returnvalue">void</span>
979 goo_canvas_item_set_simple_transform (<em class="parameter"><code><a class="link" href="GooCanvasItem.html" title="GooCanvasItem"><span class="type">GooCanvasItem</span></a> *item</code></em>,
980 <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> x</code></em>,
981 <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> y</code></em>,
982 <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> scale</code></em>,
983 <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> rotation</code></em>);</pre>
984 <p>A convenience function to set the item's transformation matrix.</p>
985 <div class="refsect3">
986 <a name="goo-canvas-item-set-simple-transform.parameters"></a><h4>Parameters</h4>
987 <div class="informaltable"><table width="100%" border="0">
988 <colgroup>
989 <col width="150px" class="parameters_name">
990 <col class="parameters_description">
991 <col width="200px" class="parameters_annotations">
992 </colgroup>
993 <tbody>
994 <tr>
995 <td class="parameter_name"><p>item</p></td>
996 <td class="parameter_description"><p>an item.</p></td>
997 <td class="parameter_annotations"> </td>
998 </tr>
999 <tr>
1000 <td class="parameter_name"><p>x</p></td>
1001 <td class="parameter_description"><p>the x coordinate of the origin of the item's coordinate space.</p></td>
1002 <td class="parameter_annotations"> </td>
1003 </tr>
1004 <tr>
1005 <td class="parameter_name"><p>y</p></td>
1006 <td class="parameter_description"><p>the y coordinate of the origin of the item's coordinate space.</p></td>
1007 <td class="parameter_annotations"> </td>
1008 </tr>
1009 <tr>
1010 <td class="parameter_name"><p>scale</p></td>
1011 <td class="parameter_description"><p>the scale of the item.</p></td>
1012 <td class="parameter_annotations"> </td>
1013 </tr>
1014 <tr>
1015 <td class="parameter_name"><p>rotation</p></td>
1016 <td class="parameter_description"><p>the clockwise rotation of the item, in degrees.</p></td>
1017 <td class="parameter_annotations"> </td>
1018 </tr>
1019 </tbody>
1020 </table></div>
1021 </div>
1022 </div>
1023 <hr>
1024 <div class="refsect2">
1025 <a name="goo-canvas-item-get-bounds"></a><h3>goo_canvas_item_get_bounds ()</h3>
1026 <pre class="programlisting"><span class="returnvalue">void</span>
1027 goo_canvas_item_get_bounds (<em class="parameter"><code><a class="link" href="GooCanvasItem.html" title="GooCanvasItem"><span class="type">GooCanvasItem</span></a> *item</code></em>,
1028 <em class="parameter"><code><a class="link" href="goocanvas2-GooCanvas-Types.html#GooCanvasBounds" title="struct GooCanvasBounds"><span class="type">GooCanvasBounds</span></a> *bounds</code></em>);</pre>
1029 <p>Gets the bounds of the item.</p>
1030 <p>Note that the bounds includes the entire fill and stroke extents of the
1031 item, whether they are painted or not.</p>
1032 <div class="refsect3">
1033 <a name="goo-canvas-item-get-bounds.parameters"></a><h4>Parameters</h4>
1034 <div class="informaltable"><table width="100%" border="0">
1035 <colgroup>
1036 <col width="150px" class="parameters_name">
1037 <col class="parameters_description">
1038 <col width="200px" class="parameters_annotations">
1039 </colgroup>
1040 <tbody>
1041 <tr>
1042 <td class="parameter_name"><p>item</p></td>
1043 <td class="parameter_description"><p>a <a class="link" href="GooCanvasItem.html" title="GooCanvasItem"><span class="type">GooCanvasItem</span></a>.</p></td>
1044 <td class="parameter_annotations"> </td>
1045 </tr>
1046 <tr>
1047 <td class="parameter_name"><p>bounds</p></td>
1048 <td class="parameter_description"><p>a <a class="link" href="goocanvas2-GooCanvas-Types.html#GooCanvasBounds" title="struct GooCanvasBounds"><span class="type">GooCanvasBounds</span></a> to return the bounds in. </p></td>
1049 <td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span></td>
1050 </tr>
1051 </tbody>
1052 </table></div>
1053 </div>
1054 </div>
1055 <hr>
1056 <div class="refsect2">
1057 <a name="goo-canvas-item-is-visible"></a><h3>goo_canvas_item_is_visible ()</h3>
1058 <pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
1059 goo_canvas_item_is_visible (<em class="parameter"><code><a class="link" href="GooCanvasItem.html" title="GooCanvasItem"><span class="type">GooCanvasItem</span></a> *item</code></em>);</pre>
1060 <p>Checks if the item is visible.</p>
1061 <p>This entails checking the item's own visibility setting, as well as those
1062 of its ancestors.</p>
1063 <p>Note that the item may be scrolled off the screen and so may not
1064 be actually visible to the user.</p>
1065 <div class="refsect3">
1066 <a name="goo-canvas-item-is-visible.parameters"></a><h4>Parameters</h4>
1067 <div class="informaltable"><table width="100%" border="0">
1068 <colgroup>
1069 <col width="150px" class="parameters_name">
1070 <col class="parameters_description">
1071 <col width="200px" class="parameters_annotations">
1072 </colgroup>
1073 <tbody><tr>
1074 <td class="parameter_name"><p>item</p></td>
1075 <td class="parameter_description"><p>a <a class="link" href="GooCanvasItem.html" title="GooCanvasItem"><span class="type">GooCanvasItem</span></a>.</p></td>
1076 <td class="parameter_annotations"> </td>
1077 </tr></tbody>
1078 </table></div>
1079 </div>
1080 <div class="refsect3">
1081 <a name="goo-canvas-item-is-visible.returns"></a><h4>Returns</h4>
1082 <p> <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the item is visible.</p>
1083 </div>
1084 </div>
1085 <hr>
1086 <div class="refsect2">
1087 <a name="goo-canvas-item-get-is-static"></a><h3>goo_canvas_item_get_is_static ()</h3>
1088 <pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
1089 goo_canvas_item_get_is_static (<em class="parameter"><code><a class="link" href="GooCanvasItem.html" title="GooCanvasItem"><span class="type">GooCanvasItem</span></a> *item</code></em>);</pre>
1090 <p>Returns <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the item is static. Static items do not move or change
1091 size when the canvas is scrolled or the scale changes.</p>
1092 <div class="refsect3">
1093 <a name="goo-canvas-item-get-is-static.parameters"></a><h4>Parameters</h4>
1094 <div class="informaltable"><table width="100%" border="0">
1095 <colgroup>
1096 <col width="150px" class="parameters_name">
1097 <col class="parameters_description">
1098 <col width="200px" class="parameters_annotations">
1099 </colgroup>
1100 <tbody><tr>
1101 <td class="parameter_name"><p>item</p></td>
1102 <td class="parameter_description"><p>an item.</p></td>
1103 <td class="parameter_annotations"> </td>
1104 </tr></tbody>
1105 </table></div>
1106 </div>
1107 <div class="refsect3">
1108 <a name="goo-canvas-item-get-is-static.returns"></a><h4>Returns</h4>
1109 <p> <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the item is static.</p>
1110 </div>
1111 </div>
1112 <hr>
1113 <div class="refsect2">
1114 <a name="goo-canvas-item-set-is-static"></a><h3>goo_canvas_item_set_is_static ()</h3>
1115 <pre class="programlisting"><span class="returnvalue">void</span>
1116 goo_canvas_item_set_is_static (<em class="parameter"><code><a class="link" href="GooCanvasItem.html" title="GooCanvasItem"><span class="type">GooCanvasItem</span></a> *item</code></em>,
1117 <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> is_static</code></em>);</pre>
1118 <p>Notifies the item that it is static. Static items do not move or change
1119 size when the canvas is scrolled or the scale changes.</p>
1120 <p>Container items such as <a class="link" href="GooCanvasGroup.html" title="GooCanvasGroup"><span class="type">GooCanvasGroup</span></a> should call this function when
1121 children are added, to notify children whether they are static or not.
1122 Containers should also pass on any changes in their own status to children.</p>
1123 <div class="refsect3">
1124 <a name="goo-canvas-item-set-is-static.parameters"></a><h4>Parameters</h4>
1125 <div class="informaltable"><table width="100%" border="0">
1126 <colgroup>
1127 <col width="150px" class="parameters_name">
1128 <col class="parameters_description">
1129 <col width="200px" class="parameters_annotations">
1130 </colgroup>
1131 <tbody>
1132 <tr>
1133 <td class="parameter_name"><p>item</p></td>
1134 <td class="parameter_description"><p>an item.</p></td>
1135 <td class="parameter_annotations"> </td>
1136 </tr>
1137 <tr>
1138 <td class="parameter_name"><p>is_static</p></td>
1139 <td class="parameter_description"><p>if the item is static.</p></td>
1140 <td class="parameter_annotations"> </td>
1141 </tr>
1142 </tbody>
1143 </table></div>
1144 </div>
1145 </div>
1146 <hr>
1147 <div class="refsect2">
1148 <a name="goo-canvas-item-animate"></a><h3>goo_canvas_item_animate ()</h3>
1149 <pre class="programlisting"><span class="returnvalue">void</span>
1150 goo_canvas_item_animate (<em class="parameter"><code><a class="link" href="GooCanvasItem.html" title="GooCanvasItem"><span class="type">GooCanvasItem</span></a> *item</code></em>,
1151 <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> x</code></em>,
1152 <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> y</code></em>,
1153 <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> scale</code></em>,
1154 <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> degrees</code></em>,
1155 <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> absolute</code></em>,
1156 <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> duration</code></em>,
1157 <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> step_time</code></em>,
1158 <em class="parameter"><code><a class="link" href="goocanvas2-GooCanvas-Types.html#GooCanvasAnimateType" title="enum GooCanvasAnimateType"><span class="type">GooCanvasAnimateType</span></a> type</code></em>);</pre>
1159 <p>Animates an item from its current position to the given offsets, scale
1160 and rotation.</p>
1161 <div class="refsect3">
1162 <a name="goo-canvas-item-animate.parameters"></a><h4>Parameters</h4>
1163 <div class="informaltable"><table width="100%" border="0">
1164 <colgroup>
1165 <col width="150px" class="parameters_name">
1166 <col class="parameters_description">
1167 <col width="200px" class="parameters_annotations">
1168 </colgroup>
1169 <tbody>
1170 <tr>
1171 <td class="parameter_name"><p>item</p></td>
1172 <td class="parameter_description"><p>an item.</p></td>
1173 <td class="parameter_annotations"> </td>
1174 </tr>
1175 <tr>
1176 <td class="parameter_name"><p>x</p></td>
1177 <td class="parameter_description"><p>the final x coordinate.</p></td>
1178 <td class="parameter_annotations"> </td>
1179 </tr>
1180 <tr>
1181 <td class="parameter_name"><p>y</p></td>
1182 <td class="parameter_description"><p>the final y coordinate.</p></td>
1183 <td class="parameter_annotations"> </td>
1184 </tr>
1185 <tr>
1186 <td class="parameter_name"><p>scale</p></td>
1187 <td class="parameter_description"><p>the final scale.</p></td>
1188 <td class="parameter_annotations"> </td>
1189 </tr>
1190 <tr>
1191 <td class="parameter_name"><p>degrees</p></td>
1192 <td class="parameter_description"><p>the final rotation. This can be negative to rotate anticlockwise,
1193 and can also be greater than 360 to rotate a number of times.</p></td>
1194 <td class="parameter_annotations"> </td>
1195 </tr>
1196 <tr>
1197 <td class="parameter_name"><p>absolute</p></td>
1198 <td class="parameter_description"><p>if the <em class="parameter"><code>x</code></em>
1199 , <em class="parameter"><code>y</code></em>
1200 , <em class="parameter"><code>scale</code></em>
1201 and <em class="parameter"><code>degrees</code></em>
1202 values are absolute, or
1203 relative to the current transform. Note that absolute animations only work
1204 if the item currently has a simple transform. If the item has a shear or
1205 some other complicated transform it may result in strange animations.</p></td>
1206 <td class="parameter_annotations"> </td>
1207 </tr>
1208 <tr>
1209 <td class="parameter_name"><p>duration</p></td>
1210 <td class="parameter_description"><p>the duration of the animation, in milliseconds (1/1000ths of a
1211 second).</p></td>
1212 <td class="parameter_annotations"> </td>
1213 </tr>
1214 <tr>
1215 <td class="parameter_name"><p>step_time</p></td>
1216 <td class="parameter_description"><p>the time between each animation step, in milliseconds.</p></td>
1217 <td class="parameter_annotations"> </td>
1218 </tr>
1219 <tr>
1220 <td class="parameter_name"><p>type</p></td>
1221 <td class="parameter_description"><p>specifies what happens when the animation finishes.</p></td>
1222 <td class="parameter_annotations"> </td>
1223 </tr>
1224 </tbody>
1225 </table></div>
1226 </div>
1227 </div>
1228 <hr>
1229 <div class="refsect2">
1230 <a name="goo-canvas-item-stop-animation"></a><h3>goo_canvas_item_stop_animation ()</h3>
1231 <pre class="programlisting"><span class="returnvalue">void</span>
1232 goo_canvas_item_stop_animation (<em class="parameter"><code><a class="link" href="GooCanvasItem.html" title="GooCanvasItem"><span class="type">GooCanvasItem</span></a> *item</code></em>);</pre>
1233 <p>Stops any current animation for the given item, leaving it at its current
1234 position.</p>
1235 <div class="refsect3">
1236 <a name="goo-canvas-item-stop-animation.parameters"></a><h4>Parameters</h4>
1237 <div class="informaltable"><table width="100%" border="0">
1238 <colgroup>
1239 <col width="150px" class="parameters_name">
1240 <col class="parameters_description">
1241 <col width="200px" class="parameters_annotations">
1242 </colgroup>
1243 <tbody><tr>
1244 <td class="parameter_name"><p>item</p></td>
1245 <td class="parameter_description"><p>an item.</p></td>
1246 <td class="parameter_annotations"> </td>
1247 </tr></tbody>
1248 </table></div>
1249 </div>
1250 </div>
1251 <hr>
1252 <div class="refsect2">
1253 <a name="goo-canvas-item-raise"></a><h3>goo_canvas_item_raise ()</h3>
1254 <pre class="programlisting"><span class="returnvalue">void</span>
1255 goo_canvas_item_raise (<em class="parameter"><code><a class="link" href="GooCanvasItem.html" title="GooCanvasItem"><span class="type">GooCanvasItem</span></a> *item</code></em>,
1256 <em class="parameter"><code><a class="link" href="GooCanvasItem.html" title="GooCanvasItem"><span class="type">GooCanvasItem</span></a> *above</code></em>);</pre>
1257 <p>Raises an item in the stacking order.</p>
1258 <div class="refsect3">
1259 <a name="goo-canvas-item-raise.parameters"></a><h4>Parameters</h4>
1260 <div class="informaltable"><table width="100%" border="0">
1261 <colgroup>
1262 <col width="150px" class="parameters_name">
1263 <col class="parameters_description">
1264 <col width="200px" class="parameters_annotations">
1265 </colgroup>
1266 <tbody>
1267 <tr>
1268 <td class="parameter_name"><p>item</p></td>
1269 <td class="parameter_description"><p>an item.</p></td>
1270 <td class="parameter_annotations"> </td>
1271 </tr>
1272 <tr>
1273 <td class="parameter_name"><p>above</p></td>
1274 <td class="parameter_description"><p>the item to raise <em class="parameter"><code>item</code></em>
1275 above, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to raise <em class="parameter"><code>item</code></em>
1276 to the top
1277 of the stack. </p></td>
1278 <td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
1279 </tr>
1280 </tbody>
1281 </table></div>
1282 </div>
1283 </div>
1284 <hr>
1285 <div class="refsect2">
1286 <a name="goo-canvas-item-lower"></a><h3>goo_canvas_item_lower ()</h3>
1287 <pre class="programlisting"><span class="returnvalue">void</span>
1288 goo_canvas_item_lower (<em class="parameter"><code><a class="link" href="GooCanvasItem.html" title="GooCanvasItem"><span class="type">GooCanvasItem</span></a> *item</code></em>,
1289 <em class="parameter"><code><a class="link" href="GooCanvasItem.html" title="GooCanvasItem"><span class="type">GooCanvasItem</span></a> *below</code></em>);</pre>
1290 <p>Lowers an item in the stacking order.</p>
1291 <div class="refsect3">
1292 <a name="goo-canvas-item-lower.parameters"></a><h4>Parameters</h4>
1293 <div class="informaltable"><table width="100%" border="0">
1294 <colgroup>
1295 <col width="150px" class="parameters_name">
1296 <col class="parameters_description">
1297 <col width="200px" class="parameters_annotations">
1298 </colgroup>
1299 <tbody>
1300 <tr>
1301 <td class="parameter_name"><p>item</p></td>
1302 <td class="parameter_description"><p>an item.</p></td>
1303 <td class="parameter_annotations"> </td>
1304 </tr>
1305 <tr>
1306 <td class="parameter_name"><p>below</p></td>
1307 <td class="parameter_description"><p>the item to lower <em class="parameter"><code>item</code></em>
1308 below, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to lower <em class="parameter"><code>item</code></em>
1309 to the
1310 bottom of the stack. </p></td>
1311 <td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
1312 </tr>
1313 </tbody>
1314 </table></div>
1315 </div>
1316 </div>
1317 <hr>
1318 <div class="refsect2">
1319 <a name="goo-canvas-item-remove"></a><h3>goo_canvas_item_remove ()</h3>
1320 <pre class="programlisting"><span class="returnvalue">void</span>
1321 goo_canvas_item_remove (<em class="parameter"><code><a class="link" href="GooCanvasItem.html" title="GooCanvasItem"><span class="type">GooCanvasItem</span></a> *item</code></em>);</pre>
1322 <p>Removes an item from its parent. If the item is in a canvas it will be
1323 removed.</p>
1324 <p>This would normally also result in the item being freed.</p>
1325 <div class="refsect3">
1326 <a name="goo-canvas-item-remove.parameters"></a><h4>Parameters</h4>
1327 <div class="informaltable"><table width="100%" border="0">
1328 <colgroup>
1329 <col width="150px" class="parameters_name">
1330 <col class="parameters_description">
1331 <col width="200px" class="parameters_annotations">
1332 </colgroup>
1333 <tbody><tr>
1334 <td class="parameter_name"><p>item</p></td>
1335 <td class="parameter_description"><p>an item.</p></td>
1336 <td class="parameter_annotations"> </td>
1337 </tr></tbody>
1338 </table></div>
1339 </div>
1340 </div>
1341 <hr>
1342 <div class="refsect2">
1343 <a name="goo-canvas-item-get-canvas"></a><h3>goo_canvas_item_get_canvas ()</h3>
1344 <pre class="programlisting"><a class="link" href="GooCanvas.html" title="GooCanvas"><span class="returnvalue">GooCanvas</span></a> *
1345 goo_canvas_item_get_canvas (<em class="parameter"><code><a class="link" href="GooCanvasItem.html" title="GooCanvasItem"><span class="type">GooCanvasItem</span></a> *item</code></em>);</pre>
1346 <p>Returns the <a class="link" href="GooCanvas.html" title="GooCanvas"><span class="type">GooCanvas</span></a> containing the given <a class="link" href="GooCanvasItem.html" title="GooCanvasItem"><span class="type">GooCanvasItem</span></a>.</p>
1347 <div class="refsect3">
1348 <a name="goo-canvas-item-get-canvas.parameters"></a><h4>Parameters</h4>
1349 <div class="informaltable"><table width="100%" border="0">
1350 <colgroup>
1351 <col width="150px" class="parameters_name">
1352 <col class="parameters_description">
1353 <col width="200px" class="parameters_annotations">
1354 </colgroup>
1355 <tbody><tr>
1356 <td class="parameter_name"><p>item</p></td>
1357 <td class="parameter_description"><p>a <a class="link" href="GooCanvasItem.html" title="GooCanvasItem"><span class="type">GooCanvasItem</span></a>.</p></td>
1358 <td class="parameter_annotations"> </td>
1359 </tr></tbody>
1360 </table></div>
1361 </div>
1362 <div class="refsect3">
1363 <a name="goo-canvas-item-get-canvas.returns"></a><h4>Returns</h4>
1364 <p>the <a class="link" href="GooCanvas.html" title="GooCanvas"><span class="type">GooCanvas</span></a>. </p>
1365 <p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
1366 </div>
1367 </div>
1368 <hr>
1369 <div class="refsect2">
1370 <a name="goo-canvas-item-set-canvas"></a><h3>goo_canvas_item_set_canvas ()</h3>
1371 <pre class="programlisting"><span class="returnvalue">void</span>
1372 goo_canvas_item_set_canvas (<em class="parameter"><code><a class="link" href="GooCanvasItem.html" title="GooCanvasItem"><span class="type">GooCanvasItem</span></a> *item</code></em>,
1373 <em class="parameter"><code><a class="link" href="GooCanvas.html" title="GooCanvas"><span class="type">GooCanvas</span></a> *canvas</code></em>);</pre>
1374 <p>This function is only intended to be used when implementing new canvas
1375 items, specifically container items such as <a class="link" href="GooCanvasGroup.html" title="GooCanvasGroup"><span class="type">GooCanvasGroup</span></a>.</p>
1376 <p>It sets the canvas of the item.</p>
1377 <div class="refsect3">
1378 <a name="goo-canvas-item-set-canvas.parameters"></a><h4>Parameters</h4>
1379 <div class="informaltable"><table width="100%" border="0">
1380 <colgroup>
1381 <col width="150px" class="parameters_name">
1382 <col class="parameters_description">
1383 <col width="200px" class="parameters_annotations">
1384 </colgroup>
1385 <tbody>
1386 <tr>
1387 <td class="parameter_name"><p>item</p></td>
1388 <td class="parameter_description"><p>a <a class="link" href="GooCanvasItem.html" title="GooCanvasItem"><span class="type">GooCanvasItem</span></a>.</p></td>
1389 <td class="parameter_annotations"> </td>
1390 </tr>
1391 <tr>
1392 <td class="parameter_name"><p>canvas</p></td>
1393 <td class="parameter_description"><p>a <a class="link" href="GooCanvas.html" title="GooCanvas"><span class="type">GooCanvas</span></a></p></td>
1394 <td class="parameter_annotations"> </td>
1395 </tr>
1396 </tbody>
1397 </table></div>
1398 </div>
1399 </div>
1400 <hr>
1401 <div class="refsect2">
1402 <a name="goo-canvas-item-get-parent"></a><h3>goo_canvas_item_get_parent ()</h3>
1403 <pre class="programlisting"><a class="link" href="GooCanvasItem.html" title="GooCanvasItem"><span class="returnvalue">GooCanvasItem</span></a> *
1404 goo_canvas_item_get_parent (<em class="parameter"><code><a class="link" href="GooCanvasItem.html" title="GooCanvasItem"><span class="type">GooCanvasItem</span></a> *item</code></em>);</pre>
1405 <p>Gets the parent of the given item.</p>
1406 <div class="refsect3">
1407 <a name="goo-canvas-item-get-parent.parameters"></a><h4>Parameters</h4>
1408 <div class="informaltable"><table width="100%" border="0">
1409 <colgroup>
1410 <col width="150px" class="parameters_name">
1411 <col class="parameters_description">
1412 <col width="200px" class="parameters_annotations">
1413 </colgroup>
1414 <tbody><tr>
1415 <td class="parameter_name"><p>item</p></td>
1416 <td class="parameter_description"><p>an item.</p></td>
1417 <td class="parameter_annotations"> </td>
1418 </tr></tbody>
1419 </table></div>
1420 </div>
1421 <div class="refsect3">
1422 <a name="goo-canvas-item-get-parent.returns"></a><h4>Returns</h4>
1423 <p>the parent item, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the item has no parent. </p>
1424 <p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
1425 </div>
1426 </div>
1427 <hr>
1428 <div class="refsect2">
1429 <a name="goo-canvas-item-set-parent"></a><h3>goo_canvas_item_set_parent ()</h3>
1430 <pre class="programlisting"><span class="returnvalue">void</span>
1431 goo_canvas_item_set_parent (<em class="parameter"><code><a class="link" href="GooCanvasItem.html" title="GooCanvasItem"><span class="type">GooCanvasItem</span></a> *item</code></em>,
1432 <em class="parameter"><code><a class="link" href="GooCanvasItem.html" title="GooCanvasItem"><span class="type">GooCanvasItem</span></a> *parent</code></em>);</pre>
1433 <p>This function is only intended to be used when implementing new canvas
1434 items (specifically container items such as <a class="link" href="GooCanvasGroup.html" title="GooCanvasGroup"><span class="type">GooCanvasGroup</span></a>).
1435 It sets the parent of the child item.</p>
1436 <div class="note"><p>
1437 This function cannot be used to add an item to a group
1438 or to change the parent of an item.
1439 To do that use the <a class="link" href="GooCanvasItem.html#GooCanvasItem--parent" title="The “parent” property"><span class="type">“parent”</span></a> property.
1440 </p></div>
1441 <div class="refsect3">
1442 <a name="goo-canvas-item-set-parent.parameters"></a><h4>Parameters</h4>
1443 <div class="informaltable"><table width="100%" border="0">
1444 <colgroup>
1445 <col width="150px" class="parameters_name">
1446 <col class="parameters_description">
1447 <col width="200px" class="parameters_annotations">
1448 </colgroup>
1449 <tbody>
1450 <tr>
1451 <td class="parameter_name"><p>item</p></td>
1452 <td class="parameter_description"><p>an item.</p></td>
1453 <td class="parameter_annotations"> </td>
1454 </tr>
1455 <tr>
1456 <td class="parameter_name"><p>parent</p></td>
1457 <td class="parameter_description"><p>the new parent item.</p></td>
1458 <td class="parameter_annotations"> </td>
1459 </tr>
1460 </tbody>
1461 </table></div>
1462 </div>
1463 </div>
1464 <hr>
1465 <div class="refsect2">
1466 <a name="goo-canvas-item-get-model"></a><h3>goo_canvas_item_get_model ()</h3>
1467 <pre class="programlisting"><a class="link" href="GooCanvasItemModel.html" title="GooCanvasItemModel"><span class="returnvalue">GooCanvasItemModel</span></a> *
1468 goo_canvas_item_get_model (<em class="parameter"><code><a class="link" href="GooCanvasItem.html" title="GooCanvasItem"><span class="type">GooCanvasItem</span></a> *item</code></em>);</pre>
1469 <p>Gets the model of the given canvas item.</p>
1470 <div class="refsect3">
1471 <a name="goo-canvas-item-get-model.parameters"></a><h4>Parameters</h4>
1472 <div class="informaltable"><table width="100%" border="0">
1473 <colgroup>
1474 <col width="150px" class="parameters_name">
1475 <col class="parameters_description">
1476 <col width="200px" class="parameters_annotations">
1477 </colgroup>
1478 <tbody><tr>
1479 <td class="parameter_name"><p>item</p></td>
1480 <td class="parameter_description"><p>a <a class="link" href="GooCanvasItem.html" title="GooCanvasItem"><span class="type">GooCanvasItem</span></a>.</p></td>
1481 <td class="parameter_annotations"> </td>
1482 </tr></tbody>
1483 </table></div>
1484 </div>
1485 <div class="refsect3">
1486 <a name="goo-canvas-item-get-model.returns"></a><h4>Returns</h4>
1487 <p>the item's model, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if it has no model. </p>
1488 <p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
1489 </div>
1490 </div>
1491 <hr>
1492 <div class="refsect2">
1493 <a name="goo-canvas-item-set-model"></a><h3>goo_canvas_item_set_model ()</h3>
1494 <pre class="programlisting"><span class="returnvalue">void</span>
1495 goo_canvas_item_set_model (<em class="parameter"><code><a class="link" href="GooCanvasItem.html" title="GooCanvasItem"><span class="type">GooCanvasItem</span></a> *item</code></em>,
1496 <em class="parameter"><code><a class="link" href="GooCanvasItemModel.html" title="GooCanvasItemModel"><span class="type">GooCanvasItemModel</span></a> *model</code></em>);</pre>
1497 <p>Sets the model of the given canvas item.</p>
1498 <div class="refsect3">
1499 <a name="goo-canvas-item-set-model.parameters"></a><h4>Parameters</h4>
1500 <div class="informaltable"><table width="100%" border="0">
1501 <colgroup>
1502 <col width="150px" class="parameters_name">
1503 <col class="parameters_description">
1504 <col width="200px" class="parameters_annotations">
1505 </colgroup>
1506 <tbody>
1507 <tr>
1508 <td class="parameter_name"><p>item</p></td>
1509 <td class="parameter_description"><p>a <a class="link" href="GooCanvasItem.html" title="GooCanvasItem"><span class="type">GooCanvasItem</span></a>.</p></td>
1510 <td class="parameter_annotations"> </td>
1511 </tr>
1512 <tr>
1513 <td class="parameter_name"><p>model</p></td>
1514 <td class="parameter_description"><p>a <a class="link" href="GooCanvasItemModel.html" title="GooCanvasItemModel"><span class="type">GooCanvasItemModel</span></a>.</p></td>
1515 <td class="parameter_annotations"> </td>
1516 </tr>
1517 </tbody>
1518 </table></div>
1519 </div>
1520 </div>
1521 <hr>
1522 <div class="refsect2">
1523 <a name="goo-canvas-item-is-container"></a><h3>goo_canvas_item_is_container ()</h3>
1524 <pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
1525 goo_canvas_item_is_container (<em class="parameter"><code><a class="link" href="GooCanvasItem.html" title="GooCanvasItem"><span class="type">GooCanvasItem</span></a> *item</code></em>);</pre>
1526 <p>Tests to see if the given item is a container.</p>
1527 <div class="refsect3">
1528 <a name="goo-canvas-item-is-container.parameters"></a><h4>Parameters</h4>
1529 <div class="informaltable"><table width="100%" border="0">
1530 <colgroup>
1531 <col width="150px" class="parameters_name">
1532 <col class="parameters_description">
1533 <col width="200px" class="parameters_annotations">
1534 </colgroup>
1535 <tbody><tr>
1536 <td class="parameter_name"><p>item</p></td>
1537 <td class="parameter_description"><p>an item.</p></td>
1538 <td class="parameter_annotations"> </td>
1539 </tr></tbody>
1540 </table></div>
1541 </div>
1542 <div class="refsect3">
1543 <a name="goo-canvas-item-is-container.returns"></a><h4>Returns</h4>
1544 <p> <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the item is a container.</p>
1545 </div>
1546 </div>
1547 <hr>
1548 <div class="refsect2">
1549 <a name="goo-canvas-item-get-n-children"></a><h3>goo_canvas_item_get_n_children ()</h3>
1550 <pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>
1551 goo_canvas_item_get_n_children (<em class="parameter"><code><a class="link" href="GooCanvasItem.html" title="GooCanvasItem"><span class="type">GooCanvasItem</span></a> *item</code></em>);</pre>
1552 <p>Gets the number of children of the container.</p>
1553 <div class="refsect3">
1554 <a name="goo-canvas-item-get-n-children.parameters"></a><h4>Parameters</h4>
1555 <div class="informaltable"><table width="100%" border="0">
1556 <colgroup>
1557 <col width="150px" class="parameters_name">
1558 <col class="parameters_description">
1559 <col width="200px" class="parameters_annotations">
1560 </colgroup>
1561 <tbody><tr>
1562 <td class="parameter_name"><p>item</p></td>
1563 <td class="parameter_description"><p>a container item.</p></td>
1564 <td class="parameter_annotations"> </td>
1565 </tr></tbody>
1566 </table></div>
1567 </div>
1568 <div class="refsect3">
1569 <a name="goo-canvas-item-get-n-children.returns"></a><h4>Returns</h4>
1570 <p> the number of children.</p>
1571 </div>
1572 </div>
1573 <hr>
1574 <div class="refsect2">
1575 <a name="goo-canvas-item-get-child"></a><h3>goo_canvas_item_get_child ()</h3>
1576 <pre class="programlisting"><a class="link" href="GooCanvasItem.html" title="GooCanvasItem"><span class="returnvalue">GooCanvasItem</span></a> *
1577 goo_canvas_item_get_child (<em class="parameter"><code><a class="link" href="GooCanvasItem.html" title="GooCanvasItem"><span class="type">GooCanvasItem</span></a> *item</code></em>,
1578 <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> child_num</code></em>);</pre>
1579 <p>Gets the child item at the given stack position.</p>
1580 <div class="refsect3">
1581 <a name="goo-canvas-item-get-child.parameters"></a><h4>Parameters</h4>
1582 <div class="informaltable"><table width="100%" border="0">
1583 <colgroup>
1584 <col width="150px" class="parameters_name">
1585 <col class="parameters_description">
1586 <col width="200px" class="parameters_annotations">
1587 </colgroup>
1588 <tbody>
1589 <tr>
1590 <td class="parameter_name"><p>item</p></td>
1591 <td class="parameter_description"><p>a container item.</p></td>
1592 <td class="parameter_annotations"> </td>
1593 </tr>
1594 <tr>
1595 <td class="parameter_name"><p>child_num</p></td>
1596 <td class="parameter_description"><p>the position of a child in the container's stack.</p></td>
1597 <td class="parameter_annotations"> </td>
1598 </tr>
1599 </tbody>
1600 </table></div>
1601 </div>
1602 <div class="refsect3">
1603 <a name="goo-canvas-item-get-child.returns"></a><h4>Returns</h4>
1604 <p>the child item at the given stack position, or
1605 <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>child_num</code></em>
1606 is out of range. </p>
1607 <p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
1608 </div>
1609 </div>
1610 <hr>
1611 <div class="refsect2">
1612 <a name="goo-canvas-item-find-child"></a><h3>goo_canvas_item_find_child ()</h3>
1613 <pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>
1614 goo_canvas_item_find_child (<em class="parameter"><code><a class="link" href="GooCanvasItem.html" title="GooCanvasItem"><span class="type">GooCanvasItem</span></a> *item</code></em>,
1615 <em class="parameter"><code><a class="link" href="GooCanvasItem.html" title="GooCanvasItem"><span class="type">GooCanvasItem</span></a> *child</code></em>);</pre>
1616 <p>Attempts to find the given child item with the container's stack.</p>
1617 <div class="refsect3">
1618 <a name="goo-canvas-item-find-child.parameters"></a><h4>Parameters</h4>
1619 <div class="informaltable"><table width="100%" border="0">
1620 <colgroup>
1621 <col width="150px" class="parameters_name">
1622 <col class="parameters_description">
1623 <col width="200px" class="parameters_annotations">
1624 </colgroup>
1625 <tbody>
1626 <tr>
1627 <td class="parameter_name"><p>item</p></td>
1628 <td class="parameter_description"><p>a container item.</p></td>
1629 <td class="parameter_annotations"> </td>
1630 </tr>
1631 <tr>
1632 <td class="parameter_name"><p>child</p></td>
1633 <td class="parameter_description"><p>the child item to find.</p></td>
1634 <td class="parameter_annotations"> </td>
1635 </tr>
1636 </tbody>
1637 </table></div>
1638 </div>
1639 <div class="refsect3">
1640 <a name="goo-canvas-item-find-child.returns"></a><h4>Returns</h4>
1641 <p> the position of the given <em class="parameter"><code>child</code></em>
1642 item, or -1 if it isn't found.</p>
1643 </div>
1644 </div>
1645 <hr>
1646 <div class="refsect2">
1647 <a name="goo-canvas-item-add-child"></a><h3>goo_canvas_item_add_child ()</h3>
1648 <pre class="programlisting"><span class="returnvalue">void</span>
1649 goo_canvas_item_add_child (<em class="parameter"><code><a class="link" href="GooCanvasItem.html" title="GooCanvasItem"><span class="type">GooCanvasItem</span></a> *item</code></em>,
1650 <em class="parameter"><code><a class="link" href="GooCanvasItem.html" title="GooCanvasItem"><span class="type">GooCanvasItem</span></a> *child</code></em>,
1651 <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> position</code></em>);</pre>
1652 <p>Adds a child item to a container item at the given stack position.</p>
1653 <div class="refsect3">
1654 <a name="goo-canvas-item-add-child.parameters"></a><h4>Parameters</h4>
1655 <div class="informaltable"><table width="100%" border="0">
1656 <colgroup>
1657 <col width="150px" class="parameters_name">
1658 <col class="parameters_description">
1659 <col width="200px" class="parameters_annotations">
1660 </colgroup>
1661 <tbody>
1662 <tr>
1663 <td class="parameter_name"><p>item</p></td>
1664 <td class="parameter_description"><p>the container to add the item to.</p></td>
1665 <td class="parameter_annotations"> </td>
1666 </tr>
1667 <tr>
1668 <td class="parameter_name"><p>child</p></td>
1669 <td class="parameter_description"><p>the item to add.</p></td>
1670 <td class="parameter_annotations"> </td>
1671 </tr>
1672 <tr>
1673 <td class="parameter_name"><p>position</p></td>
1674 <td class="parameter_description"><p>the position of the item, or -1 to place it last (at the top of
1675 the stacking order).</p></td>
1676 <td class="parameter_annotations"> </td>
1677 </tr>
1678 </tbody>
1679 </table></div>
1680 </div>
1681 </div>
1682 <hr>
1683 <div class="refsect2">
1684 <a name="goo-canvas-item-move-child"></a><h3>goo_canvas_item_move_child ()</h3>
1685 <pre class="programlisting"><span class="returnvalue">void</span>
1686 goo_canvas_item_move_child (<em class="parameter"><code><a class="link" href="GooCanvasItem.html" title="GooCanvasItem"><span class="type">GooCanvasItem</span></a> *item</code></em>,
1687 <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> old_position</code></em>,
1688 <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> new_position</code></em>);</pre>
1689 <p>Moves a child item to a new stack position within the container.</p>
1690 <div class="refsect3">
1691 <a name="goo-canvas-item-move-child.parameters"></a><h4>Parameters</h4>
1692 <div class="informaltable"><table width="100%" border="0">
1693 <colgroup>
1694 <col width="150px" class="parameters_name">
1695 <col class="parameters_description">
1696 <col width="200px" class="parameters_annotations">
1697 </colgroup>
1698 <tbody>
1699 <tr>
1700 <td class="parameter_name"><p>item</p></td>
1701 <td class="parameter_description"><p>a container item.</p></td>
1702 <td class="parameter_annotations"> </td>
1703 </tr>
1704 <tr>
1705 <td class="parameter_name"><p>old_position</p></td>
1706 <td class="parameter_description"><p>the current position of the child item.</p></td>
1707 <td class="parameter_annotations"> </td>
1708 </tr>
1709 <tr>
1710 <td class="parameter_name"><p>new_position</p></td>
1711 <td class="parameter_description"><p>the new position of the child item.</p></td>
1712 <td class="parameter_annotations"> </td>
1713 </tr>
1714 </tbody>
1715 </table></div>
1716 </div>
1717 </div>
1718 <hr>
1719 <div class="refsect2">
1720 <a name="goo-canvas-item-remove-child"></a><h3>goo_canvas_item_remove_child ()</h3>
1721 <pre class="programlisting"><span class="returnvalue">void</span>
1722 goo_canvas_item_remove_child (<em class="parameter"><code><a class="link" href="GooCanvasItem.html" title="GooCanvasItem"><span class="type">GooCanvasItem</span></a> *item</code></em>,
1723 <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> child_num</code></em>);</pre>
1724 <p>Removes the child item at the given position.</p>
1725 <div class="refsect3">
1726 <a name="goo-canvas-item-remove-child.parameters"></a><h4>Parameters</h4>
1727 <div class="informaltable"><table width="100%" border="0">
1728 <colgroup>
1729 <col width="150px" class="parameters_name">
1730 <col class="parameters_description">
1731 <col width="200px" class="parameters_annotations">
1732 </colgroup>
1733 <tbody>
1734 <tr>
1735 <td class="parameter_name"><p>item</p></td>
1736 <td class="parameter_description"><p>a container item.</p></td>
1737 <td class="parameter_annotations"> </td>
1738 </tr>
1739 <tr>
1740 <td class="parameter_name"><p>child_num</p></td>
1741 <td class="parameter_description"><p>the position of the child item to remove.</p></td>
1742 <td class="parameter_annotations"> </td>
1743 </tr>
1744 </tbody>
1745 </table></div>
1746 </div>
1747 </div>
1748 <hr>
1749 <div class="refsect2">
1750 <a name="goo-canvas-item-get-transform-for-child"></a><h3>goo_canvas_item_get_transform_for_child ()</h3>
1751 <pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
1752 goo_canvas_item_get_transform_for_child
1753 (<em class="parameter"><code><a class="link" href="GooCanvasItem.html" title="GooCanvasItem"><span class="type">GooCanvasItem</span></a> *item</code></em>,
1754 <em class="parameter"><code><a class="link" href="GooCanvasItem.html" title="GooCanvasItem"><span class="type">GooCanvasItem</span></a> *child</code></em>,
1755 <em class="parameter"><code><a href="/usr/share/gtk-doc/html/cairo/cairo-cairo-matrix-t.html#cairo-matrix-t"><span class="type">cairo_matrix_t</span></a> *transform</code></em>);</pre>
1756 <p>Gets the transformation matrix of an item combined with any special
1757 transform needed for the given child. These special transforms are used
1758 by layout items such as <a class="link" href="GooCanvasTable.html" title="GooCanvasTable"><span class="type">GooCanvasTable</span></a>.</p>
1759 <div class="refsect3">
1760 <a name="goo-canvas-item-get-transform-for-child.parameters"></a><h4>Parameters</h4>
1761 <div class="informaltable"><table width="100%" border="0">
1762 <colgroup>
1763 <col width="150px" class="parameters_name">
1764 <col class="parameters_description">
1765 <col width="200px" class="parameters_annotations">
1766 </colgroup>
1767 <tbody>
1768 <tr>
1769 <td class="parameter_name"><p>item</p></td>
1770 <td class="parameter_description"><p>an item.</p></td>
1771 <td class="parameter_annotations"> </td>
1772 </tr>
1773 <tr>
1774 <td class="parameter_name"><p>child</p></td>
1775 <td class="parameter_description"><p>a child of <em class="parameter"><code>item</code></em>
1776 .</p></td>
1777 <td class="parameter_annotations"> </td>
1778 </tr>
1779 <tr>
1780 <td class="parameter_name"><p>transform</p></td>
1781 <td class="parameter_description"><p>the place to store the transform. </p></td>
1782 <td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span></td>
1783 </tr>
1784 </tbody>
1785 </table></div>
1786 </div>
1787 <div class="refsect3">
1788 <a name="goo-canvas-item-get-transform-for-child.returns"></a><h4>Returns</h4>
1789 <p> <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if a transform is set.</p>
1790 </div>
1791 </div>
1792 <hr>
1793 <div class="refsect2">
1794 <a name="goo-canvas-item-get-style"></a><h3>goo_canvas_item_get_style ()</h3>
1795 <pre class="programlisting"><a class="link" href="GooCanvasStyle.html" title="GooCanvasStyle"><span class="returnvalue">GooCanvasStyle</span></a> *
1796 goo_canvas_item_get_style (<em class="parameter"><code><a class="link" href="GooCanvasItem.html" title="GooCanvasItem"><span class="type">GooCanvasItem</span></a> *item</code></em>);</pre>
1797 <p>Gets the item's style. If the item doesn't have its own style it will return
1798 its parent's style.</p>
1799 <div class="refsect3">
1800 <a name="goo-canvas-item-get-style.parameters"></a><h4>Parameters</h4>
1801 <div class="informaltable"><table width="100%" border="0">
1802 <colgroup>
1803 <col width="150px" class="parameters_name">
1804 <col class="parameters_description">
1805 <col width="200px" class="parameters_annotations">
1806 </colgroup>
1807 <tbody><tr>
1808 <td class="parameter_name"><p>item</p></td>
1809 <td class="parameter_description"><p>an item.</p></td>
1810 <td class="parameter_annotations"> </td>
1811 </tr></tbody>
1812 </table></div>
1813 </div>
1814 <div class="refsect3">
1815 <a name="goo-canvas-item-get-style.returns"></a><h4>Returns</h4>
1816 <p>the item's style. </p>
1817 <p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
1818 </div>
1819 </div>
1820 <hr>
1821 <div class="refsect2">
1822 <a name="goo-canvas-item-set-style"></a><h3>goo_canvas_item_set_style ()</h3>
1823 <pre class="programlisting"><span class="returnvalue">void</span>
1824 goo_canvas_item_set_style (<em class="parameter"><code><a class="link" href="GooCanvasItem.html" title="GooCanvasItem"><span class="type">GooCanvasItem</span></a> *item</code></em>,
1825 <em class="parameter"><code><a class="link" href="GooCanvasStyle.html" title="GooCanvasStyle"><span class="type">GooCanvasStyle</span></a> *style</code></em>);</pre>
1826 <p>Sets the item's style, by copying the properties from the given style.</p>
1827 <div class="refsect3">
1828 <a name="goo-canvas-item-set-style.parameters"></a><h4>Parameters</h4>
1829 <div class="informaltable"><table width="100%" border="0">
1830 <colgroup>
1831 <col width="150px" class="parameters_name">
1832 <col class="parameters_description">
1833 <col width="200px" class="parameters_annotations">
1834 </colgroup>
1835 <tbody>
1836 <tr>
1837 <td class="parameter_name"><p>item</p></td>
1838 <td class="parameter_description"><p>an item.</p></td>
1839 <td class="parameter_annotations"> </td>
1840 </tr>
1841 <tr>
1842 <td class="parameter_name"><p>style</p></td>
1843 <td class="parameter_description"><p>a style.</p></td>
1844 <td class="parameter_annotations"> </td>
1845 </tr>
1846 </tbody>
1847 </table></div>
1848 </div>
1849 </div>
1850 <hr>
1851 <div class="refsect2">
1852 <a name="goo-canvas-item-request-update"></a><h3>goo_canvas_item_request_update ()</h3>
1853 <pre class="programlisting"><span class="returnvalue">void</span>
1854 goo_canvas_item_request_update (<em class="parameter"><code><a class="link" href="GooCanvasItem.html" title="GooCanvasItem"><span class="type">GooCanvasItem</span></a> *item</code></em>);</pre>
1855 <p>This function is only intended to be used when implementing new canvas
1856 items.</p>
1857 <p>It requests that an update of the item is scheduled. It will be performed
1858 as soon as the application is idle, and before the canvas is redrawn.</p>
1859 <div class="refsect3">
1860 <a name="goo-canvas-item-request-update.parameters"></a><h4>Parameters</h4>
1861 <div class="informaltable"><table width="100%" border="0">
1862 <colgroup>
1863 <col width="150px" class="parameters_name">
1864 <col class="parameters_description">
1865 <col width="200px" class="parameters_annotations">
1866 </colgroup>
1867 <tbody><tr>
1868 <td class="parameter_name"><p>item</p></td>
1869 <td class="parameter_description"><p>a <a class="link" href="GooCanvasItem.html" title="GooCanvasItem"><span class="type">GooCanvasItem</span></a>.</p></td>
1870 <td class="parameter_annotations"> </td>
1871 </tr></tbody>
1872 </table></div>
1873 </div>
1874 </div>
1875 <hr>
1876 <div class="refsect2">
1877 <a name="goo-canvas-item-ensure-updated"></a><h3>goo_canvas_item_ensure_updated ()</h3>
1878 <pre class="programlisting"><span class="returnvalue">void</span>
1879 goo_canvas_item_ensure_updated (<em class="parameter"><code><a class="link" href="GooCanvasItem.html" title="GooCanvasItem"><span class="type">GooCanvasItem</span></a> *item</code></em>);</pre>
1880 <p>This function is only intended to be used when implementing new canvas
1881 items.</p>
1882 <p>It updates the canvas immediately, if an update is scheduled.
1883 This ensures that all item bounds are up-to-date.</p>
1884 <div class="refsect3">
1885 <a name="goo-canvas-item-ensure-updated.parameters"></a><h4>Parameters</h4>
1886 <div class="informaltable"><table width="100%" border="0">
1887 <colgroup>
1888 <col width="150px" class="parameters_name">
1889 <col class="parameters_description">
1890 <col width="200px" class="parameters_annotations">
1891 </colgroup>
1892 <tbody><tr>
1893 <td class="parameter_name"><p>item</p></td>
1894 <td class="parameter_description"><p>a <a class="link" href="GooCanvasItem.html" title="GooCanvasItem"><span class="type">GooCanvasItem</span></a>.</p></td>
1895 <td class="parameter_annotations"> </td>
1896 </tr></tbody>
1897 </table></div>
1898 </div>
1899 </div>
1900 <hr>
1901 <div class="refsect2">
1902 <a name="goo-canvas-item-update"></a><h3>goo_canvas_item_update ()</h3>
1903 <pre class="programlisting"><span class="returnvalue">void</span>
1904 goo_canvas_item_update (<em class="parameter"><code><a class="link" href="GooCanvasItem.html" title="GooCanvasItem"><span class="type">GooCanvasItem</span></a> *item</code></em>,
1905 <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> entire_tree</code></em>,
1906 <em class="parameter"><code><a href="/usr/share/gtk-doc/html/cairo/cairo-cairo-t.html#cairo-t"><span class="type">cairo_t</span></a> *cr</code></em>,
1907 <em class="parameter"><code><a class="link" href="goocanvas2-GooCanvas-Types.html#GooCanvasBounds" title="struct GooCanvasBounds"><span class="type">GooCanvasBounds</span></a> *bounds</code></em>);</pre>
1908 <p>This function is only intended to be used when implementing new canvas
1909 items, specifically container items such as <a class="link" href="GooCanvasGroup.html" title="GooCanvasGroup"><span class="type">GooCanvasGroup</span></a>.</p>
1910 <p>Updates the item, if needed, and any children.</p>
1911 <div class="refsect3">
1912 <a name="goo-canvas-item-update.parameters"></a><h4>Parameters</h4>
1913 <div class="informaltable"><table width="100%" border="0">
1914 <colgroup>
1915 <col width="150px" class="parameters_name">
1916 <col class="parameters_description">
1917 <col width="200px" class="parameters_annotations">
1918 </colgroup>
1919 <tbody>
1920 <tr>
1921 <td class="parameter_name"><p>item</p></td>
1922 <td class="parameter_description"><p>a <a class="link" href="GooCanvasItem.html" title="GooCanvasItem"><span class="type">GooCanvasItem</span></a>.</p></td>
1923 <td class="parameter_annotations"> </td>
1924 </tr>
1925 <tr>
1926 <td class="parameter_name"><p>entire_tree</p></td>
1927 <td class="parameter_description"><p>if the entire subtree should be updated.</p></td>
1928 <td class="parameter_annotations"> </td>
1929 </tr>
1930 <tr>
1931 <td class="parameter_name"><p>cr</p></td>
1932 <td class="parameter_description"><p>a cairo context.</p></td>
1933 <td class="parameter_annotations"> </td>
1934 </tr>
1935 <tr>
1936 <td class="parameter_name"><p>bounds</p></td>
1937 <td class="parameter_description"><p>a <a class="link" href="goocanvas2-GooCanvas-Types.html#GooCanvasBounds" title="struct GooCanvasBounds"><span class="type">GooCanvasBounds</span></a> to return the new bounds in.</p></td>
1938 <td class="parameter_annotations"> </td>
1939 </tr>
1940 </tbody>
1941 </table></div>
1942 </div>
1943 </div>
1944 <hr>
1945 <div class="refsect2">
1946 <a name="goo-canvas-item-get-requested-area"></a><h3>goo_canvas_item_get_requested_area ()</h3>
1947 <pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
1948 goo_canvas_item_get_requested_area (<em class="parameter"><code><a class="link" href="GooCanvasItem.html" title="GooCanvasItem"><span class="type">GooCanvasItem</span></a> *item</code></em>,
1949 <em class="parameter"><code><a href="/usr/share/gtk-doc/html/cairo/cairo-cairo-t.html#cairo-t"><span class="type">cairo_t</span></a> *cr</code></em>,
1950 <em class="parameter"><code><a class="link" href="goocanvas2-GooCanvas-Types.html#GooCanvasBounds" title="struct GooCanvasBounds"><span class="type">GooCanvasBounds</span></a> *requested_area</code></em>);</pre>
1951 <p>This function is only intended to be used when implementing new canvas
1952 items, specifically layout items such as <a class="link" href="GooCanvasTable.html" title="GooCanvasTable"><span class="type">GooCanvasTable</span></a>.</p>
1953 <p>It gets the requested area of a child item.</p>
1954 <div class="refsect3">
1955 <a name="goo-canvas-item-get-requested-area.parameters"></a><h4>Parameters</h4>
1956 <div class="informaltable"><table width="100%" border="0">
1957 <colgroup>
1958 <col width="150px" class="parameters_name">
1959 <col class="parameters_description">
1960 <col width="200px" class="parameters_annotations">
1961 </colgroup>
1962 <tbody>
1963 <tr>
1964 <td class="parameter_name"><p>item</p></td>
1965 <td class="parameter_description"><p>a <a class="link" href="GooCanvasItem.html" title="GooCanvasItem"><span class="type">GooCanvasItem</span></a>.</p></td>
1966 <td class="parameter_annotations"> </td>
1967 </tr>
1968 <tr>
1969 <td class="parameter_name"><p>cr</p></td>
1970 <td class="parameter_description"><p>a cairo context.</p></td>
1971 <td class="parameter_annotations"> </td>
1972 </tr>
1973 <tr>
1974 <td class="parameter_name"><p>requested_area</p></td>
1975 <td class="parameter_description"><p>a <a class="link" href="goocanvas2-GooCanvas-Types.html#GooCanvasBounds" title="struct GooCanvasBounds"><span class="type">GooCanvasBounds</span></a> to return the requested area in, in the
1976 parent's coordinate space.</p></td>
1977 <td class="parameter_annotations"> </td>
1978 </tr>
1979 </tbody>
1980 </table></div>
1981 </div>
1982 <div class="refsect3">
1983 <a name="goo-canvas-item-get-requested-area.returns"></a><h4>Returns</h4>
1984 <p> <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the item should be allocated space.</p>
1985 </div>
1986 </div>
1987 <hr>
1988 <div class="refsect2">
1989 <a name="goo-canvas-item-get-requested-area-for-width"></a><h3>goo_canvas_item_get_requested_area_for_width ()</h3>
1990 <pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
1991 goo_canvas_item_get_requested_area_for_width
1992 (<em class="parameter"><code><a class="link" href="GooCanvasItem.html" title="GooCanvasItem"><span class="type">GooCanvasItem</span></a> *item</code></em>,
1993 <em class="parameter"><code><a href="/usr/share/gtk-doc/html/cairo/cairo-cairo-t.html#cairo-t"><span class="type">cairo_t</span></a> *cr</code></em>,
1994 <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> width</code></em>,
1995 <em class="parameter"><code><a class="link" href="goocanvas2-GooCanvas-Types.html#GooCanvasBounds" title="struct GooCanvasBounds"><span class="type">GooCanvasBounds</span></a> *requested_area</code></em>);</pre>
1996 <p>This function is only intended to be used when implementing new canvas
1997 items, specifically layout items such as <a class="link" href="GooCanvasTable.html" title="GooCanvasTable"><span class="type">GooCanvasTable</span></a>.</p>
1998 <p>It gets the requested area of a child item, assuming it is allocated the
1999 given width. This is useful for text items whose requested height may change
2000 depending on the allocated width.</p>
2001 <div class="refsect3">
2002 <a name="goo-canvas-item-get-requested-area-for-width.parameters"></a><h4>Parameters</h4>
2003 <div class="informaltable"><table width="100%" border="0">
2004 <colgroup>
2005 <col width="150px" class="parameters_name">
2006 <col class="parameters_description">
2007 <col width="200px" class="parameters_annotations">
2008 </colgroup>
2009 <tbody>
2010 <tr>
2011 <td class="parameter_name"><p>item</p></td>
2012 <td class="parameter_description"><p>a <a class="link" href="GooCanvasItem.html" title="GooCanvasItem"><span class="type">GooCanvasItem</span></a>.</p></td>
2013 <td class="parameter_annotations"> </td>
2014 </tr>
2015 <tr>
2016 <td class="parameter_name"><p>cr</p></td>
2017 <td class="parameter_description"><p>a cairo context.</p></td>
2018 <td class="parameter_annotations"> </td>
2019 </tr>
2020 <tr>
2021 <td class="parameter_name"><p>width</p></td>
2022 <td class="parameter_description"><p>the allocated width.</p></td>
2023 <td class="parameter_annotations"> </td>
2024 </tr>
2025 <tr>
2026 <td class="parameter_name"><p>requested_area</p></td>
2027 <td class="parameter_description"><p>a <a class="link" href="goocanvas2-GooCanvas-Types.html#GooCanvasBounds" title="struct GooCanvasBounds"><span class="type">GooCanvasBounds</span></a> to return the requested area in, in the
2028 parent's coordinate space. If <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> is returned, this is undefined.</p></td>
2029 <td class="parameter_annotations"> </td>
2030 </tr>
2031 </tbody>
2032 </table></div>
2033 </div>
2034 <div class="refsect3">
2035 <a name="goo-canvas-item-get-requested-area-for-width.returns"></a><h4>Returns</h4>
2036 <p> <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the item's requested area changes due to the new allocated
2037 width.</p>
2038 </div>
2039 <p class="since">Since: <a class="link" href="api-index-2.0.1.html" title="API Index v2.0.1">2.0.1</a></p>
2040 </div>
2041 <hr>
2042 <div class="refsect2">
2043 <a name="goo-canvas-item-get-requested-height"></a><h3>goo_canvas_item_get_requested_height ()</h3>
2044 <pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gdouble"><span class="returnvalue">gdouble</span></a>
2045 goo_canvas_item_get_requested_height (<em class="parameter"><code><a class="link" href="GooCanvasItem.html" title="GooCanvasItem"><span class="type">GooCanvasItem</span></a> *item</code></em>,
2046 <em class="parameter"><code><a href="/usr/share/gtk-doc/html/cairo/cairo-cairo-t.html#cairo-t"><span class="type">cairo_t</span></a> *cr</code></em>,
2047 <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> width</code></em>);</pre>
2048 <p>This function is only intended to be used when implementing new canvas
2049 items, specifically layout items such as <a class="link" href="GooCanvasTable.html" title="GooCanvasTable"><span class="type">GooCanvasTable</span></a>.</p>
2050 <p>It gets the requested height of a child item, assuming it is allocated the
2051 given width. This is useful for text items whose requested height may change
2052 depending on the allocated width.</p>
2053 <div class="refsect3">
2054 <a name="goo-canvas-item-get-requested-height.parameters"></a><h4>Parameters</h4>
2055 <div class="informaltable"><table width="100%" border="0">
2056 <colgroup>
2057 <col width="150px" class="parameters_name">
2058 <col class="parameters_description">
2059 <col width="200px" class="parameters_annotations">
2060 </colgroup>
2061 <tbody>
2062 <tr>
2063 <td class="parameter_name"><p>item</p></td>
2064 <td class="parameter_description"><p>a <a class="link" href="GooCanvasItem.html" title="GooCanvasItem"><span class="type">GooCanvasItem</span></a>.</p></td>
2065 <td class="parameter_annotations"> </td>
2066 </tr>
2067 <tr>
2068 <td class="parameter_name"><p>cr</p></td>
2069 <td class="parameter_description"><p>a cairo context.</p></td>
2070 <td class="parameter_annotations"> </td>
2071 </tr>
2072 <tr>
2073 <td class="parameter_name"><p>width</p></td>
2074 <td class="parameter_description"><p>the width that the item may be allocated.</p></td>
2075 <td class="parameter_annotations"> </td>
2076 </tr>
2077 </tbody>
2078 </table></div>
2079 </div>
2080 <div class="refsect3">
2081 <a name="goo-canvas-item-get-requested-height.returns"></a><h4>Returns</h4>
2082 <p> the requested height of the item, given the allocated width,
2083 or <code class="literal">-1</code> if the item doesn't support this method or its height doesn't
2084 change when allocated different widths.</p>
2085 </div>
2086 </div>
2087 <hr>
2088 <div class="refsect2">
2089 <a name="goo-canvas-item-allocate-area"></a><h3>goo_canvas_item_allocate_area ()</h3>
2090 <pre class="programlisting"><span class="returnvalue">void</span>
2091 goo_canvas_item_allocate_area (<em class="parameter"><code><a class="link" href="GooCanvasItem.html" title="GooCanvasItem"><span class="type">GooCanvasItem</span></a> *item</code></em>,
2092 <em class="parameter"><code><a href="/usr/share/gtk-doc/html/cairo/cairo-cairo-t.html#cairo-t"><span class="type">cairo_t</span></a> *cr</code></em>,
2093 <em class="parameter"><code>const <a class="link" href="goocanvas2-GooCanvas-Types.html#GooCanvasBounds" title="struct GooCanvasBounds"><span class="type">GooCanvasBounds</span></a> *requested_area</code></em>,
2094 <em class="parameter"><code>const <a class="link" href="goocanvas2-GooCanvas-Types.html#GooCanvasBounds" title="struct GooCanvasBounds"><span class="type">GooCanvasBounds</span></a> *allocated_area</code></em>,
2095 <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> x_offset</code></em>,
2096 <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> y_offset</code></em>);</pre>
2097 <p>This function is only intended to be used when implementing new canvas
2098 items, specifically layout items such as <a class="link" href="GooCanvasTable.html" title="GooCanvasTable"><span class="type">GooCanvasTable</span></a>.</p>
2099 <p>It allocates an area to a child <a class="link" href="GooCanvasItem.html" title="GooCanvasItem"><span class="type">GooCanvasItem</span></a>.</p>
2100 <p>Note that the parent layout item will use a transform to move each of its
2101 children for the layout, so there is no need for the child item to
2102 reposition itself. It only needs to recalculate its device bounds.</p>
2103 <p>To help recalculate the item's device bounds, the <em class="parameter"><code>x_offset</code></em>
2104 and <em class="parameter"><code>y_offset</code></em>
2105
2106 of the child item's allocated position from its requested position are
2107 provided. Simple items can just add these to their bounds.</p>
2108 <div class="refsect3">
2109 <a name="goo-canvas-item-allocate-area.parameters"></a><h4>Parameters</h4>
2110 <div class="informaltable"><table width="100%" border="0">
2111 <colgroup>
2112 <col width="150px" class="parameters_name">
2113 <col class="parameters_description">
2114 <col width="200px" class="parameters_annotations">
2115 </colgroup>
2116 <tbody>
2117 <tr>
2118 <td class="parameter_name"><p>item</p></td>
2119 <td class="parameter_description"><p>a <a class="link" href="GooCanvasItem.html" title="GooCanvasItem"><span class="type">GooCanvasItem</span></a>.</p></td>
2120 <td class="parameter_annotations"> </td>
2121 </tr>
2122 <tr>
2123 <td class="parameter_name"><p>cr</p></td>
2124 <td class="parameter_description"><p>a cairo context.</p></td>
2125 <td class="parameter_annotations"> </td>
2126 </tr>
2127 <tr>
2128 <td class="parameter_name"><p>requested_area</p></td>
2129 <td class="parameter_description"><p>the area that the item originally requested, in the
2130 parent's coordinate space.</p></td>
2131 <td class="parameter_annotations"> </td>
2132 </tr>
2133 <tr>
2134 <td class="parameter_name"><p>allocated_area</p></td>
2135 <td class="parameter_description"><p>the area that the item has been allocated, in the parent's
2136 coordinate space.</p></td>
2137 <td class="parameter_annotations"> </td>
2138 </tr>
2139 <tr>
2140 <td class="parameter_name"><p>x_offset</p></td>
2141 <td class="parameter_description"><p>the x offset of the allocated area from the requested area in
2142 the device coordinate space.</p></td>
2143 <td class="parameter_annotations"> </td>
2144 </tr>
2145 <tr>
2146 <td class="parameter_name"><p>y_offset</p></td>
2147 <td class="parameter_description"><p>the y offset of the allocated area from the requested area in
2148 the device coordinate space.</p></td>
2149 <td class="parameter_annotations"> </td>
2150 </tr>
2151 </tbody>
2152 </table></div>
2153 </div>
2154 </div>
2155 <hr>
2156 <div class="refsect2">
2157 <a name="goo-canvas-item-get-items-at"></a><h3>goo_canvas_item_get_items_at ()</h3>
2158 <pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> *
2159 goo_canvas_item_get_items_at (<em class="parameter"><code><a class="link" href="GooCanvasItem.html" title="GooCanvasItem"><span class="type">GooCanvasItem</span></a> *item</code></em>,
2160 <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> x</code></em>,
2161 <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> y</code></em>,
2162 <em class="parameter"><code><a href="/usr/share/gtk-doc/html/cairo/cairo-cairo-t.html#cairo-t"><span class="type">cairo_t</span></a> *cr</code></em>,
2163 <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> is_pointer_event</code></em>,
2164 <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> parent_is_visible</code></em>,
2165 <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a> *found_items</code></em>);</pre>
2166 <p>This function is only intended to be used when implementing new canvas
2167 items, specifically container items such as <a class="link" href="GooCanvasGroup.html" title="GooCanvasGroup"><span class="type">GooCanvasGroup</span></a>.</p>
2168 <p>It gets the items at the given point.</p>
2169 <div class="refsect3">
2170 <a name="goo-canvas-item-get-items-at.parameters"></a><h4>Parameters</h4>
2171 <div class="informaltable"><table width="100%" border="0">
2172 <colgroup>
2173 <col width="150px" class="parameters_name">
2174 <col class="parameters_description">
2175 <col width="200px" class="parameters_annotations">
2176 </colgroup>
2177 <tbody>
2178 <tr>
2179 <td class="parameter_name"><p>item</p></td>
2180 <td class="parameter_description"><p>a <a class="link" href="GooCanvasItem.html" title="GooCanvasItem"><span class="type">GooCanvasItem</span></a>.</p></td>
2181 <td class="parameter_annotations"> </td>
2182 </tr>
2183 <tr>
2184 <td class="parameter_name"><p>x</p></td>
2185 <td class="parameter_description"><p>the x coordinate of the point.</p></td>
2186 <td class="parameter_annotations"> </td>
2187 </tr>
2188 <tr>
2189 <td class="parameter_name"><p>y</p></td>
2190 <td class="parameter_description"><p>the y coordinate of the point.</p></td>
2191 <td class="parameter_annotations"> </td>
2192 </tr>
2193 <tr>
2194 <td class="parameter_name"><p>cr</p></td>
2195 <td class="parameter_description"><p>a cairo contect.</p></td>
2196 <td class="parameter_annotations"> </td>
2197 </tr>
2198 <tr>
2199 <td class="parameter_name"><p>is_pointer_event</p></td>
2200 <td class="parameter_description"><p><a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the "pointer-events" properties of items should
2201 be used to determine which parts of the item are tested.</p></td>
2202 <td class="parameter_annotations"> </td>
2203 </tr>
2204 <tr>
2205 <td class="parameter_name"><p>parent_is_visible</p></td>
2206 <td class="parameter_description"><p><a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the parent item is visible (which
2207 implies that all ancestors are also visible).</p></td>
2208 <td class="parameter_annotations"> </td>
2209 </tr>
2210 <tr>
2211 <td class="parameter_name"><p>found_items</p></td>
2212 <td class="parameter_description"><p>the list of items found
2213 so far. </p></td>
2214 <td class="parameter_annotations"><span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> GooCanvas.CanvasItem]</span></td>
2215 </tr>
2216 </tbody>
2217 </table></div>
2218 </div>
2219 <div class="refsect3">
2220 <a name="goo-canvas-item-get-items-at.returns"></a><h4>Returns</h4>
2221 <p>the
2222 <em class="parameter"><code>found_items</code></em>
2223 list, with any more found items
2224 added onto the start of the list, leaving the top item first. </p>
2225 <p><span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> GooCanvas.CanvasItem][<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
2226 </div>
2227 </div>
2228 <hr>
2229 <div class="refsect2">
2230 <a name="goo-canvas-item-paint"></a><h3>goo_canvas_item_paint ()</h3>
2231 <pre class="programlisting"><span class="returnvalue">void</span>
2232 goo_canvas_item_paint (<em class="parameter"><code><a class="link" href="GooCanvasItem.html" title="GooCanvasItem"><span class="type">GooCanvasItem</span></a> *item</code></em>,
2233 <em class="parameter"><code><a href="/usr/share/gtk-doc/html/cairo/cairo-cairo-t.html#cairo-t"><span class="type">cairo_t</span></a> *cr</code></em>,
2234 <em class="parameter"><code>const <a class="link" href="goocanvas2-GooCanvas-Types.html#GooCanvasBounds" title="struct GooCanvasBounds"><span class="type">GooCanvasBounds</span></a> *bounds</code></em>,
2235 <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> scale</code></em>);</pre>
2236 <p>This function is only intended to be used when implementing new canvas
2237 items, specifically container items such as <a class="link" href="GooCanvasGroup.html" title="GooCanvasGroup"><span class="type">GooCanvasGroup</span></a>.</p>
2238 <p>It paints the item and all children if they intersect the given bounds.</p>
2239 <p>Note that the <em class="parameter"><code>scale</code></em>
2240 argument may be different to the current scale in the
2241 <a class="link" href="GooCanvasItem.html" title="GooCanvasItem"><span class="type">GooCanvasItem</span></a>, e.g. when the canvas is being printed.</p>
2242 <div class="refsect3">
2243 <a name="goo-canvas-item-paint.parameters"></a><h4>Parameters</h4>
2244 <div class="informaltable"><table width="100%" border="0">
2245 <colgroup>
2246 <col width="150px" class="parameters_name">
2247 <col class="parameters_description">
2248 <col width="200px" class="parameters_annotations">
2249 </colgroup>
2250 <tbody>
2251 <tr>
2252 <td class="parameter_name"><p>item</p></td>
2253 <td class="parameter_description"><p>a <a class="link" href="GooCanvasItem.html" title="GooCanvasItem"><span class="type">GooCanvasItem</span></a>.</p></td>
2254 <td class="parameter_annotations"> </td>
2255 </tr>
2256 <tr>
2257 <td class="parameter_name"><p>cr</p></td>
2258 <td class="parameter_description"><p>a cairo context.</p></td>
2259 <td class="parameter_annotations"> </td>
2260 </tr>
2261 <tr>
2262 <td class="parameter_name"><p>bounds</p></td>
2263 <td class="parameter_description"><p>the bounds that need to be repainted, in device space.</p></td>
2264 <td class="parameter_annotations"> </td>
2265 </tr>
2266 <tr>
2267 <td class="parameter_name"><p>scale</p></td>
2268 <td class="parameter_description"><p>the scale to use to determine whether an item should be painted.
2269 See <a class="link" href="GooCanvasItem.html#GooCanvasItem--visibility-threshold" title="The “visibility-threshold” property"><span class="type">“visibility-threshold”</span></a>.</p></td>
2270 <td class="parameter_annotations"> </td>
2271 </tr>
2272 </tbody>
2273 </table></div>
2274 </div>
2275 </div>
2276 <hr>
2277 <div class="refsect2">
2278 <a name="goo-canvas-item-class-install-child-property"></a><h3>goo_canvas_item_class_install_child_property ()</h3>
2279 <pre class="programlisting"><span class="returnvalue">void</span>
2280 goo_canvas_item_class_install_child_property
2281 (<em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObjectClass"><span class="type">GObjectClass</span></a> *iclass</code></em>,
2282 <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> property_id</code></em>,
2283 <em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> *pspec</code></em>);</pre>
2284 <p>This function is only intended to be used when implementing new canvas
2285 items, specifically layout container items such as <a class="link" href="GooCanvasTable.html" title="GooCanvasTable"><span class="type">GooCanvasTable</span></a>.</p>
2286 <p>It installs a child property on a canvas item class.</p>
2287 <div class="refsect3">
2288 <a name="goo-canvas-item-class-install-child-property.parameters"></a><h4>Parameters</h4>
2289 <div class="informaltable"><table width="100%" border="0">
2290 <colgroup>
2291 <col width="150px" class="parameters_name">
2292 <col class="parameters_description">
2293 <col width="200px" class="parameters_annotations">
2294 </colgroup>
2295 <tbody>
2296 <tr>
2297 <td class="parameter_name"><p>iclass</p></td>
2298 <td class="parameter_description"><p>a <a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObjectClass"><span class="type">GObjectClass</span></a></p></td>
2299 <td class="parameter_annotations"> </td>
2300 </tr>
2301 <tr>
2302 <td class="parameter_name"><p>property_id</p></td>
2303 <td class="parameter_description"><p>the id for the property</p></td>
2304 <td class="parameter_annotations"> </td>
2305 </tr>
2306 <tr>
2307 <td class="parameter_name"><p>pspec</p></td>
2308 <td class="parameter_description"><p>the <a href="/usr/share/gtk-doc/html/gobject/gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> for the property</p></td>
2309 <td class="parameter_annotations"> </td>
2310 </tr>
2311 </tbody>
2312 </table></div>
2313 </div>
2314 </div>
2315 <hr>
2316 <div class="refsect2">
2317 <a name="goo-canvas-item-class-list-child-properties"></a><h3>goo_canvas_item_class_list_child_properties ()</h3>
2318 <pre class="programlisting"><a href="/usr/share/gtk-doc/html/gobject/gobject-GParamSpec.html#GParamSpec"><span class="returnvalue">GParamSpec</span></a> **
2319 goo_canvas_item_class_list_child_properties
2320 (<em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObjectClass"><span class="type">GObjectClass</span></a> *iclass</code></em>,
2321 <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> *n_properties</code></em>);</pre>
2322 <p>This function is only intended to be used when implementing new canvas
2323 items, specifically layout container items such as <a class="link" href="GooCanvasTable.html" title="GooCanvasTable"><span class="type">GooCanvasTable</span></a>.</p>
2324 <p>It returns all child properties of a canvas item class.</p>
2325 <div class="refsect3">
2326 <a name="goo-canvas-item-class-list-child-properties.parameters"></a><h4>Parameters</h4>
2327 <div class="informaltable"><table width="100%" border="0">
2328 <colgroup>
2329 <col width="150px" class="parameters_name">
2330 <col class="parameters_description">
2331 <col width="200px" class="parameters_annotations">
2332 </colgroup>
2333 <tbody>
2334 <tr>
2335 <td class="parameter_name"><p>iclass</p></td>
2336 <td class="parameter_description"><p>a <a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObjectClass"><span class="type">GObjectClass</span></a></p></td>
2337 <td class="parameter_annotations"> </td>
2338 </tr>
2339 <tr>
2340 <td class="parameter_name"><p>n_properties</p></td>
2341 <td class="parameter_description"><p>location to return the number of child properties found. </p></td>
2342 <td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span></td>
2343 </tr>
2344 </tbody>
2345 </table></div>
2346 </div>
2347 <div class="refsect3">
2348 <a name="goo-canvas-item-class-list-child-properties.returns"></a><h4>Returns</h4>
2349 <p>a newly allocated
2350 array of <a href="/usr/share/gtk-doc/html/gobject/gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a>*. The array must be freed with <a href="/usr/share/gtk-doc/html/glib/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>. </p>
2351 <p><span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=n_properties][<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
2352 </div>
2353 </div>
2354 <hr>
2355 <div class="refsect2">
2356 <a name="goo-canvas-item-class-find-child-property"></a><h3>goo_canvas_item_class_find_child_property ()</h3>
2357 <pre class="programlisting"><a href="/usr/share/gtk-doc/html/gobject/gobject-GParamSpec.html#GParamSpec"><span class="returnvalue">GParamSpec</span></a> *
2358 goo_canvas_item_class_find_child_property
2359 (<em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObjectClass"><span class="type">GObjectClass</span></a> *iclass</code></em>,
2360 <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *property_name</code></em>);</pre>
2361 <p>This function is only intended to be used when implementing new canvas
2362 items, specifically layout container items such as <a class="link" href="GooCanvasTable.html" title="GooCanvasTable"><span class="type">GooCanvasTable</span></a>.</p>
2363 <p>It finds a child property of a canvas item class by name.</p>
2364 <div class="refsect3">
2365 <a name="goo-canvas-item-class-find-child-property.parameters"></a><h4>Parameters</h4>
2366 <div class="informaltable"><table width="100%" border="0">
2367 <colgroup>
2368 <col width="150px" class="parameters_name">
2369 <col class="parameters_description">
2370 <col width="200px" class="parameters_annotations">
2371 </colgroup>
2372 <tbody>
2373 <tr>
2374 <td class="parameter_name"><p>iclass</p></td>
2375 <td class="parameter_description"><p>a <a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObjectClass"><span class="type">GObjectClass</span></a></p></td>
2376 <td class="parameter_annotations"> </td>
2377 </tr>
2378 <tr>
2379 <td class="parameter_name"><p>property_name</p></td>
2380 <td class="parameter_description"><p>the name of the child property to find</p></td>
2381 <td class="parameter_annotations"> </td>
2382 </tr>
2383 </tbody>
2384 </table></div>
2385 </div>
2386 <div class="refsect3">
2387 <a name="goo-canvas-item-class-find-child-property.returns"></a><h4>Returns</h4>
2388 <p>the <a href="/usr/share/gtk-doc/html/gobject/gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> of the
2389 child property or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>class</code></em>
2390 has no child property with that name. </p>
2391 <p><span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> GObject.ParamSpec][<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
2392 </div>
2393 </div>
2394 <hr>
2395 <div class="refsect2">
2396 <a name="goo-canvas-item-get-child-property"></a><h3>goo_canvas_item_get_child_property ()</h3>
2397 <pre class="programlisting"><span class="returnvalue">void</span>
2398 goo_canvas_item_get_child_property (<em class="parameter"><code><a class="link" href="GooCanvasItem.html" title="GooCanvasItem"><span class="type">GooCanvasItem</span></a> *item</code></em>,
2399 <em class="parameter"><code><a class="link" href="GooCanvasItem.html" title="GooCanvasItem"><span class="type">GooCanvasItem</span></a> *child</code></em>,
2400 <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *property_name</code></em>,
2401 <em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>);</pre>
2402 <p>Gets a child property of <em class="parameter"><code>child</code></em>
2403 .</p>
2404 <div class="refsect3">
2405 <a name="goo-canvas-item-get-child-property.parameters"></a><h4>Parameters</h4>
2406 <div class="informaltable"><table width="100%" border="0">
2407 <colgroup>
2408 <col width="150px" class="parameters_name">
2409 <col class="parameters_description">
2410 <col width="200px" class="parameters_annotations">
2411 </colgroup>
2412 <tbody>
2413 <tr>
2414 <td class="parameter_name"><p>item</p></td>
2415 <td class="parameter_description"><p>a <a class="link" href="GooCanvasItem.html" title="GooCanvasItem"><span class="type">GooCanvasItem</span></a>.</p></td>
2416 <td class="parameter_annotations"> </td>
2417 </tr>
2418 <tr>
2419 <td class="parameter_name"><p>child</p></td>
2420 <td class="parameter_description"><p>a child <a class="link" href="GooCanvasItem.html" title="GooCanvasItem"><span class="type">GooCanvasItem</span></a>.</p></td>
2421 <td class="parameter_annotations"> </td>
2422 </tr>
2423 <tr>
2424 <td class="parameter_name"><p>property_name</p></td>
2425 <td class="parameter_description"><p>the name of the child property to get.</p></td>
2426 <td class="parameter_annotations"> </td>
2427 </tr>
2428 <tr>
2429 <td class="parameter_name"><p>value</p></td>
2430 <td class="parameter_description"><p>a location to return the value.</p></td>
2431 <td class="parameter_annotations"> </td>
2432 </tr>
2433 </tbody>
2434 </table></div>
2435 </div>
2436 </div>
2437 <hr>
2438 <div class="refsect2">
2439 <a name="goo-canvas-item-set-child-property"></a><h3>goo_canvas_item_set_child_property ()</h3>
2440 <pre class="programlisting"><span class="returnvalue">void</span>
2441 goo_canvas_item_set_child_property (<em class="parameter"><code><a class="link" href="GooCanvasItem.html" title="GooCanvasItem"><span class="type">GooCanvasItem</span></a> *item</code></em>,
2442 <em class="parameter"><code><a class="link" href="GooCanvasItem.html" title="GooCanvasItem"><span class="type">GooCanvasItem</span></a> *child</code></em>,
2443 <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *property_name</code></em>,
2444 <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/gobject/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>);</pre>
2445 <p>Sets a child property of <em class="parameter"><code>child</code></em>
2446 .</p>
2447 <div class="refsect3">
2448 <a name="goo-canvas-item-set-child-property.parameters"></a><h4>Parameters</h4>
2449 <div class="informaltable"><table width="100%" border="0">
2450 <colgroup>
2451 <col width="150px" class="parameters_name">
2452 <col class="parameters_description">
2453 <col width="200px" class="parameters_annotations">
2454 </colgroup>
2455 <tbody>
2456 <tr>
2457 <td class="parameter_name"><p>item</p></td>
2458 <td class="parameter_description"><p>a <a class="link" href="GooCanvasItem.html" title="GooCanvasItem"><span class="type">GooCanvasItem</span></a>.</p></td>
2459 <td class="parameter_annotations"> </td>
2460 </tr>
2461 <tr>
2462 <td class="parameter_name"><p>child</p></td>
2463 <td class="parameter_description"><p>a child <a class="link" href="GooCanvasItem.html" title="GooCanvasItem"><span class="type">GooCanvasItem</span></a>.</p></td>
2464 <td class="parameter_annotations"> </td>
2465 </tr>
2466 <tr>
2467 <td class="parameter_name"><p>property_name</p></td>
2468 <td class="parameter_description"><p>the name of the child property to set.</p></td>
2469 <td class="parameter_annotations"> </td>
2470 </tr>
2471 <tr>
2472 <td class="parameter_name"><p>value</p></td>
2473 <td class="parameter_description"><p>the value to set the property to.</p></td>
2474 <td class="parameter_annotations"> </td>
2475 </tr>
2476 </tbody>
2477 </table></div>
2478 </div>
2479 </div>
2480 <hr>
2481 <div class="refsect2">
2482 <a name="goo-canvas-item-get-child-properties"></a><h3>goo_canvas_item_get_child_properties ()</h3>
2483 <pre class="programlisting"><span class="returnvalue">void</span>
2484 goo_canvas_item_get_child_properties (<em class="parameter"><code><a class="link" href="GooCanvasItem.html" title="GooCanvasItem"><span class="type">GooCanvasItem</span></a> *item</code></em>,
2485 <em class="parameter"><code><a class="link" href="GooCanvasItem.html" title="GooCanvasItem"><span class="type">GooCanvasItem</span></a> *child</code></em>,
2486 <em class="parameter"><code>...</code></em>);</pre>
2487 <p>Gets the values of one or more child properties of <em class="parameter"><code>child</code></em>
2488 .</p>
2489 <div class="refsect3">
2490 <a name="goo-canvas-item-get-child-properties.parameters"></a><h4>Parameters</h4>
2491 <div class="informaltable"><table width="100%" border="0">
2492 <colgroup>
2493 <col width="150px" class="parameters_name">
2494 <col class="parameters_description">
2495 <col width="200px" class="parameters_annotations">
2496 </colgroup>
2497 <tbody>
2498 <tr>
2499 <td class="parameter_name"><p>item</p></td>
2500 <td class="parameter_description"><p>a <a class="link" href="GooCanvasItem.html" title="GooCanvasItem"><span class="type">GooCanvasItem</span></a>.</p></td>
2501 <td class="parameter_annotations"> </td>
2502 </tr>
2503 <tr>
2504 <td class="parameter_name"><p>child</p></td>
2505 <td class="parameter_description"><p>a child <a class="link" href="GooCanvasItem.html" title="GooCanvasItem"><span class="type">GooCanvasItem</span></a>.</p></td>
2506 <td class="parameter_annotations"> </td>
2507 </tr>
2508 <tr>
2509 <td class="parameter_name"><p>...</p></td>
2510 <td class="parameter_description"><p>pairs of property names and value pointers, and a terminating <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</p></td>
2511 <td class="parameter_annotations"> </td>
2512 </tr>
2513 </tbody>
2514 </table></div>
2515 </div>
2516 </div>
2517 <hr>
2518 <div class="refsect2">
2519 <a name="goo-canvas-item-get-child-properties-valist"></a><h3>goo_canvas_item_get_child_properties_valist ()</h3>
2520 <pre class="programlisting"><span class="returnvalue">void</span>
2521 goo_canvas_item_get_child_properties_valist
2522 (<em class="parameter"><code><a class="link" href="GooCanvasItem.html" title="GooCanvasItem"><span class="type">GooCanvasItem</span></a> *item</code></em>,
2523 <em class="parameter"><code><a class="link" href="GooCanvasItem.html" title="GooCanvasItem"><span class="type">GooCanvasItem</span></a> *child</code></em>,
2524 <em class="parameter"><code><span class="type">va_list</span> var_args</code></em>);</pre>
2525 <p>Gets the values of one or more child properties of <em class="parameter"><code>child</code></em>
2526 .</p>
2527 <div class="refsect3">
2528 <a name="goo-canvas-item-get-child-properties-valist.parameters"></a><h4>Parameters</h4>
2529 <div class="informaltable"><table width="100%" border="0">
2530 <colgroup>
2531 <col width="150px" class="parameters_name">
2532 <col class="parameters_description">
2533 <col width="200px" class="parameters_annotations">
2534 </colgroup>
2535 <tbody>
2536 <tr>
2537 <td class="parameter_name"><p>item</p></td>
2538 <td class="parameter_description"><p>a <a class="link" href="GooCanvasItem.html" title="GooCanvasItem"><span class="type">GooCanvasItem</span></a>.</p></td>
2539 <td class="parameter_annotations"> </td>
2540 </tr>
2541 <tr>
2542 <td class="parameter_name"><p>child</p></td>
2543 <td class="parameter_description"><p>a child <a class="link" href="GooCanvasItem.html" title="GooCanvasItem"><span class="type">GooCanvasItem</span></a>.</p></td>
2544 <td class="parameter_annotations"> </td>
2545 </tr>
2546 <tr>
2547 <td class="parameter_name"><p>var_args</p></td>
2548 <td class="parameter_description"><p>pairs of property names and value pointers, and a terminating
2549 <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</p></td>
2550 <td class="parameter_annotations"> </td>
2551 </tr>
2552 </tbody>
2553 </table></div>
2554 </div>
2555 </div>
2556 <hr>
2557 <div class="refsect2">
2558 <a name="goo-canvas-item-set-child-properties"></a><h3>goo_canvas_item_set_child_properties ()</h3>
2559 <pre class="programlisting"><span class="returnvalue">void</span>
2560 goo_canvas_item_set_child_properties (<em class="parameter"><code><a class="link" href="GooCanvasItem.html" title="GooCanvasItem"><span class="type">GooCanvasItem</span></a> *item</code></em>,
2561 <em class="parameter"><code><a class="link" href="GooCanvasItem.html" title="GooCanvasItem"><span class="type">GooCanvasItem</span></a> *child</code></em>,
2562 <em class="parameter"><code>...</code></em>);</pre>
2563 <p>Sets the values of one or more child properties of <em class="parameter"><code>child</code></em>
2564 .</p>
2565 <div class="refsect3">
2566 <a name="goo-canvas-item-set-child-properties.parameters"></a><h4>Parameters</h4>
2567 <div class="informaltable"><table width="100%" border="0">
2568 <colgroup>
2569 <col width="150px" class="parameters_name">
2570 <col class="parameters_description">
2571 <col width="200px" class="parameters_annotations">
2572 </colgroup>
2573 <tbody>
2574 <tr>
2575 <td class="parameter_name"><p>item</p></td>
2576 <td class="parameter_description"><p>a <a class="link" href="GooCanvasItem.html" title="GooCanvasItem"><span class="type">GooCanvasItem</span></a>.</p></td>
2577 <td class="parameter_annotations"> </td>
2578 </tr>
2579 <tr>
2580 <td class="parameter_name"><p>child</p></td>
2581 <td class="parameter_description"><p>a child <a class="link" href="GooCanvasItem.html" title="GooCanvasItem"><span class="type">GooCanvasItem</span></a>.</p></td>
2582 <td class="parameter_annotations"> </td>
2583 </tr>
2584 <tr>
2585 <td class="parameter_name"><p>...</p></td>
2586 <td class="parameter_description"><p>pairs of property names and values, and a terminating <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</p></td>
2587 <td class="parameter_annotations"> </td>
2588 </tr>
2589 </tbody>
2590 </table></div>
2591 </div>
2592 </div>
2593 <hr>
2594 <div class="refsect2">
2595 <a name="goo-canvas-item-set-child-properties-valist"></a><h3>goo_canvas_item_set_child_properties_valist ()</h3>
2596 <pre class="programlisting"><span class="returnvalue">void</span>
2597 goo_canvas_item_set_child_properties_valist
2598 (<em class="parameter"><code><a class="link" href="GooCanvasItem.html" title="GooCanvasItem"><span class="type">GooCanvasItem</span></a> *item</code></em>,
2599 <em class="parameter"><code><a class="link" href="GooCanvasItem.html" title="GooCanvasItem"><span class="type">GooCanvasItem</span></a> *child</code></em>,
2600 <em class="parameter"><code><span class="type">va_list</span> var_args</code></em>);</pre>
2601 <p>Sets the values of one or more child properties of <em class="parameter"><code>child</code></em>
2602 .</p>
2603 <div class="refsect3">
2604 <a name="goo-canvas-item-set-child-properties-valist.parameters"></a><h4>Parameters</h4>
2605 <div class="informaltable"><table width="100%" border="0">
2606 <colgroup>
2607 <col width="150px" class="parameters_name">
2608 <col class="parameters_description">
2609 <col width="200px" class="parameters_annotations">
2610 </colgroup>
2611 <tbody>
2612 <tr>
2613 <td class="parameter_name"><p>item</p></td>
2614 <td class="parameter_description"><p>a <a class="link" href="GooCanvasItem.html" title="GooCanvasItem"><span class="type">GooCanvasItem</span></a>.</p></td>
2615 <td class="parameter_annotations"> </td>
2616 </tr>
2617 <tr>
2618 <td class="parameter_name"><p>child</p></td>
2619 <td class="parameter_description"><p>a child <a class="link" href="GooCanvasItem.html" title="GooCanvasItem"><span class="type">GooCanvasItem</span></a>.</p></td>
2620 <td class="parameter_annotations"> </td>
2621 </tr>
2622 <tr>
2623 <td class="parameter_name"><p>var_args</p></td>
2624 <td class="parameter_description"><p>pairs of property names and values, and a terminating <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</p></td>
2625 <td class="parameter_annotations"> </td>
2626 </tr>
2627 </tbody>
2628 </table></div>
2629 </div>
2630 </div>
2631 </div>
2632 <div class="refsect1">
2633 <a name="GooCanvasItem.other_details"></a><h2>Types and Values</h2>
2634 <div class="refsect2">
2635 <a name="GooCanvasItem-struct"></a><h3>GooCanvasItem</h3>
2636 <pre class="programlisting">typedef struct _GooCanvasItem GooCanvasItem;</pre>
2637 <p><a class="link" href="GooCanvasItem.html" title="GooCanvasItem"><span class="type">GooCanvasItem</span></a> is a typedef used for objects that implement the
2638 <a class="link" href="GooCanvasItem.html" title="GooCanvasItem"><span class="type">GooCanvasItem</span></a> interface.</p>
2639 <p>(There is no actual <a class="link" href="GooCanvasItem.html" title="GooCanvasItem"><span class="type">GooCanvasItem</span></a> struct, since it is only an interface.
2640 But using '<a class="link" href="GooCanvasItem.html" title="GooCanvasItem"><span class="type">GooCanvasItem</span></a>' is more helpful than using '<a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject-struct"><span class="type">GObject</span></a>'.)</p>
2641 </div>
2642 <hr>
2643 <div class="refsect2">
2644 <a name="GooCanvasItemIface"></a><h3>struct GooCanvasItemIface</h3>
2645 <pre class="programlisting">struct GooCanvasItemIface {
2646 /* Virtual methods that group items must implement. */
2647 GooCanvas* (* get_canvas) (GooCanvasItem *item);
2648 void (* set_canvas) (GooCanvasItem *item,
2649 GooCanvas *canvas);
2650 gint (* get_n_children) (GooCanvasItem *item);
2651 GooCanvasItem* (* get_child) (GooCanvasItem *item,
2652 gint child_num);
2653 void (* request_update) (GooCanvasItem *item);
2654
2655 /* Virtual methods that group items may implement. */
2656 void (* add_child) (GooCanvasItem *item,
2657 GooCanvasItem *child,
2658 gint position);
2659 void (* move_child) (GooCanvasItem *item,
2660 gint old_position,
2661 gint new_position);
2662 void (* remove_child) (GooCanvasItem *item,
2663 gint child_num);
2664 void (* get_child_property) (GooCanvasItem *item,
2665 GooCanvasItem *child,
2666 guint property_id,
2667 GValue *value,
2668 GParamSpec *pspec);
2669 void (* set_child_property) (GooCanvasItem *item,
2670 GooCanvasItem *child,
2671 guint property_id,
2672 const GValue *value,
2673 GParamSpec *pspec);
2674 gboolean (* get_transform_for_child) (GooCanvasItem *item,
2675 GooCanvasItem *child,
2676 cairo_matrix_t *transform);
2677
2678 /* Virtual methods that all canvas items must implement. */
2679 GooCanvasItem* (* get_parent) (GooCanvasItem *item);
2680 void (* set_parent) (GooCanvasItem *item,
2681 GooCanvasItem *parent);
2682 void (* get_bounds) (GooCanvasItem *item,
2683 GooCanvasBounds *bounds);
2684 GList* (* get_items_at) (GooCanvasItem *item,
2685 gdouble x,
2686 gdouble y,
2687 cairo_t *cr,
2688 gboolean is_pointer_event,
2689 gboolean parent_is_visible,
2690 GList *found_items);
2691 void (* update) (GooCanvasItem *item,
2692 gboolean entire_tree,
2693 cairo_t *cr,
2694 GooCanvasBounds *bounds);
2695 void (* paint) (GooCanvasItem *item,
2696 cairo_t *cr,
2697 const GooCanvasBounds *bounds,
2698 gdouble scale);
2699
2700 gboolean (* get_requested_area) (GooCanvasItem *item,
2701 cairo_t *cr,
2702 GooCanvasBounds *requested_area);
2703 void (* allocate_area) (GooCanvasItem *item,
2704 cairo_t *cr,
2705 const GooCanvasBounds *requested_area,
2706 const GooCanvasBounds *allocated_area,
2707 gdouble x_offset,
2708 gdouble y_offset);
2709
2710 /* Virtual methods that canvas items may implement. */
2711 gboolean (* get_transform) (GooCanvasItem *item,
2712 cairo_matrix_t *transform);
2713 void (* set_transform) (GooCanvasItem *item,
2714 const cairo_matrix_t *transform);
2715 GooCanvasStyle* (* get_style) (GooCanvasItem *item);
2716 void (* set_style) (GooCanvasItem *item,
2717 GooCanvasStyle *style);
2718 gboolean (* is_visible) (GooCanvasItem *item);
2719 gdouble (* get_requested_height) (GooCanvasItem *item,
2720 cairo_t *cr,
2721 gdouble width);
2722
2723 /* Virtual methods that model/view items must implement. */
2724 GooCanvasItemModel* (* get_model) (GooCanvasItem *item);
2725 void (* set_model) (GooCanvasItem *item,
2726 GooCanvasItemModel *model);
2727
2728
2729 /* Signals. */
2730 gboolean (* enter_notify_event) (GooCanvasItem *item,
2731 GooCanvasItem *target,
2732 GdkEventCrossing *event);
2733 gboolean (* leave_notify_event) (GooCanvasItem *item,
2734 GooCanvasItem *target,
2735 GdkEventCrossing *event);
2736 gboolean (* motion_notify_event) (GooCanvasItem *item,
2737 GooCanvasItem *target,
2738 GdkEventMotion *event);
2739 gboolean (* button_press_event) (GooCanvasItem *item,
2740 GooCanvasItem *target,
2741 GdkEventButton *event);
2742 gboolean (* button_release_event) (GooCanvasItem *item,
2743 GooCanvasItem *target,
2744 GdkEventButton *event);
2745 gboolean (* focus_in_event) (GooCanvasItem *item,
2746 GooCanvasItem *target,
2747 GdkEventFocus *event);
2748 gboolean (* focus_out_event) (GooCanvasItem *item,
2749 GooCanvasItem *target,
2750 GdkEventFocus *event);
2751 gboolean (* key_press_event) (GooCanvasItem *item,
2752 GooCanvasItem *target,
2753 GdkEventKey *event);
2754 gboolean (* key_release_event) (GooCanvasItem *item,
2755 GooCanvasItem *target,
2756 GdkEventKey *event);
2757 gboolean (* grab_broken_event) (GooCanvasItem *item,
2758 GooCanvasItem *target,
2759 GdkEventGrabBroken *event);
2760 void (* child_notify) (GooCanvasItem *item,
2761 GParamSpec *pspec);
2762 gboolean (* query_tooltip) (GooCanvasItem *item,
2763 gdouble x,
2764 gdouble y,
2765 gboolean keyboard_tooltip,
2766 GtkTooltip *tooltip);
2767
2768 gboolean (* get_is_static) (GooCanvasItem *item);
2769 void (* set_is_static) (GooCanvasItem *item,
2770 gboolean is_static);
2771
2772 void (* animation_finished) (GooCanvasItem *item,
2773 gboolean stopped);
2774
2775 gboolean (* scroll_event) (GooCanvasItem *item,
2776 GooCanvasItem *target,
2777 GdkEventScroll *event);
2778
2779 gboolean (* get_requested_area_for_width)(GooCanvasItem *item,
2780 cairo_t *cr,
2781 gdouble width,
2782 GooCanvasBounds *requested_area);
2783 };
2784 </pre>
2785 <p><span class="type">GooCanvasItemIFace</span> holds the virtual methods that make up the
2786 <a class="link" href="GooCanvasItem.html" title="GooCanvasItem"><span class="type">GooCanvasItem</span></a> interface.</p>
2787 <p>Simple canvas items only need to implement the <code class="function">get_parent()</code>, <code class="function">set_parent()</code>,
2788 <code class="function">get_bounds()</code>, <code class="function">get_items_at()</code>, <code class="function">update()</code> and <code class="function">paint()</code> methods (and also
2789 <code class="function">get_requested_area()</code> and <code class="function">allocate_area()</code> if they are going to be used
2790 inside a layout container like <a class="link" href="GooCanvasTable.html" title="GooCanvasTable"><span class="type">GooCanvasTable</span></a>).</p>
2791 <p>Items that support transforms should also implement <code class="function">get_transform()</code> and
2792 <code class="function">set_transform()</code>. Items that support styles should implement <code class="function">get_style()</code>
2793 and <code class="function">set_style()</code>.</p>
2794 <p>Container items must implement <code class="function">get_canvas()</code>, <code class="function">set_canvas()</code>,
2795 <code class="function">get_n_children()</code>, <code class="function">get_child()</code> and <code class="function">request_update()</code>. Containers that support
2796 dynamic changes to their children should implement <code class="function">add_child()</code>,
2797 <code class="function">move_child()</code> and <code class="function">remove_child()</code>. Layout containers like <a class="link" href="GooCanvasTable.html" title="GooCanvasTable"><span class="type">GooCanvasTable</span></a>
2798 may implement <code class="function">get_child_property()</code>, <code class="function">set_child_property()</code> and
2799 <code class="function">get_transform_for_child()</code>.</p>
2800 <div class="refsect3">
2801 <a name="GooCanvasItemIface.members"></a><h4>Members</h4>
2802 <div class="informaltable"><table width="100%" border="0">
2803 <colgroup>
2804 <col width="300px" class="struct_members_name">
2805 <col class="struct_members_description">
2806 <col width="200px" class="struct_members_annotations">
2807 </colgroup>
2808 <tbody>
2809 <tr>
2810 <td class="struct_member_name"><p><em class="structfield"><code><a name="GooCanvasItemIface.get-canvas"></a>get_canvas</code></em> ()</p></td>
2811 <td class="struct_member_description"><p>returns the canvas the item is in.</p></td>
2812 <td class="struct_member_annotations"> </td>
2813 </tr>
2814 <tr>
2815 <td class="struct_member_name"><p><em class="structfield"><code><a name="GooCanvasItemIface.set-canvas"></a>set_canvas</code></em> ()</p></td>
2816 <td class="struct_member_description"><p>sets the canvas the item is in.</p></td>
2817 <td class="struct_member_annotations"> </td>
2818 </tr>
2819 <tr>
2820 <td class="struct_member_name"><p><em class="structfield"><code><a name="GooCanvasItemIface.get-n-children"></a>get_n_children</code></em> ()</p></td>
2821 <td class="struct_member_description"><p>returns the number of children of the item.</p></td>
2822 <td class="struct_member_annotations"> </td>
2823 </tr>
2824 <tr>
2825 <td class="struct_member_name"><p><em class="structfield"><code><a name="GooCanvasItemIface.get-child"></a>get_child</code></em> ()</p></td>
2826 <td class="struct_member_description"><p>returns the child at the given index.</p></td>
2827 <td class="struct_member_annotations"> </td>
2828 </tr>
2829 <tr>
2830 <td class="struct_member_name"><p><em class="structfield"><code><a name="GooCanvasItemIface.request-update"></a>request_update</code></em> ()</p></td>
2831 <td class="struct_member_description"><p>requests that an update is scheduled.</p></td>
2832 <td class="struct_member_annotations"> </td>
2833 </tr>
2834 <tr>
2835 <td class="struct_member_name"><p><em class="structfield"><code><a name="GooCanvasItemIface.add-child"></a>add_child</code></em> ()</p></td>
2836 <td class="struct_member_description"><p>adds a child.</p></td>
2837 <td class="struct_member_annotations"> </td>
2838 </tr>
2839 <tr>
2840 <td class="struct_member_name"><p><em class="structfield"><code><a name="GooCanvasItemIface.move-child"></a>move_child</code></em> ()</p></td>
2841 <td class="struct_member_description"><p>moves a child up or down the stacking order.</p></td>
2842 <td class="struct_member_annotations"> </td>
2843 </tr>
2844 <tr>
2845 <td class="struct_member_name"><p><em class="structfield"><code><a name="GooCanvasItemIface.remove-child"></a>remove_child</code></em> ()</p></td>
2846 <td class="struct_member_description"><p>removes a child.</p></td>
2847 <td class="struct_member_annotations"> </td>
2848 </tr>
2849 <tr>
2850 <td class="struct_member_name"><p><em class="structfield"><code><a name="GooCanvasItemIface.get-child-property"></a>get_child_property</code></em> ()</p></td>
2851 <td class="struct_member_description"><p>gets a child property of a given child item,
2852 e.g. the "row" or "column" property of an item in a <a class="link" href="GooCanvasTable.html" title="GooCanvasTable"><span class="type">GooCanvasTable</span></a>.</p></td>
2853 <td class="struct_member_annotations"> </td>
2854 </tr>
2855 <tr>
2856 <td class="struct_member_name"><p><em class="structfield"><code><a name="GooCanvasItemIface.set-child-property"></a>set_child_property</code></em> ()</p></td>
2857 <td class="struct_member_description"><p>sets a child property for a given child item.</p></td>
2858 <td class="struct_member_annotations"> </td>
2859 </tr>
2860 <tr>
2861 <td class="struct_member_name"><p><em class="structfield"><code><a name="GooCanvasItemIface.get-transform-for-child"></a>get_transform_for_child</code></em> ()</p></td>
2862 <td class="struct_member_description"><p>gets the transform used to lay out a given child.</p></td>
2863 <td class="struct_member_annotations"> </td>
2864 </tr>
2865 <tr>
2866 <td class="struct_member_name"><p><em class="structfield"><code><a name="GooCanvasItemIface.get-parent"></a>get_parent</code></em> ()</p></td>
2867 <td class="struct_member_description"><p>gets the item's parent.</p></td>
2868 <td class="struct_member_annotations"> </td>
2869 </tr>
2870 <tr>
2871 <td class="struct_member_name"><p><em class="structfield"><code><a name="GooCanvasItemIface.set-parent"></a>set_parent</code></em> ()</p></td>
2872 <td class="struct_member_description"><p>sets the item's parent.</p></td>
2873 <td class="struct_member_annotations"> </td>
2874 </tr>
2875 <tr>
2876 <td class="struct_member_name"><p><em class="structfield"><code><a name="GooCanvasItemIface.get-bounds"></a>get_bounds</code></em> ()</p></td>
2877 <td class="struct_member_description"><p>gets the bounds of the item.</p></td>
2878 <td class="struct_member_annotations"> </td>
2879 </tr>
2880 <tr>
2881 <td class="struct_member_name"><p><em class="structfield"><code><a name="GooCanvasItemIface.get-items-at"></a>get_items_at</code></em> ()</p></td>
2882 <td class="struct_member_description"><p>gets all the items at the given point.</p></td>
2883 <td class="struct_member_annotations"> </td>
2884 </tr>
2885 <tr>
2886 <td class="struct_member_name"><p><em class="structfield"><code><a name="GooCanvasItemIface.update"></a>update</code></em> ()</p></td>
2887 <td class="struct_member_description"><p>updates the item, if needed. It recalculates the bounds of the item
2888 and requests redraws of parts of the canvas if necessary.</p></td>
2889 <td class="struct_member_annotations"> </td>
2890 </tr>
2891 <tr>
2892 <td class="struct_member_name"><p><em class="structfield"><code><a name="GooCanvasItemIface.paint"></a>paint</code></em> ()</p></td>
2893 <td class="struct_member_description"><p>renders the item to the given cairo context.</p></td>
2894 <td class="struct_member_annotations"> </td>
2895 </tr>
2896 <tr>
2897 <td class="struct_member_name"><p><em class="structfield"><code><a name="GooCanvasItemIface.get-requested-area"></a>get_requested_area</code></em> ()</p></td>
2898 <td class="struct_member_description"><p>returns the requested area of the item, in its parent's
2899 coordinate space. This is only used for items in layout containers such as
2900 <a class="link" href="GooCanvasTable.html" title="GooCanvasTable"><span class="type">GooCanvasTable</span></a>.</p></td>
2901 <td class="struct_member_annotations"> </td>
2902 </tr>
2903 <tr>
2904 <td class="struct_member_name"><p><em class="structfield"><code><a name="GooCanvasItemIface.allocate-area"></a>allocate_area</code></em> ()</p></td>
2905 <td class="struct_member_description"><p>allocates the item's area, in its parent's coordinate space.
2906 The item must recalculate its bounds and request redraws of parts of the
2907 canvas if necessary. This is only used for items in layout containers such
2908 as <a class="link" href="GooCanvasTable.html" title="GooCanvasTable"><span class="type">GooCanvasTable</span></a>.</p></td>
2909 <td class="struct_member_annotations"> </td>
2910 </tr>
2911 <tr>
2912 <td class="struct_member_name"><p><em class="structfield"><code><a name="GooCanvasItemIface.get-transform"></a>get_transform</code></em> ()</p></td>
2913 <td class="struct_member_description"><p>gets the item's transformation matrix.</p></td>
2914 <td class="struct_member_annotations"> </td>
2915 </tr>
2916 <tr>
2917 <td class="struct_member_name"><p><em class="structfield"><code><a name="GooCanvasItemIface.set-transform"></a>set_transform</code></em> ()</p></td>
2918 <td class="struct_member_description"><p>sets the item's transformation matrix.</p></td>
2919 <td class="struct_member_annotations"> </td>
2920 </tr>
2921 <tr>
2922 <td class="struct_member_name"><p><em class="structfield"><code><a name="GooCanvasItemIface.get-style"></a>get_style</code></em> ()</p></td>
2923 <td class="struct_member_description"><p>gets the item's style.</p></td>
2924 <td class="struct_member_annotations"> </td>
2925 </tr>
2926 <tr>
2927 <td class="struct_member_name"><p><em class="structfield"><code><a name="GooCanvasItemIface.set-style"></a>set_style</code></em> ()</p></td>
2928 <td class="struct_member_description"><p>sets the item's style.</p></td>
2929 <td class="struct_member_annotations"> </td>
2930 </tr>
2931 <tr>
2932 <td class="struct_member_name"><p><em class="structfield"><code><a name="GooCanvasItemIface.is-visible"></a>is_visible</code></em> ()</p></td>
2933 <td class="struct_member_description"><p>returns <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the item is currently visible.</p></td>
2934 <td class="struct_member_annotations"> </td>
2935 </tr>
2936 <tr>
2937 <td class="struct_member_name"><p><em class="structfield"><code><a name="GooCanvasItemIface.get-requested-height"></a>get_requested_height</code></em> ()</p></td>
2938 <td class="struct_member_description"><p>returns the requested height of the item,
2939 given a particular allocated width, using the parent's coordinate space.
2940 Note that this method should only be used if the position of the item
2941 remains unchanged. If the position might change use
2942 <code class="function">get_requested_area_for_width()</code> instead.</p></td>
2943 <td class="struct_member_annotations"> </td>
2944 </tr>
2945 <tr>
2946 <td class="struct_member_name"><p><em class="structfield"><code><a name="GooCanvasItemIface.get-model"></a>get_model</code></em> ()</p></td>
2947 <td class="struct_member_description"><p>gets the model that the canvas item is viewing.</p></td>
2948 <td class="struct_member_annotations"> </td>
2949 </tr>
2950 <tr>
2951 <td class="struct_member_name"><p><em class="structfield"><code><a name="GooCanvasItemIface.set-model"></a>set_model</code></em> ()</p></td>
2952 <td class="struct_member_description"><p>sets the model that the canvas item will view.</p></td>
2953 <td class="struct_member_annotations"> </td>
2954 </tr>
2955 <tr>
2956 <td class="struct_member_name"><p><em class="structfield"><code><a name="GooCanvasItemIface.enter-notify-event"></a>enter_notify_event</code></em> ()</p></td>
2957 <td class="struct_member_description"><p>signal emitted when the mouse enters the item.</p></td>
2958 <td class="struct_member_annotations"> </td>
2959 </tr>
2960 <tr>
2961 <td class="struct_member_name"><p><em class="structfield"><code><a name="GooCanvasItemIface.leave-notify-event"></a>leave_notify_event</code></em> ()</p></td>
2962 <td class="struct_member_description"><p>signal emitted when the mouse leaves the item.</p></td>
2963 <td class="struct_member_annotations"> </td>
2964 </tr>
2965 <tr>
2966 <td class="struct_member_name"><p><em class="structfield"><code><a name="GooCanvasItemIface.motion-notify-event"></a>motion_notify_event</code></em> ()</p></td>
2967 <td class="struct_member_description"><p>signal emitted when the mouse moves within the item.</p></td>
2968 <td class="struct_member_annotations"> </td>
2969 </tr>
2970 <tr>
2971 <td class="struct_member_name"><p><em class="structfield"><code><a name="GooCanvasItemIface.button-press-event"></a>button_press_event</code></em> ()</p></td>
2972 <td class="struct_member_description"><p>signal emitted when a mouse button is pressed within
2973 the item.</p></td>
2974 <td class="struct_member_annotations"> </td>
2975 </tr>
2976 <tr>
2977 <td class="struct_member_name"><p><em class="structfield"><code><a name="GooCanvasItemIface.button-release-event"></a>button_release_event</code></em> ()</p></td>
2978 <td class="struct_member_description"><p>signal emitted when a mouse button is released.</p></td>
2979 <td class="struct_member_annotations"> </td>
2980 </tr>
2981 <tr>
2982 <td class="struct_member_name"><p><em class="structfield"><code><a name="GooCanvasItemIface.focus-in-event"></a>focus_in_event</code></em> ()</p></td>
2983 <td class="struct_member_description"><p>signal emitted when the item receices the keyboard focus.</p></td>
2984 <td class="struct_member_annotations"> </td>
2985 </tr>
2986 <tr>
2987 <td class="struct_member_name"><p><em class="structfield"><code><a name="GooCanvasItemIface.focus-out-event"></a>focus_out_event</code></em> ()</p></td>
2988 <td class="struct_member_description"><p>signal emitted when the item loses the keyboard focus.</p></td>
2989 <td class="struct_member_annotations"> </td>
2990 </tr>
2991 <tr>
2992 <td class="struct_member_name"><p><em class="structfield"><code><a name="GooCanvasItemIface.key-press-event"></a>key_press_event</code></em> ()</p></td>
2993 <td class="struct_member_description"><p>signal emitted when a key is pressed.</p></td>
2994 <td class="struct_member_annotations"> </td>
2995 </tr>
2996 <tr>
2997 <td class="struct_member_name"><p><em class="structfield"><code><a name="GooCanvasItemIface.key-release-event"></a>key_release_event</code></em> ()</p></td>
2998 <td class="struct_member_description"><p>signal emitted when a key is released.</p></td>
2999 <td class="struct_member_annotations"> </td>
3000 </tr>
3001 <tr>
3002 <td class="struct_member_name"><p><em class="structfield"><code><a name="GooCanvasItemIface.grab-broken-event"></a>grab_broken_event</code></em> ()</p></td>
3003 <td class="struct_member_description"><p>signal emitted when a grab that the item has is lost.</p></td>
3004 <td class="struct_member_annotations"> </td>
3005 </tr>
3006 <tr>
3007 <td class="struct_member_name"><p><em class="structfield"><code><a name="GooCanvasItemIface.child-notify"></a>child_notify</code></em> ()</p></td>
3008 <td class="struct_member_description"><p>signal emitted when a child property is changed.</p></td>
3009 <td class="struct_member_annotations"> </td>
3010 </tr>
3011 <tr>
3012 <td class="struct_member_name"><p><em class="structfield"><code><a name="GooCanvasItemIface.query-tooltip"></a>query_tooltip</code></em> ()</p></td>
3013 <td class="struct_member_description"><p>signal emitted to query the tooltip of an item.</p></td>
3014 <td class="struct_member_annotations"> </td>
3015 </tr>
3016 <tr>
3017 <td class="struct_member_name"><p><em class="structfield"><code><a name="GooCanvasItemIface.get-is-static"></a>get_is_static</code></em> ()</p></td>
3018 <td class="struct_member_description"><p>returns <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the item is static.</p></td>
3019 <td class="struct_member_annotations"> </td>
3020 </tr>
3021 <tr>
3022 <td class="struct_member_name"><p><em class="structfield"><code><a name="GooCanvasItemIface.set-is-static"></a>set_is_static</code></em> ()</p></td>
3023 <td class="struct_member_description"><p>notifies the item whether it is static or not.</p></td>
3024 <td class="struct_member_annotations"> </td>
3025 </tr>
3026 <tr>
3027 <td class="struct_member_name"><p><em class="structfield"><code><a name="GooCanvasItemIface.animation-finished"></a>animation_finished</code></em> ()</p></td>
3028 <td class="struct_member_description"><p>signal emitted when the item's animation has finished.</p></td>
3029 <td class="struct_member_annotations"> </td>
3030 </tr>
3031 <tr>
3032 <td class="struct_member_name"><p><em class="structfield"><code><a name="GooCanvasItemIface.scroll-event"></a>scroll_event</code></em> ()</p></td>
3033 <td class="struct_member_description"><p>signal emitted when the mouse wheel is activated within
3034 the item.</p></td>
3035 <td class="struct_member_annotations"> </td>
3036 </tr>
3037 <tr>
3038 <td class="struct_member_name"><p><em class="structfield"><code><a name="GooCanvasItemIface.get-requested-area-for-width"></a>get_requested_area_for_width</code></em> ()</p></td>
3039 <td class="struct_member_description"><p>returns the requested bounds of the item,
3040 given a particular allocated width, using the parent's coordinate space.</p></td>
3041 <td class="struct_member_annotations"> </td>
3042 </tr>
3043 </tbody>
3044 </table></div>
3045 </div>
3046 </div>
3047 </div>
3048 <div class="refsect1">
3049 <a name="GooCanvasItem.property-details"></a><h2>Property Details</h2>
3050 <div class="refsect2">
3051 <a name="GooCanvasItem--can-focus"></a><h3>The <code class="literal">“can-focus”</code> property</h3>
3052 <pre class="programlisting"> “can-focus” <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a></pre>
3053 <p>If the item can take the keyboard focus.</p>
3054 <p>Flags: Read / Write</p>
3055 <p>Default value: FALSE</p>
3056 </div>
3057 <hr>
3058 <div class="refsect2">
3059 <a name="GooCanvasItem--description"></a><h3>The <code class="literal">“description”</code> property</h3>
3060 <pre class="programlisting"> “description” <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</pre>
3061 <p>A description of the item for use by assistive technologies.</p>
3062 <p>Flags: Read / Write</p>
3063 <p>Default value: NULL</p>
3064 </div>
3065 <hr>
3066 <div class="refsect2">
3067 <a name="GooCanvasItem--parent"></a><h3>The <code class="literal">“parent”</code> property</h3>
3068 <pre class="programlisting"> “parent” <a class="link" href="GooCanvasItem.html" title="GooCanvasItem"><span class="type">GooCanvasItem</span></a> *</pre>
3069 <p>The parent item.</p>
3070 <p>Flags: Read / Write</p>
3071 </div>
3072 <hr>
3073 <div class="refsect2">
3074 <a name="GooCanvasItem--pointer-events"></a><h3>The <code class="literal">“pointer-events”</code> property</h3>
3075 <pre class="programlisting"> “pointer-events” <a class="link" href="goocanvas2-GooCanvas-Types.html#GooCanvasPointerEvents" title="enum GooCanvasPointerEvents"><span class="type">GooCanvasPointerEvents</span></a></pre>
3076 <p>Specifies when the item receives pointer events.</p>
3077 <p>Flags: Read / Write</p>
3078 <p>Default value: GOO_CANVAS_EVENTS_VISIBLE_MASK | GOO_CANVAS_EVENTS_PAINTED_MASK | GOO_CANVAS_EVENTS_FILL_MASK | GOO_CANVAS_EVENTS_STROKE_MASK</p>
3079 </div>
3080 <hr>
3081 <div class="refsect2">
3082 <a name="GooCanvasItem--title"></a><h3>The <code class="literal">“title”</code> property</h3>
3083 <pre class="programlisting"> “title” <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</pre>
3084 <p>A short context-rich description of the item for use by assistive technologies.</p>
3085 <p>Flags: Read / Write</p>
3086 <p>Default value: NULL</p>
3087 </div>
3088 <hr>
3089 <div class="refsect2">
3090 <a name="GooCanvasItem--tooltip"></a><h3>The <code class="literal">“tooltip”</code> property</h3>
3091 <pre class="programlisting"> “tooltip” <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</pre>
3092 <p>The tooltip to display for the item, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to display no tooltip.</p>
3093 <p>Note that this property has no effect unless the
3094 <a href="/usr/share/gtk-doc/html/gtk3/GtkWidget.html#GtkWidget--has-tooltip"><span class="type">“has-tooltip”</span></a> property is set to <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> on the <a class="link" href="GooCanvas.html" title="GooCanvas"><span class="type">GooCanvas</span></a>
3095 containing this item.</p>
3096 <p>Flags: Read / Write</p>
3097 <p>Default value: NULL</p>
3098 </div>
3099 <hr>
3100 <div class="refsect2">
3101 <a name="GooCanvasItem--transform"></a><h3>The <code class="literal">“transform”</code> property</h3>
3102 <pre class="programlisting"> “transform” <a class="link" href="goocanvas2-GooCanvas-Types.html#GooCairoMatrix"><span class="type">GooCairoMatrix</span></a> *</pre>
3103 <p>The transformation matrix of the item.</p>
3104 <p>Flags: Read / Write</p>
3105 </div>
3106 <hr>
3107 <div class="refsect2">
3108 <a name="GooCanvasItem--visibility"></a><h3>The <code class="literal">“visibility”</code> property</h3>
3109 <pre class="programlisting"> “visibility” <a class="link" href="goocanvas2-GooCanvas-Types.html#GooCanvasItemVisibility" title="enum GooCanvasItemVisibility"><span class="type">GooCanvasItemVisibility</span></a></pre>
3110 <p>When the canvas item is visible.</p>
3111 <p>Flags: Read / Write</p>
3112 <p>Default value: GOO_CANVAS_ITEM_VISIBLE</p>
3113 </div>
3114 <hr>
3115 <div class="refsect2">
3116 <a name="GooCanvasItem--visibility-threshold"></a><h3>The <code class="literal">“visibility-threshold”</code> property</h3>
3117 <pre class="programlisting"> “visibility-threshold” <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a></pre>
3118 <p>The scale threshold at which the item becomes visible.</p>
3119 <p>Flags: Read / Write</p>
3120 <p>Allowed values: &gt;= 0</p>
3121 <p>Default value: 0</p>
3122 </div>
3123 </div>
3124 <div class="refsect1">
3125 <a name="GooCanvasItem.signal-details"></a><h2>Signal Details</h2>
3126 <div class="refsect2">
3127 <a name="GooCanvasItem-animation-finished"></a><h3>The <code class="literal">“animation-finished”</code> signal</h3>
3128 <pre class="programlisting"><span class="returnvalue">void</span>
3129 user_function (<a class="link" href="GooCanvasItem.html" title="GooCanvasItem"><span class="type">GooCanvasItem</span></a> *item,
3130 <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> stopped,
3131 <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data)</pre>
3132 <p>Emitted when the item animation has finished.</p>
3133 <div class="refsect3">
3134 <a name="GooCanvasItem-animation-finished.parameters"></a><h4>Parameters</h4>
3135 <div class="informaltable"><table width="100%" border="0">
3136 <colgroup>
3137 <col width="150px" class="parameters_name">
3138 <col class="parameters_description">
3139 <col width="200px" class="parameters_annotations">
3140 </colgroup>
3141 <tbody>
3142 <tr>
3143 <td class="parameter_name"><p>item</p></td>
3144 <td class="parameter_description"><p>the item that received the signal.</p></td>
3145 <td class="parameter_annotations"> </td>
3146 </tr>
3147 <tr>
3148 <td class="parameter_name"><p>stopped</p></td>
3149 <td class="parameter_description"><p>if the animation was explicitly stopped.</p></td>
3150 <td class="parameter_annotations"> </td>
3151 </tr>
3152 <tr>
3153 <td class="parameter_name"><p>user_data</p></td>
3154 <td class="parameter_description"><p>user data set when the signal handler was connected.</p></td>
3155 <td class="parameter_annotations"> </td>
3156 </tr>
3157 </tbody>
3158 </table></div>
3159 </div>
3160 <p>Flags: <a href="/usr/share/gtk-doc/html/gobject/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS">Run Last</a></p>
3161 </div>
3162 <hr>
3163 <div class="refsect2">
3164 <a name="GooCanvasItem-button-press-event"></a><h3>The <code class="literal">“button-press-event”</code> signal</h3>
3165 <pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
3166 user_function (<a class="link" href="GooCanvasItem.html" title="GooCanvasItem"><span class="type">GooCanvasItem</span></a> *item,
3167 <a class="link" href="GooCanvasItem.html" title="GooCanvasItem"><span class="type">GooCanvasItem</span></a> *target_item,
3168 <a href="/usr/share/gtk-doc/html/gdk3/gdk3-Event-Structures.html#GdkEvent"><span class="type">GdkEvent</span></a> *event,
3169 <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data)</pre>
3170 <p>Emitted when a mouse button is pressed in an item.</p>
3171 <div class="refsect3">
3172 <a name="GooCanvasItem-button-press-event.parameters"></a><h4>Parameters</h4>
3173 <div class="informaltable"><table width="100%" border="0">
3174 <colgroup>
3175 <col width="150px" class="parameters_name">
3176 <col class="parameters_description">
3177 <col width="200px" class="parameters_annotations">
3178 </colgroup>
3179 <tbody>
3180 <tr>
3181 <td class="parameter_name"><p>item</p></td>
3182 <td class="parameter_description"><p>the item that received the signal.</p></td>
3183 <td class="parameter_annotations"> </td>
3184 </tr>
3185 <tr>
3186 <td class="parameter_name"><p>target_item</p></td>
3187 <td class="parameter_description"><p>the target of the event.</p></td>
3188 <td class="parameter_annotations"> </td>
3189 </tr>
3190 <tr>
3191 <td class="parameter_name"><p>event</p></td>
3192 <td class="parameter_description"><p>the event data. The x &amp; y fields
3193 contain the mouse position in the item's coordinate space. The x_root
3194 &amp; y_root fields contain the same coordinates converted to the canvas
3195 coordinate space. </p></td>
3196 <td class="parameter_annotations"><span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> Gdk.EventButton]</span></td>
3197 </tr>
3198 <tr>
3199 <td class="parameter_name"><p>user_data</p></td>
3200 <td class="parameter_description"><p>user data set when the signal handler was connected.</p></td>
3201 <td class="parameter_annotations"> </td>
3202 </tr>
3203 </tbody>
3204 </table></div>
3205 </div>
3206 <div class="refsect3">
3207 <a name="GooCanvasItem-button-press-event.returns"></a><h4>Returns</h4>
3208 <p> <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> to stop the signal emission, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> to let it
3209 continue.</p>
3210 </div>
3211 <p>Flags: <a href="/usr/share/gtk-doc/html/gobject/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS">Run Last</a></p>
3212 </div>
3213 <hr>
3214 <div class="refsect2">
3215 <a name="GooCanvasItem-button-release-event"></a><h3>The <code class="literal">“button-release-event”</code> signal</h3>
3216 <pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
3217 user_function (<a class="link" href="GooCanvasItem.html" title="GooCanvasItem"><span class="type">GooCanvasItem</span></a> *item,
3218 <a class="link" href="GooCanvasItem.html" title="GooCanvasItem"><span class="type">GooCanvasItem</span></a> *target_item,
3219 <a href="/usr/share/gtk-doc/html/gdk3/gdk3-Event-Structures.html#GdkEvent"><span class="type">GdkEvent</span></a> *event,
3220 <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data)</pre>
3221 <p>Emitted when a mouse button is released in an item.</p>
3222 <div class="refsect3">
3223 <a name="GooCanvasItem-button-release-event.parameters"></a><h4>Parameters</h4>
3224 <div class="informaltable"><table width="100%" border="0">
3225 <colgroup>
3226 <col width="150px" class="parameters_name">
3227 <col class="parameters_description">
3228 <col width="200px" class="parameters_annotations">
3229 </colgroup>
3230 <tbody>
3231 <tr>
3232 <td class="parameter_name"><p>item</p></td>
3233 <td class="parameter_description"><p>the item that received the signal.</p></td>
3234 <td class="parameter_annotations"> </td>
3235 </tr>
3236 <tr>
3237 <td class="parameter_name"><p>target_item</p></td>
3238 <td class="parameter_description"><p>the target of the event.</p></td>
3239 <td class="parameter_annotations"> </td>
3240 </tr>
3241 <tr>
3242 <td class="parameter_name"><p>event</p></td>
3243 <td class="parameter_description"><p>the event data. The x &amp; y fields
3244 contain the mouse position in the item's coordinate space. The x_root
3245 &amp; y_root fields contain the same coordinates converted to the canvas
3246 coordinate space. </p></td>
3247 <td class="parameter_annotations"><span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> Gdk.EventButton]</span></td>
3248 </tr>
3249 <tr>
3250 <td class="parameter_name"><p>user_data</p></td>
3251 <td class="parameter_description"><p>user data set when the signal handler was connected.</p></td>
3252 <td class="parameter_annotations"> </td>
3253 </tr>
3254 </tbody>
3255 </table></div>
3256 </div>
3257 <div class="refsect3">
3258 <a name="GooCanvasItem-button-release-event.returns"></a><h4>Returns</h4>
3259 <p> <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> to stop the signal emission, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> to let it
3260 continue.</p>
3261 </div>
3262 <p>Flags: <a href="/usr/share/gtk-doc/html/gobject/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS">Run Last</a></p>
3263 </div>
3264 <hr>
3265 <div class="refsect2">
3266 <a name="GooCanvasItem-child-notify"></a><h3>The <code class="literal">“child-notify”</code> signal</h3>
3267 <pre class="programlisting"><span class="returnvalue">void</span>
3268 user_function (<a class="link" href="GooCanvasItem.html" title="GooCanvasItem"><span class="type">GooCanvasItem</span></a> *item,
3269 <a href="/usr/share/gtk-doc/html/gobject/gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> *pspec,
3270 <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data)</pre>
3271 <p>Emitted for each child property that has changed.
3272 The signal's detail holds the property name.</p>
3273 <div class="refsect3">
3274 <a name="GooCanvasItem-child-notify.parameters"></a><h4>Parameters</h4>
3275 <div class="informaltable"><table width="100%" border="0">
3276 <colgroup>
3277 <col width="150px" class="parameters_name">
3278 <col class="parameters_description">
3279 <col width="200px" class="parameters_annotations">
3280 </colgroup>
3281 <tbody>
3282 <tr>
3283 <td class="parameter_name"><p>item</p></td>
3284 <td class="parameter_description"><p>the item that received the signal.</p></td>
3285 <td class="parameter_annotations"> </td>
3286 </tr>
3287 <tr>
3288 <td class="parameter_name"><p>pspec</p></td>
3289 <td class="parameter_description"><p>the <a href="/usr/share/gtk-doc/html/gobject/gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> of the changed child property. </p></td>
3290 <td class="parameter_annotations"><span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> GObject.ParamSpec]</span></td>
3291 </tr>
3292 <tr>
3293 <td class="parameter_name"><p>user_data</p></td>
3294 <td class="parameter_description"><p>user data set when the signal handler was connected.</p></td>
3295 <td class="parameter_annotations"> </td>
3296 </tr>
3297 </tbody>
3298 </table></div>
3299 </div>
3300 <p>Flags: <a href="/usr/share/gtk-doc/html/gobject/gobject-Signals.html#G-SIGNAL-NO-HOOKS:CAPS">No Hooks</a></p>
3301 </div>
3302 <hr>
3303 <div class="refsect2">
3304 <a name="GooCanvasItem-enter-notify-event"></a><h3>The <code class="literal">“enter-notify-event”</code> signal</h3>
3305 <pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
3306 user_function (<a class="link" href="GooCanvasItem.html" title="GooCanvasItem"><span class="type">GooCanvasItem</span></a> *item,
3307 <a class="link" href="GooCanvasItem.html" title="GooCanvasItem"><span class="type">GooCanvasItem</span></a> *target_item,
3308 <a href="/usr/share/gtk-doc/html/gdk3/gdk3-Event-Structures.html#GdkEvent"><span class="type">GdkEvent</span></a> *event,
3309 <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data)</pre>
3310 <p>Emitted when the mouse enters an item.</p>
3311 <div class="refsect3">
3312 <a name="GooCanvasItem-enter-notify-event.parameters"></a><h4>Parameters</h4>
3313 <div class="informaltable"><table width="100%" border="0">
3314 <colgroup>
3315 <col width="150px" class="parameters_name">
3316 <col class="parameters_description">
3317 <col width="200px" class="parameters_annotations">
3318 </colgroup>
3319 <tbody>
3320 <tr>
3321 <td class="parameter_name"><p>item</p></td>
3322 <td class="parameter_description"><p>the item that received the signal.</p></td>
3323 <td class="parameter_annotations"> </td>
3324 </tr>
3325 <tr>
3326 <td class="parameter_name"><p>target_item</p></td>
3327 <td class="parameter_description"><p>the target of the event.</p></td>
3328 <td class="parameter_annotations"> </td>
3329 </tr>
3330 <tr>
3331 <td class="parameter_name"><p>event</p></td>
3332 <td class="parameter_description"><p>the event data. The x &amp; y fields
3333 contain the mouse position in the item's coordinate space. The x_root
3334 &amp; y_root fields contain the same coordinates converted to the canvas
3335 coordinate space. </p></td>
3336 <td class="parameter_annotations"><span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> Gdk.EventCrossing]</span></td>
3337 </tr>
3338 <tr>
3339 <td class="parameter_name"><p>user_data</p></td>
3340 <td class="parameter_description"><p>user data set when the signal handler was connected.</p></td>
3341 <td class="parameter_annotations"> </td>
3342 </tr>
3343 </tbody>
3344 </table></div>
3345 </div>
3346 <div class="refsect3">
3347 <a name="GooCanvasItem-enter-notify-event.returns"></a><h4>Returns</h4>
3348 <p> <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> to stop the signal emission, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> to let it
3349 continue.</p>
3350 </div>
3351 <p>Flags: <a href="/usr/share/gtk-doc/html/gobject/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS">Run Last</a></p>
3352 </div>
3353 <hr>
3354 <div class="refsect2">
3355 <a name="GooCanvasItem-focus-in-event"></a><h3>The <code class="literal">“focus-in-event”</code> signal</h3>
3356 <pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
3357 user_function (<a class="link" href="GooCanvasItem.html" title="GooCanvasItem"><span class="type">GooCanvasItem</span></a> *item,
3358 <a class="link" href="GooCanvasItem.html" title="GooCanvasItem"><span class="type">GooCanvasItem</span></a> *target_item,
3359 <a href="/usr/share/gtk-doc/html/gdk3/gdk3-Event-Structures.html#GdkEvent"><span class="type">GdkEvent</span></a> *event,
3360 <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data)</pre>
3361 <p>Emitted when the item receives the keyboard focus.</p>
3362 <div class="refsect3">
3363 <a name="GooCanvasItem-focus-in-event.parameters"></a><h4>Parameters</h4>
3364 <div class="informaltable"><table width="100%" border="0">
3365 <colgroup>
3366 <col width="150px" class="parameters_name">
3367 <col class="parameters_description">
3368 <col width="200px" class="parameters_annotations">
3369 </colgroup>
3370 <tbody>
3371 <tr>
3372 <td class="parameter_name"><p>item</p></td>
3373 <td class="parameter_description"><p>the item that received the signal.</p></td>
3374 <td class="parameter_annotations"> </td>
3375 </tr>
3376 <tr>
3377 <td class="parameter_name"><p>target_item</p></td>
3378 <td class="parameter_description"><p>the target of the event.</p></td>
3379 <td class="parameter_annotations"> </td>
3380 </tr>
3381 <tr>
3382 <td class="parameter_name"><p>event</p></td>
3383 <td class="parameter_description"><p>the event data. </p></td>
3384 <td class="parameter_annotations"><span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> Gdk.EventFocus]</span></td>
3385 </tr>
3386 <tr>
3387 <td class="parameter_name"><p>user_data</p></td>
3388 <td class="parameter_description"><p>user data set when the signal handler was connected.</p></td>
3389 <td class="parameter_annotations"> </td>
3390 </tr>
3391 </tbody>
3392 </table></div>
3393 </div>
3394 <div class="refsect3">
3395 <a name="GooCanvasItem-focus-in-event.returns"></a><h4>Returns</h4>
3396 <p> <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> to stop the signal emission, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> to let it
3397 continue.</p>
3398 </div>
3399 <p>Flags: <a href="/usr/share/gtk-doc/html/gobject/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS">Run Last</a></p>
3400 </div>
3401 <hr>
3402 <div class="refsect2">
3403 <a name="GooCanvasItem-focus-out-event"></a><h3>The <code class="literal">“focus-out-event”</code> signal</h3>
3404 <pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
3405 user_function (<a class="link" href="GooCanvasItem.html" title="GooCanvasItem"><span class="type">GooCanvasItem</span></a> *item,
3406 <a class="link" href="GooCanvasItem.html" title="GooCanvasItem"><span class="type">GooCanvasItem</span></a> *target_item,
3407 <a href="/usr/share/gtk-doc/html/gdk3/gdk3-Event-Structures.html#GdkEvent"><span class="type">GdkEvent</span></a> *event,
3408 <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data)</pre>
3409 <p>Emitted when the item loses the keyboard focus.</p>
3410 <div class="refsect3">
3411 <a name="GooCanvasItem-focus-out-event.parameters"></a><h4>Parameters</h4>
3412 <div class="informaltable"><table width="100%" border="0">
3413 <colgroup>
3414 <col width="150px" class="parameters_name">
3415 <col class="parameters_description">
3416 <col width="200px" class="parameters_annotations">
3417 </colgroup>
3418 <tbody>
3419 <tr>
3420 <td class="parameter_name"><p>item</p></td>
3421 <td class="parameter_description"><p>the item that received the signal.</p></td>
3422 <td class="parameter_annotations"> </td>
3423 </tr>
3424 <tr>
3425 <td class="parameter_name"><p>target_item</p></td>
3426 <td class="parameter_description"><p>the target of the event.</p></td>
3427 <td class="parameter_annotations"> </td>
3428 </tr>
3429 <tr>
3430 <td class="parameter_name"><p>event</p></td>
3431 <td class="parameter_description"><p>the event data. </p></td>
3432 <td class="parameter_annotations"><span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> Gdk.EventFocus]</span></td>
3433 </tr>
3434 <tr>
3435 <td class="parameter_name"><p>user_data</p></td>
3436 <td class="parameter_description"><p>user data set when the signal handler was connected.</p></td>
3437 <td class="parameter_annotations"> </td>
3438 </tr>
3439 </tbody>
3440 </table></div>
3441 </div>
3442 <div class="refsect3">
3443 <a name="GooCanvasItem-focus-out-event.returns"></a><h4>Returns</h4>
3444 <p> <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> to stop the signal emission, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> to let it
3445 continue.</p>
3446 </div>
3447 <p>Flags: <a href="/usr/share/gtk-doc/html/gobject/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS">Run Last</a></p>
3448 </div>
3449 <hr>
3450 <div class="refsect2">
3451 <a name="GooCanvasItem-grab-broken-event"></a><h3>The <code class="literal">“grab-broken-event”</code> signal</h3>
3452 <pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
3453 user_function (<a class="link" href="GooCanvasItem.html" title="GooCanvasItem"><span class="type">GooCanvasItem</span></a> *item,
3454 <a class="link" href="GooCanvasItem.html" title="GooCanvasItem"><span class="type">GooCanvasItem</span></a> *target_item,
3455 <a href="/usr/share/gtk-doc/html/gdk3/gdk3-Event-Structures.html#GdkEvent"><span class="type">GdkEvent</span></a> *event,
3456 <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data)</pre>
3457 <p>Emitted when the item's keyboard or pointer grab was lost
3458 unexpectedly.</p>
3459 <div class="refsect3">
3460 <a name="GooCanvasItem-grab-broken-event.parameters"></a><h4>Parameters</h4>
3461 <div class="informaltable"><table width="100%" border="0">
3462 <colgroup>
3463 <col width="150px" class="parameters_name">
3464 <col class="parameters_description">
3465 <col width="200px" class="parameters_annotations">
3466 </colgroup>
3467 <tbody>
3468 <tr>
3469 <td class="parameter_name"><p>item</p></td>
3470 <td class="parameter_description"><p>the item that received the signal.</p></td>
3471 <td class="parameter_annotations"> </td>
3472 </tr>
3473 <tr>
3474 <td class="parameter_name"><p>target_item</p></td>
3475 <td class="parameter_description"><p>the target of the event.</p></td>
3476 <td class="parameter_annotations"> </td>
3477 </tr>
3478 <tr>
3479 <td class="parameter_name"><p>event</p></td>
3480 <td class="parameter_description"><p>the event data. </p></td>
3481 <td class="parameter_annotations"><span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> Gdk.EventGrabBroken]</span></td>
3482 </tr>
3483 <tr>
3484 <td class="parameter_name"><p>user_data</p></td>
3485 <td class="parameter_description"><p>user data set when the signal handler was connected.</p></td>
3486 <td class="parameter_annotations"> </td>
3487 </tr>
3488 </tbody>
3489 </table></div>
3490 </div>
3491 <div class="refsect3">
3492 <a name="GooCanvasItem-grab-broken-event.returns"></a><h4>Returns</h4>
3493 <p> <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> to stop the signal emission, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> to let it
3494 continue.</p>
3495 </div>
3496 <p>Flags: <a href="/usr/share/gtk-doc/html/gobject/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS">Run Last</a></p>
3497 </div>
3498 <hr>
3499 <div class="refsect2">
3500 <a name="GooCanvasItem-key-press-event"></a><h3>The <code class="literal">“key-press-event”</code> signal</h3>
3501 <pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
3502 user_function (<a class="link" href="GooCanvasItem.html" title="GooCanvasItem"><span class="type">GooCanvasItem</span></a> *item,
3503 <a class="link" href="GooCanvasItem.html" title="GooCanvasItem"><span class="type">GooCanvasItem</span></a> *target_item,
3504 <a href="/usr/share/gtk-doc/html/gdk3/gdk3-Event-Structures.html#GdkEvent"><span class="type">GdkEvent</span></a> *event,
3505 <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data)</pre>
3506 <p>Emitted when a key is pressed and the item has the keyboard
3507 focus.</p>
3508 <div class="refsect3">
3509 <a name="GooCanvasItem-key-press-event.parameters"></a><h4>Parameters</h4>
3510 <div class="informaltable"><table width="100%" border="0">
3511 <colgroup>
3512 <col width="150px" class="parameters_name">
3513 <col class="parameters_description">
3514 <col width="200px" class="parameters_annotations">
3515 </colgroup>
3516 <tbody>
3517 <tr>
3518 <td class="parameter_name"><p>item</p></td>
3519 <td class="parameter_description"><p>the item that received the signal.</p></td>
3520 <td class="parameter_annotations"> </td>
3521 </tr>
3522 <tr>
3523 <td class="parameter_name"><p>target_item</p></td>
3524 <td class="parameter_description"><p>the target of the event.</p></td>
3525 <td class="parameter_annotations"> </td>
3526 </tr>
3527 <tr>
3528 <td class="parameter_name"><p>event</p></td>
3529 <td class="parameter_description"><p>the event data. </p></td>
3530 <td class="parameter_annotations"><span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> Gdk.EventKey]</span></td>
3531 </tr>
3532 <tr>
3533 <td class="parameter_name"><p>user_data</p></td>
3534 <td class="parameter_description"><p>user data set when the signal handler was connected.</p></td>
3535 <td class="parameter_annotations"> </td>
3536 </tr>
3537 </tbody>
3538 </table></div>
3539 </div>
3540 <div class="refsect3">
3541 <a name="GooCanvasItem-key-press-event.returns"></a><h4>Returns</h4>
3542 <p> <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> to stop the signal emission, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> to let it
3543 continue.</p>
3544 </div>
3545 <p>Flags: <a href="/usr/share/gtk-doc/html/gobject/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS">Run Last</a></p>
3546 </div>
3547 <hr>
3548 <div class="refsect2">
3549 <a name="GooCanvasItem-key-release-event"></a><h3>The <code class="literal">“key-release-event”</code> signal</h3>
3550 <pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
3551 user_function (<a class="link" href="GooCanvasItem.html" title="GooCanvasItem"><span class="type">GooCanvasItem</span></a> *item,
3552 <a class="link" href="GooCanvasItem.html" title="GooCanvasItem"><span class="type">GooCanvasItem</span></a> *target_item,
3553 <a href="/usr/share/gtk-doc/html/gdk3/gdk3-Event-Structures.html#GdkEvent"><span class="type">GdkEvent</span></a> *event,
3554 <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data)</pre>
3555 <p>Emitted when a key is released and the item has the keyboard
3556 focus.</p>
3557 <div class="refsect3">
3558 <a name="GooCanvasItem-key-release-event.parameters"></a><h4>Parameters</h4>
3559 <div class="informaltable"><table width="100%" border="0">
3560 <colgroup>
3561 <col width="150px" class="parameters_name">
3562 <col class="parameters_description">
3563 <col width="200px" class="parameters_annotations">
3564 </colgroup>
3565 <tbody>
3566 <tr>
3567 <td class="parameter_name"><p>item</p></td>
3568 <td class="parameter_description"><p>the item that received the signal.</p></td>
3569 <td class="parameter_annotations"> </td>
3570 </tr>
3571 <tr>
3572 <td class="parameter_name"><p>target_item</p></td>
3573 <td class="parameter_description"><p>the target of the event.</p></td>
3574 <td class="parameter_annotations"> </td>
3575 </tr>
3576 <tr>
3577 <td class="parameter_name"><p>event</p></td>
3578 <td class="parameter_description"><p>the event data. </p></td>
3579 <td class="parameter_annotations"><span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> Gdk.EventKey]</span></td>
3580 </tr>
3581 <tr>
3582 <td class="parameter_name"><p>user_data</p></td>
3583 <td class="parameter_description"><p>user data set when the signal handler was connected.</p></td>
3584 <td class="parameter_annotations"> </td>
3585 </tr>
3586 </tbody>
3587 </table></div>
3588 </div>
3589 <div class="refsect3">
3590 <a name="GooCanvasItem-key-release-event.returns"></a><h4>Returns</h4>
3591 <p> <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> to stop the signal emission, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> to let it
3592 continue.</p>
3593 </div>
3594 <p>Flags: <a href="/usr/share/gtk-doc/html/gobject/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS">Run Last</a></p>
3595 </div>
3596 <hr>
3597 <div class="refsect2">
3598 <a name="GooCanvasItem-leave-notify-event"></a><h3>The <code class="literal">“leave-notify-event”</code> signal</h3>
3599 <pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
3600 user_function (<a class="link" href="GooCanvasItem.html" title="GooCanvasItem"><span class="type">GooCanvasItem</span></a> *item,
3601 <a class="link" href="GooCanvasItem.html" title="GooCanvasItem"><span class="type">GooCanvasItem</span></a> *target_item,
3602 <a href="/usr/share/gtk-doc/html/gdk3/gdk3-Event-Structures.html#GdkEvent"><span class="type">GdkEvent</span></a> *event,
3603 <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data)</pre>
3604 <p>Emitted when the mouse leaves an item.</p>
3605 <div class="refsect3">
3606 <a name="GooCanvasItem-leave-notify-event.parameters"></a><h4>Parameters</h4>
3607 <div class="informaltable"><table width="100%" border="0">
3608 <colgroup>
3609 <col width="150px" class="parameters_name">
3610 <col class="parameters_description">
3611 <col width="200px" class="parameters_annotations">
3612 </colgroup>
3613 <tbody>
3614 <tr>
3615 <td class="parameter_name"><p>item</p></td>
3616 <td class="parameter_description"><p>the item that received the signal.</p></td>
3617 <td class="parameter_annotations"> </td>
3618 </tr>
3619 <tr>
3620 <td class="parameter_name"><p>target_item</p></td>
3621 <td class="parameter_description"><p>the target of the event.</p></td>
3622 <td class="parameter_annotations"> </td>
3623 </tr>
3624 <tr>
3625 <td class="parameter_name"><p>event</p></td>
3626 <td class="parameter_description"><p>the event data. The x &amp; y fields
3627 contain the mouse position in the item's coordinate space. The x_root
3628 &amp; y_root fields contain the same coordinates converted to the canvas
3629 coordinate space. </p></td>
3630 <td class="parameter_annotations"><span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> Gdk.EventCrossing]</span></td>
3631 </tr>
3632 <tr>
3633 <td class="parameter_name"><p>user_data</p></td>
3634 <td class="parameter_description"><p>user data set when the signal handler was connected.</p></td>
3635 <td class="parameter_annotations"> </td>
3636 </tr>
3637 </tbody>
3638 </table></div>
3639 </div>
3640 <div class="refsect3">
3641 <a name="GooCanvasItem-leave-notify-event.returns"></a><h4>Returns</h4>
3642 <p> <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> to stop the signal emission, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> to let it
3643 continue.</p>
3644 </div>
3645 <p>Flags: <a href="/usr/share/gtk-doc/html/gobject/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS">Run Last</a></p>
3646 </div>
3647 <hr>
3648 <div class="refsect2">
3649 <a name="GooCanvasItem-motion-notify-event"></a><h3>The <code class="literal">“motion-notify-event”</code> signal</h3>
3650 <pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
3651 user_function (<a class="link" href="GooCanvasItem.html" title="GooCanvasItem"><span class="type">GooCanvasItem</span></a> *item,
3652 <a class="link" href="GooCanvasItem.html" title="GooCanvasItem"><span class="type">GooCanvasItem</span></a> *target_item,
3653 <a href="/usr/share/gtk-doc/html/gdk3/gdk3-Event-Structures.html#GdkEvent"><span class="type">GdkEvent</span></a> *event,
3654 <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data)</pre>
3655 <p>Emitted when the mouse moves within an item.</p>
3656 <div class="refsect3">
3657 <a name="GooCanvasItem-motion-notify-event.parameters"></a><h4>Parameters</h4>
3658 <div class="informaltable"><table width="100%" border="0">
3659 <colgroup>
3660 <col width="150px" class="parameters_name">
3661 <col class="parameters_description">
3662 <col width="200px" class="parameters_annotations">
3663 </colgroup>
3664 <tbody>
3665 <tr>
3666 <td class="parameter_name"><p>item</p></td>
3667 <td class="parameter_description"><p>the item that received the signal.</p></td>
3668 <td class="parameter_annotations"> </td>
3669 </tr>
3670 <tr>
3671 <td class="parameter_name"><p>target_item</p></td>
3672 <td class="parameter_description"><p>the target of the event.</p></td>
3673 <td class="parameter_annotations"> </td>
3674 </tr>
3675 <tr>
3676 <td class="parameter_name"><p>event</p></td>
3677 <td class="parameter_description"><p>the event data. The x &amp; y fields
3678 contain the mouse position in the item's coordinate space. The x_root
3679 &amp; y_root fields contain the same coordinates converted to the canvas
3680 coordinate space. </p></td>
3681 <td class="parameter_annotations"><span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> Gdk.EventMotion]</span></td>
3682 </tr>
3683 <tr>
3684 <td class="parameter_name"><p>user_data</p></td>
3685 <td class="parameter_description"><p>user data set when the signal handler was connected.</p></td>
3686 <td class="parameter_annotations"> </td>
3687 </tr>
3688 </tbody>
3689 </table></div>
3690 </div>
3691 <div class="refsect3">
3692 <a name="GooCanvasItem-motion-notify-event.returns"></a><h4>Returns</h4>
3693 <p> <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> to stop the signal emission, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> to let it
3694 continue.</p>
3695 </div>
3696 <p>Flags: <a href="/usr/share/gtk-doc/html/gobject/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS">Run Last</a></p>
3697 </div>
3698 <hr>
3699 <div class="refsect2">
3700 <a name="GooCanvasItem-query-tooltip"></a><h3>The <code class="literal">“query-tooltip”</code> signal</h3>
3701 <pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
3702 user_function (<a class="link" href="GooCanvasItem.html" title="GooCanvasItem"><span class="type">GooCanvasItem</span></a> *item,
3703 <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> x,
3704 <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> y,
3705 <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> keyboard_mode,
3706 <a href="/usr/share/gtk-doc/html/gtk3/GtkTooltip.html#GtkTooltip-struct"><span class="type">GtkTooltip</span></a> *tooltip,
3707 <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data)</pre>
3708 <p>Emitted when the mouse has paused over the item for a certain amount
3709 of time, or the tooltip was requested via the keyboard.</p>
3710 <p>Note that if <em class="parameter"><code>keyboard_mode</code></em>
3711 is <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, the values of <em class="parameter"><code>x</code></em>
3712 and <em class="parameter"><code>y</code></em>
3713 are
3714 undefined and should not be used.</p>
3715 <p>If the item wants to display a tooltip it should update <em class="parameter"><code>tooltip</code></em>
3716
3717 and return <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>.</p>
3718 <div class="refsect3">
3719 <a name="GooCanvasItem-query-tooltip.parameters"></a><h4>Parameters</h4>
3720 <div class="informaltable"><table width="100%" border="0">
3721 <colgroup>
3722 <col width="150px" class="parameters_name">
3723 <col class="parameters_description">
3724 <col width="200px" class="parameters_annotations">
3725 </colgroup>
3726 <tbody>
3727 <tr>
3728 <td class="parameter_name"><p>item</p></td>
3729 <td class="parameter_description"><p>the item which received the signal.</p></td>
3730 <td class="parameter_annotations"> </td>
3731 </tr>
3732 <tr>
3733 <td class="parameter_name"><p>x</p></td>
3734 <td class="parameter_description"><p>the x coordinate of the mouse.</p></td>
3735 <td class="parameter_annotations"> </td>
3736 </tr>
3737 <tr>
3738 <td class="parameter_name"><p>y</p></td>
3739 <td class="parameter_description"><p>the y coordinate of the mouse.</p></td>
3740 <td class="parameter_annotations"> </td>
3741 </tr>
3742 <tr>
3743 <td class="parameter_name"><p>keyboard_mode</p></td>
3744 <td class="parameter_description"><p><a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the tooltip was triggered using the keyboard.</p></td>
3745 <td class="parameter_annotations"> </td>
3746 </tr>
3747 <tr>
3748 <td class="parameter_name"><p>tooltip</p></td>
3749 <td class="parameter_description"><p>a <a href="/usr/share/gtk-doc/html/gtk3/GtkTooltip.html#GtkTooltip-struct"><span class="type">GtkTooltip</span></a>.</p></td>
3750 <td class="parameter_annotations"> </td>
3751 </tr>
3752 <tr>
3753 <td class="parameter_name"><p>user_data</p></td>
3754 <td class="parameter_description"><p>user data set when the signal handler was connected.</p></td>
3755 <td class="parameter_annotations"> </td>
3756 </tr>
3757 </tbody>
3758 </table></div>
3759 </div>
3760 <div class="refsect3">
3761 <a name="GooCanvasItem-query-tooltip.returns"></a><h4>Returns</h4>
3762 <p> <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the item has set a tooltip to show.</p>
3763 </div>
3764 <p>Flags: <a href="/usr/share/gtk-doc/html/gobject/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS">Run Last</a></p>
3765 </div>
3766 <hr>
3767 <div class="refsect2">
3768 <a name="GooCanvasItem-scroll-event"></a><h3>The <code class="literal">“scroll-event”</code> signal</h3>
3769 <pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
3770 user_function (<a class="link" href="GooCanvasItem.html" title="GooCanvasItem"><span class="type">GooCanvasItem</span></a> *item,
3771 <a class="link" href="GooCanvasItem.html" title="GooCanvasItem"><span class="type">GooCanvasItem</span></a> *target_item,
3772 <a href="/usr/share/gtk-doc/html/gdk3/gdk3-Event-Structures.html#GdkEvent"><span class="type">GdkEvent</span></a> *event,
3773 <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data)</pre>
3774 <p>Emitted when a button in the 4 to 7 range is pressed. Wheel mice are
3775 usually configured to generate button press events for buttons 4 and 5
3776 when the wheel is turned in an item.</p>
3777 <div class="refsect3">
3778 <a name="GooCanvasItem-scroll-event.parameters"></a><h4>Parameters</h4>
3779 <div class="informaltable"><table width="100%" border="0">
3780 <colgroup>
3781 <col width="150px" class="parameters_name">
3782 <col class="parameters_description">
3783 <col width="200px" class="parameters_annotations">
3784 </colgroup>
3785 <tbody>
3786 <tr>
3787 <td class="parameter_name"><p>item</p></td>
3788 <td class="parameter_description"><p>the item that received the signal.</p></td>
3789 <td class="parameter_annotations"> </td>
3790 </tr>
3791 <tr>
3792 <td class="parameter_name"><p>target_item</p></td>
3793 <td class="parameter_description"><p>the target of the event.</p></td>
3794 <td class="parameter_annotations"> </td>
3795 </tr>
3796 <tr>
3797 <td class="parameter_name"><p>event</p></td>
3798 <td class="parameter_description"><p>the event data. The x &amp; y fields
3799 contain the mouse position in the item's coordinate space. The x_root
3800 &amp; y_root fields contain the same coordinates converted to the canvas
3801 coordinate space. </p></td>
3802 <td class="parameter_annotations"><span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> Gdk.EventScroll]</span></td>
3803 </tr>
3804 <tr>
3805 <td class="parameter_name"><p>user_data</p></td>
3806 <td class="parameter_description"><p>user data set when the signal handler was connected.</p></td>
3807 <td class="parameter_annotations"> </td>
3808 </tr>
3809 </tbody>
3810 </table></div>
3811 </div>
3812 <div class="refsect3">
3813 <a name="GooCanvasItem-scroll-event.returns"></a><h4>Returns</h4>
3814 <p> <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> to stop the signal emission, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> to let it
3815 continue.</p>
3816 </div>
3817 <p>Flags: <a href="/usr/share/gtk-doc/html/gobject/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS">Run Last</a></p>
3818 </div>
3819 </div>
3820 </div>
3821 <div class="footer">
3822 <hr>Generated by GTK-Doc V1.26</div>
3823 </body>
3824 </html>