/usr/share/gtk-doc/html/pygoocanvas/class-canvas-item-model.html is in python-pygoocanvas 0.14.1-1+b3.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 | <html><head><meta http-equiv="Content-Type" content="text/html; charset=utf-8"><title>goocanvas.ItemModel</title><link rel="stylesheet" href="style.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"><link rel="home" href="index.html" title="PyGooCanvas Reference Manual"><link rel="up" href="pygoocanvas-core-classes.html" title="PyGooCanvas Core Class Reference"><link rel="prev" href="class-canvas-item-simple.html" title="goocanvas.ItemSimple"><link rel="next" href="class-canvas-item-model-simple.html" title="goocanvas.ItemModelSimple"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">goocanvas.ItemModel</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="class-canvas-item-simple.html">Prev</a> </td><th width="60%" align="center">PyGooCanvas Core Class Reference</th><td width="20%" align="right"> <a accesskey="n" href="class-canvas-item-model-simple.html">Next</a></td></tr></table><hr></div><div class="refentry" title="goocanvas.ItemModel"><a name="class-canvas-item-model"></a><div class="titlepage"></div><div class="refnamediv"><h2>goocanvas.ItemModel</h2><p>goocanvas.ItemModel — The interface for canvas item models.</p></div><div class="refsect1" title="Synopsis"><a name="idp4523680"></a><h2>Synopsis</h2><table bgcolor="#D0E0F0" width="100%"><tr><td><pre class="classsynopsis">class <span class="ooclass"><span class="classname">goocanvas.ItemModel</span></span>(<span class="ooclass"><span class="classname">gobject.GInterface</span></span>):
<code class="methodsynopsis"> def <span class="methodname">add_child</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>item</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>position</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname">allocate_area</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>cr</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>requested_area</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>allocated_area</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>x_offset</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>y_offset</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname">animate</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>x</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>y</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>scale</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>degrees</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>absolute</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>duration</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>step_time</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>type</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname">ensure_updated</span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname">find_child</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>child</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname">get_bounds</span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname">get_canvas</span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname">get_child</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>child_num</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname">get_child_properties</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>child</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>...</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname">get_child_property</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>child</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>property</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname">get_item_at</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>x</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>y</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>cr</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>is_pointer_event</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>parent_is_visible</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname">get_model</span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname">get_n_children</span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname">get_parent</span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname">get_requested_area</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>cr</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>requested_area</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname">get_style</span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname">get_transform</span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname">get_simple_transform</span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname">is_container</span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname">is_visible</span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname">lower</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>below</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname">move_child</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>old_position</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>new_position</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname">paint</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>cr</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>bounds</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>scale</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname">raise_</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>above</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname">remove</span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname">remove_child</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>child_num</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname">request_update</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>child_num</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname">rotate</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>degrees</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>cx</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>cy</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname">scale</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>sx</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>sy</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname">set_canvas</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>canvas</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname">set_child_properties</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>child</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>properties</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname">set_child_property</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>child</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>property</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname">set_model</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>model</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname">set_parent</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>parent</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname">set_simple_transform</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>x</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>y</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>scale</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>rotation</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname">set_style</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>style</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname">set_transform</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>matrix</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname">skew_x</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>degrees</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>cx</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>cy</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname">skew_y</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>degrees</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>cx</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>cy</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname">stop_animation</span><span class="methodname"></span>()</code><br><code class="methodsynopsis"> def <span class="methodname">translate</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>tx</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>ty</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname">update</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>entire_tree</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>cr</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>bounds</code></strong></span></span>)</code><br></pre></td></tr></table></div><div class="refsect1" title="Ancestry"><a name="idp4652976"></a><h2>Ancestry</h2><pre class="synopsis">+-- <a
href="../pygobject/class-gobjectginterface.html"
>gobject.GInterface</a>
+-- goocanvas.ItemModel
</pre></div><div class="refsect1" title="goocanvas.ItemModel Properties"><a name="properties-goocanvasitemmodel"></a><h2>goocanvas.ItemModel Properties</h2><div class="blockquote"><table width="100%" border="0" bgcolor="#E0E0E0"><tr><td valign="top"><div class="informaltable"><table width="100%" border="0"><colgroup><col width="1in"><col width="1in"><col width="3.5in"></colgroup><tbody><tr valign="top"><td valign="top">"can-focus"</td><td valign="top">Read/Write</td><td valign="top">If the item can take the keyboard focus. Default value: False</td></tr><tr valign="top"><td valign="top">"description"</td><td valign="top">Read/Write</td><td valign="top">A description of the item for use by assistive technologies. Default value: NULL</td></tr><tr valign="top"><td valign="top">"parent"</td><td valign="top">Read/Write</td><td valign="top">The parent item.</td></tr><tr valign="top"><td valign="top">"pointer-events"</td><td valign="top">Read/Write</td><td valign="top">Specifies when the item receives pointer events. Default value:
goocanvas.EVENTS_VISIBLE_MASK|goocanvas.EVENTS_PAINTED_MASK|
goocanvas.EVENTS_FILL_MASK|goocanvas.EVENTS_STROKE_MASK</td></tr><tr valign="top"><td valign="top">"title"</td><td valign="top">Read/Write</td><td valign="top">A short context-rich description of the item for use by
assistive technologies. Default value: NULL</td></tr><tr valign="top"><td valign="top">"transform"</td><td valign="top">Read/Write</td><td valign="top">The transformation matrix of the item. </td></tr><tr valign="top"><td valign="top">"visibility"</td><td valign="top">Read/Write</td><td valign="top">When the canvas item is visible. Default value: goocanvas.ITEM_VISIBLE.</td></tr><tr valign="top"><td valign="top">"visibility-threshold"</td><td valign="top">Read/Write</td><td valign="top">The scale threshold at which the item becomes visible.
Allowed values: >= 0 Default value: 0</td></tr></tbody></table></div></td></tr></table></div></div><div class="refsect1" title="goocanvas.ItemModel Signal Prototypes"><a name="signal-prototypes-goocanvasitemmodel"></a><h2>goocanvas.ItemModel Signal Prototypes</h2><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term">"button-press-event"</span></p></td><td><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>item</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>target_item</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>event</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></td></tr><tr><td><p><span class="term">"button-release-event"</span></p></td><td><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>item</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>target_item</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>event</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></td></tr><tr><td><p><span class="term">"child-notify"</span></p></td><td><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>item</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>pspec</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></td></tr><tr><td><p><span class="term">"enter-notify-event"</span></p></td><td><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>item</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>target_item</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>event</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></td></tr><tr><td><p><span class="term">"focus-in-event"</span></p></td><td><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>item</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>target_item</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>event</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></td></tr><tr><td><p><span class="term">"focus-out-event"</span></p></td><td><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>item</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>target_item</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>event</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></td></tr><tr><td><p><span class="term">"grab-broken-event"</span></p></td><td><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>item</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>target_item</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>event</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></td></tr><tr><td><p><span class="term">"key-press-event"</span></p></td><td><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>item</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>target_item</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>event</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></td></tr><tr><td><p><span class="term">"key-release-event"</span></p></td><td><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>item</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>target_item</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>event</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></td></tr><tr><td><p><span class="term">"leave-notify-event"</span></p></td><td><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>item</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>target_item</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>event</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></td></tr><tr><td><p><span class="term">"motion-notify-event"</span></p></td><td><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>item</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>target_item</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>event</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></td></tr></tbody></table></div><div class="refsect1" title="Known Implementation"><a name="idp4744352"></a><h2>Known Implementation</h2><p>
<code class="classname">goocanvas.ItemModel</code>
is implementated by
<code class="classname">goocanvas.Rect</code>,
<code class="classname">goocanvas.Ellipse</code>,
<code class="classname">goocanvas.Path</code>,
<code class="classname">goocanvas.Polyline</code>,
<code class="classname">goocanvas.Text</code>,
<code class="classname">goocanvas.Image</code>,
<code class="classname">goocanvas.Group</code>,
<code class="classname">goocanvas.Widget</code>,
<code class="classname">goocanvas.Table</code>,
<code class="classname">goocanvas.ItemModelSimple</code>
</p></div><div class="refsect1" title="Description"><a name="idp4755088"></a><h2>Description</h2><code class="classname">goocanvas.ItemModel</code>
defines the interface that canvas items must implement, and contains methods for operating on canvas items.
</div><div class="refsect1" title="Methods"><a name="idp4756944"></a><h2>Methods</h2><div class="refsect2" title="goocanvas.ItemModel.add_child"><a name="method-goocanvasitemmodel--add-child"></a><h3>goocanvas.ItemModel.add_child</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">add_child</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>item</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>position</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>item</code></strong>:</span></p></td><td>The item to add.</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>position</code></strong>:</span></p></td><td>the position of the item, or -1 to place it
last (at the top of the stacking order).</td></tr></tbody></table><p>
Adds a child item to a container item at the given stack position.
</p></div><div class="refsect2" title="goocanvas.ItemModel.allocate_area"><a name="method-goocanvasitemmodel--allocate-area"></a><h3>goocanvas.ItemModel.allocate_area</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">allocate_area</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>cr</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>requested_area</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>allocated_area</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>x_offset</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>y_offset</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>cr</code></strong>:</span></p></td><td>A cairo context.</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>requested_area</code></strong>:</span></p></td><td>The area that the item originally requested, in the parent's coordinate space.</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>allocated_area</code></strong>:</span></p></td><td>The area that the item has been allocated, in the parent's coordinate space.</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>x_offset</code></strong>:</span></p></td><td>The x offset of the allocated area from the requested area in
the device coordinate space.</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>y_offset</code></strong>:</span></p></td><td>The y offset of the allocated area from the requested area in
the device coordinate space.</td></tr></tbody></table><p>
This is used by <code class="classname">goocanvas.Table</code>
and other layout items to allocate an area to each of their children.
</p><p>
Note that the parent item will use a transform to move each of its children for the layout,
so their is no need for the item to reposition itself. It only needs to recalculate its device bounds.
</p><p>
The x_offset and y_offset are provided since for the simple builtin items all they need
to do is add these to their bounds.
</p></div><div class="refsect2" title="goocanvas.ItemModel.animate"><a name="method-goocanvasitemmodel--animate"></a><h3>goocanvas.ItemModel.animate</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">animate</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>x</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>y</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>scale</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>degrees</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>absolute</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>duration</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>step_time</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>type</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>x</code></strong>:</span></p></td><td>the final x offset from the current position.</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>y</code></strong>:</span></p></td><td>the final y offset from the current position.</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>scale</code></strong>:</span></p></td><td>the final scale of the item.</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>degrees</code></strong>:</span></p></td><td>the final rotation of the item.</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>absolute</code></strong>:</span></p></td><td>if the x, y, scale and degrees values are absolute, or relative to the
current transform. Note that absolute animations only work if the item currently has a simple transform.
If the item has a shear or some other complicated transform it may result in strange animations.</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>duration</code></strong>:</span></p></td><td>the duration of the animation, in milliseconds
(1/1000ths of a second).</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>step_time</code></strong>:</span></p></td><td>the time between each animation step, in milliseconds.</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>type</code></strong>:</span></p></td><td>specifies what happens when the animation finishes.</td></tr></tbody></table><p>
Animates an item from its current position to the given offsets, scale and rotation.
</p></div><div class="refsect2" title="goocanvas.ItemModel.ensure_updated"><a name="method-goocanvasitemmodel--ensure-updated"></a><h3>goocanvas.ItemModel.ensure_updated</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">ensure_updated</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody></tbody></table><p>
Updates the canvas immediately, if an update is scheduled. This ensures that all item bounds are up-to-date.
</p></div><div class="refsect2" title="goocanvas.ItemModel.find_child"><a name="method-goocanvasitemmodel--find-child"></a><h3>goocanvas.ItemModel.find_child</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">find_child</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>child</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>child</code></strong>:</span></p></td><td>the child item to find.</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span>:</span></p></td><td>The position of the given child item, or -1 if it isn't found.</td></tr></tbody></table><p>
Attempts to find the given child item with the container's stack.
</p></div><div class="refsect2" title="goocanvas.ItemModel.get_bounds"><a name="method-goocanvasitemmodel--get-bounds"></a><h3>goocanvas.ItemModel.get_bounds</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_bounds</span>()</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span>:</span></p></td><td>A tuple containing the four coordinates.</td></tr></tbody></table><p>
Gets the bounds of the item.
Note that the bounds includes the entire fill and stroke extents of the item,
whether they are painted or not.
</p></div><div class="refsect2" title="goocanvas.ItemModel.get_canvas"><a name="method-goocanvasitemmodel--get-canvas"></a><h3>goocanvas.ItemModel.get_canvas</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_canvas</span>()</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span>:</span></p></td><td>The
<code class="classname">goocanvas.Canvas</code></td></tr></tbody></table><p>
Returns the <code class="classname">goocanvas.Canvas</code>
</p></div><div class="refsect2" title="goocanvas.ItemModel.get_child"><a name="method-goocanvasitemmodel--get-child"></a><h3>goocanvas.ItemModel.get_child</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_child</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>child_num</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>child_num</code></strong>:</span></p></td><td>the position of a child in the container's stack.</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span>:</span></p></td><td>The child item at the given stack position.</td></tr></tbody></table><p>
Gets the child item at the given stack position.
</p></div><div class="refsect2" title="goocanvas.ItemModel.get_child_properties"><a name="method-goocanvasitemmodel--get-child-properties"></a><h3>goocanvas.ItemModel.get_child_properties</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_child_properties</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>child</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>properties</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>child</code></strong>:</span></p></td><td>a child
<code class="classname">goocanvas.ItemModel</code>
</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>properties</code></strong>:</span></p></td><td>property names as string</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span>:</span></p></td><td>A tuple containing the property values.</td></tr></tbody></table><p>
Gets the values of one or more child properties of child.
</p></div><div class="refsect2" title="goocanvas.ItemModel.get_child_property"><a name="method-goocanvasitemmodel--get-child-property"></a><h3>goocanvas.ItemModel.get_child_property</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_child_property</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>child</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>property</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>child</code></strong>:</span></p></td><td>a child
<code class="classname">goocanvas.ItemModel</code>
</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>property</code></strong>:</span></p></td><td>property name as string</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span>:</span></p></td><td>The property value.</td></tr></tbody></table><p>
Gets the value of the property of child.
</p></div><div class="refsect2" title="goocanvas.ItemModel.get_item_at"><a name="method-goocanvasitemmodel--get-item-at"></a><h3>goocanvas.ItemModel.get_item_at</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_item_at</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>x</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>y</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>cr</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>is_pointer_event</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>parent_is_visible</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>x</code></strong>:</span></p></td><td>The x coordinate of the point.</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>y</code></strong>:</span></p></td><td>The y coordinate of the point.</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>cr</code></strong>:</span></p></td><td>A cairo context.</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>is_pointer_event</code></strong>:</span></p></td><td>True if the "pointer-events" properties of items should be used
to determine which parts of the item are tested.</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>parent_is_visible</code></strong>:</span></p></td><td>True if the parent item is visible (which implies that all ancestors
are also visible).</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span>:</span></p></td><td>The item found at the given point, or None if no item was found.</td></tr></tbody></table><p>
Gets the item at the given point.
</p></div><div class="refsect2" title="goocanvas.ItemModel.get_model"><a name="method-goocanvasitemmodel--get-model"></a><h3>goocanvas.ItemModel.get_model</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_model</span>()</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span>:</span></p></td><td>the canvas model, or None of
the item isn't in a model.</td></tr></tbody></table><p>
Gets the model of the canvas item.
</p></div><div class="refsect2" title="goocanvas.ItemModel.get_n_children"><a name="method-goocanvasitemmodel--get-n-children"></a><h3>goocanvas.ItemModel.get_n_children</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_n_children</span>()</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span>:</span></p></td><td>The number of children.</td></tr></tbody></table><p>
Gets the number of children of the container.
</p></div><div class="refsect2" title="goocanvas.ItemModel.get_parent"><a name="method-goocanvasitemmodel--get-parent"></a><h3>goocanvas.ItemModel.get_parent</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_parent</span>()</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span>:</span></p></td><td>The parent item, or None if the
item has no parent.</td></tr></tbody></table><p>
Gets the parent of the given item.
</p></div><div class="refsect2" title="goocanvas.ItemModel.get_requested_area"><a name="method-goocanvasitemmodel--get-requested-area"></a><h3>goocanvas.ItemModel.get_requested_area</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_requested_area</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>cr</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>requested_area</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>cr</code></strong>:</span></p></td><td>A cairo context.</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>requested_area</code></strong>:</span></p></td><td>A GooCanvasBounds to return the requested area in, in the
parent's coordinate space.</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span>:</span></p></td><td>True if the item should be allocated space.</td></tr></tbody></table><p>
This is used by GooCanvasTable and other layout items to get the requested area of each of their children.
</p><p>
FIXME: This method is currently broken, it needs to be manually wrapped returning the bounds instead of True/False.
</p></div><div class="refsect2" title="goocanvas.ItemModel.get_style"><a name="method-goocanvasitemmodel--get-style"></a><h3>goocanvas.ItemModel.get_style</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_style</span>()</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span>:</span></p></td><td>The item's style.</td></tr></tbody></table><p>
Gets the item's style. If the item doesn't have its own style it will return its parent's style.
</p></div><div class="refsect2" title="goocanvas.ItemModel.get_simple_transform"><a name="method-goocanvasitemmodel--get-simple-transform"></a><h3>goocanvas.ItemModel.get_simple_transform</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_simple_transform</span>()</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span>:</span></p></td><td>A 4 item tuple containing the item's x, y, scale and rotation.</td></tr></tbody></table><p>
This function can be used to get the position, scale and rotation of an item, providing that
the item has a simple transformation matrix (e.g. set with
<code class="methodname">goocanvas.ItemModel.set_simple_transform</code>(),
or using a combination of simple translate, scale and rotate operations).
If the item has a complex transformation matrix the results will be incorrect.
</p></div><div class="refsect2" title="goocanvas.ItemModel.get_transform"><a name="method-goocanvasitemmodel--get-transform"></a><h3>goocanvas.ItemModel.get_transform</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_transform</span>()</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span>:</span></p></td><td>The item's transformation matrix.</td></tr></tbody></table><p>
Gets the transformation matrix of an item.
</p></div><div class="refsect2" title="goocanvas.ItemModel.is_container"><a name="method-goocanvasitemmodel--is-container"></a><h3>goocanvas.ItemModel.is_container</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">is_container</span>()</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span>:</span></p></td><td>True if the item is a container.</td></tr></tbody></table><p>
Tests to see if the given item is a container.
</p></div><div class="refsect2" title="goocanvas.ItemModel.is_visible"><a name="method-goocanvasitemmodel--is-visible"></a><h3>goocanvas.ItemModel.is_visible</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">is_visible</span>()</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span>:</span></p></td><td>True if the item is visible.</td></tr></tbody></table><p>
Tests to see if the given item is visible.
</p><p>
This entails checking the item's own visibility setting, as well as those of its ancestors.
</p><p>
Note that the item may be scrolled off the screen and so may not be actually visible to the user.
</p></div><div class="refsect2" title="goocanvas.ItemModel.lower"><a name="method-goocanvasitemmodel--lower"></a><h3>goocanvas.ItemModel.lower</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">lower</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>below</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>below</code></strong>:</span></p></td><td>the item to lower item below,
or None to lower item to the bottom of the stack.</td></tr></tbody></table><p>
Lowers an item in the stacking order.
</p></div><div class="refsect2" title="goocanvas.ItemModel.move_child"><a name="method-goocanvasitemmodel--move-child"></a><h3>goocanvas.ItemModel.move_child</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">move_child</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>old_position</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>new_position</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>old_position</code></strong>:</span></p></td><td>the current position of the child item.</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>new_position</code></strong>:</span></p></td><td>the new position of the child item.</td></tr></tbody></table><p>
Moves a child item to a new stack position within the container.
</p></div><div class="refsect2" title="goocanvas.ItemModel.paint"><a name="method-goocanvasitemmodel--paint"></a><h3>goocanvas.ItemModel.paint</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">paint</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>cr</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>bounds</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>scale</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>cr</code></strong>:</span></p></td><td>A cairo context.</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>bounds</code></strong>:</span></p></td><td>The bounds that need to be repainted.</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>scale</code></strong>:</span></p></td><td>the scale to use to determine whether an item should be painted.
See visibility-thresold</td></tr></tbody></table><p>
Moves a child item to a new stack position within the container.
</p></div><div class="refsect2" title="goocanvas.ItemModel.raise_"><a name="method-goocanvasitemmodel--raise-"></a><h3>goocanvas.ItemModel.raise_</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">raise_</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>above</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>above</code></strong>:</span></p></td><td>the item to raise item above, or
NULL to raise item to the top of the stack.</td></tr></tbody></table><p>
Raises an item in the stacking order.
</p></div><div class="refsect2" title="goocanvas.ItemModel.remove"><a name="method-goocanvasitemmodel--remove"></a><h3>goocanvas.ItemModel.remove</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">remove</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody></tbody></table><p>
Removes a model from its parent. If the model is in a canvas it will be removed.
</p><p>
This would normally also result in the model being freed.
</p></div><div class="refsect2" title="goocanvas.ItemModel.remove_child"><a name="method-goocanvasitemmodel--remove-child"></a><h3>goocanvas.ItemModel.remove_child</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">remove_child</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>child_num</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>child_num</code></strong>:</span></p></td><td>the position of the child item to remove.</td></tr></tbody></table><p>
Removes the child item at the given position.
</p></div><div class="refsect2" title="goocanvas.ItemModel.request_update"><a name="method-goocanvasitemmodel--request-update"></a><h3>goocanvas.ItemModel.request_update</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">request_update</span>()</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody></tbody></table><p>
Requests that an update of the item is scheduled. It will be performed
as soon as the application is idle, and before the canvas is redrawn.
</p></div><div class="refsect2" title="goocanvas.ItemModel.rotate"><a name="method-goocanvasitemmodel--rotate"></a><h3>goocanvas.ItemModel.rotate</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">rotate</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>degrees</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>cx</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>cy</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>degrees</code></strong>:</span></p></td><td>the clockwise angle of rotation.</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>cx</code></strong>:</span></p></td><td>the x coordinate of the origin of the rotation.</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>cy</code></strong>:</span></p></td><td>the y coordinate of the origin of the rotation.</td></tr></tbody></table><p>
Rotates the item's coordinate system by the given amount, about the given origin.
</p></div><div class="refsect2" title="goocanvas.ItemModel.scale"><a name="method-goocanvasitemmodel--scale"></a><h3>goocanvas.ItemModel.scale</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">scale</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>sx</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>sy</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>sx</code></strong>:</span></p></td><td>the amount to scale the horizontal axis.</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>sy</code></strong>:</span></p></td><td>the amount to scale the vertical axis.</td></tr></tbody></table><p>
Scales the item's coordinate system by the given amounts.
</p></div><div class="refsect2" title="goocanvas.ItemModel.set_canvas"><a name="method-goocanvasitemmodel--set-canvas"></a><h3>goocanvas.ItemModel.set_canvas</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_canvas</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>canvas</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>canvas</code></strong>:</span></p></td><td>A goocanvas.Canvas</td></tr></tbody></table><p>
Sets the canvas of the item.
</p><p>
This is only needed for setting the canvas of the root item, as the other items can
get the canvas from their parents.
</p></div><div class="refsect2" title="goocanvas.ItemModel.set_child_properties"><a name="method-goocanvasitemmodel--set-child-properties"></a><h3>goocanvas.ItemModel.set_child_properties</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_child_properties</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>child</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>properties</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>childs</code></strong>:</span></p></td><td>A child goocanvas.ItemModel</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>properties</code></strong>:</span></p></td><td>The properties to set as **kwargs</td></tr></tbody></table><p>
Sets the values of one or more child properties of child.
</p></div><div class="refsect2" title="goocanvas.ItemModel.set_child_property"><a name="method-goocanvasitemmodel--set-child-property"></a><h3>goocanvas.ItemModel.set_child_property</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_child_property</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>child</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>property</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>child</code></strong>:</span></p></td><td>A child goocanvas.ItemModel</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>property</code></strong>:</span></p></td><td>The property to set as string</td></tr></tbody></table><p>
Sets a child property of child.
</p></div><div class="refsect2" title="goocanvas.ItemModel.set_model"><a name="method-goocanvasitemmodel--set-model"></a><h3>goocanvas.ItemModel.set_model</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_model</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>model</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>model</code></strong>:</span></p></td><td>A goocanvas.ItemModelModel</td></tr></tbody></table><p>
Sets the model of the given canvas item.
</p></div><div class="refsect2" title="goocanvas.ItemModel.set_parent"><a name="method-goocanvasitemmodel--set-parent"></a><h3>goocanvas.ItemModel.set_parent</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_parent</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>parent</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>parent</code></strong>:</span></p></td><td>the new parent item.</td></tr></tbody></table><p>
This function is only intended to be used when implementing new canvas item models
(specifically container models such as
goocanvas.GroupModel).
It sets the parent of the child model.
</p><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3>
This function cannot be used to add a model to a group or to change the parent of a model.
To do that use the "parent" property.
</div></div><div class="refsect2" title="goocanvas.ItemModel.set_simple_transform"><a name="method-goocanvasitemmodel--set-simple-transform"></a><h3>goocanvas.ItemModel.set_simple_transform</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_simple_transform</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>x</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>y</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>scale</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>rotation</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>x</code></strong>:</span></p></td><td>The x coordinate of the origin of the item's coordinate space.</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>y</code></strong>:</span></p></td><td>The x coordinate of the origin of the item's coordinate space.</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>scale</code></strong>:</span></p></td><td>The scale of the item.</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>rotation</code></strong>:</span></p></td><td>The clockwise rotation of the item, in degrees.</td></tr></tbody></table><p>
A convenience function to set the item's transformation matrix.
</p></div><div class="refsect2" title="goocanvas.ItemModel.set_style"><a name="method-goocanvasitemmodel--set-style"></a><h3>goocanvas.ItemModel.set_style</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_style</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>style</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>style</code></strong>:</span></p></td><td>A goocanvas.Style</td></tr></tbody></table><p>
Sets the item's style, by copying the properties from the given style.
</p></div><div class="refsect2" title="goocanvas.ItemModel.set_transform"><a name="method-goocanvasitemmodel--set-transform"></a><h3>goocanvas.ItemModel.set_transform</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_transform</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>matrix</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>matrix</code></strong>:</span></p></td><td>the new transformation matrix, or None to reset
the transformation to the identity matrix.</td></tr></tbody></table><p>
Sets the transformation matrix of an item.
</p></div><div class="refsect2" title="goocanvas.ItemModel.skew_x"><a name="method-goocanvasitemmodel--skew-x"></a><h3>goocanvas.ItemModel.skew_x</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">skew_x</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>degrees</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>cx</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>cy</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>degrees</code></strong>:</span></p></td><td>the skew angle.</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>cx</code></strong>:</span></p></td><td>the x coordinate of the origin of the skew transform.</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>cy</code></strong>:</span></p></td><td>the y coordinate of the origin of the skew transform.</td></tr></tbody></table><p>
Skews the item's coordinate system along the x axis by the given amount, about the given origin.
</p></div><div class="refsect2" title="goocanvas.ItemModel.skew_y"><a name="method-goocanvasitemmodel--skew-y"></a><h3>goocanvas.ItemModel.skew_y</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">skew_y</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>degrees</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>cx</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>cy</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>degrees</code></strong>:</span></p></td><td>the skew angle.</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>cx</code></strong>:</span></p></td><td>the x coordinate of the origin of the skew transform.</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>cy</code></strong>:</span></p></td><td>the y coordinate of the origin of the skew transform.</td></tr></tbody></table><p>
Skews the item's coordinate system along the y axis by the given amount, about the given origin.
</p></div><div class="refsect2" title="goocanvas.ItemModel.stop_animation"><a name="method-goocanvasitemmodel--stop-animation"></a><h3>goocanvas.ItemModel.stop_animation</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">stop_animation</span>()</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody></tbody></table><p>
Stops any current animation for the given item, leaving it at its current position.
</p></div><div class="refsect2" title="goocanvas.ItemModel.translate"><a name="method-goocanvasitemmodel--translate"></a><h3>goocanvas.ItemModel.translate</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">translate</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>tx</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>ty</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>tx</code></strong>:</span></p></td><td>the amount to move the origin in the horizontal direction.</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>ty</code></strong>:</span></p></td><td>the amount to move the origin in the vertical direction.</td></tr></tbody></table><p>
Translates the origin of the item's coordinate system by the given amounts.
</p></div><div class="refsect2" title="goocanvas.ItemModel.update"><a name="method-goocanvasitemmodel--update"></a><h3>goocanvas.ItemModel.update</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">update</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>entire_tree</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>cr</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>bounds</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>entire_tree</code></strong>:</span></p></td><td>If the entire subtree should be updated.</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>cr</code></strong>:</span></p></td><td>A cairo context.</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>bounds</code></strong>:</span></p></td><td>A GooCanvasBounds to return the new bounds in.</td></tr></tbody></table><p>
Updates the item, if needed, and any children.
</p></div></div><div class="refsect1" title="Signals"><a name="idp5147408"></a><h2>Signals</h2><div class="refsect2" title='The "button-press-events" goocanvas.ItemModel Signal'><a name="signal-goocanvasitemmodel--button-press-event"></a><h3>The "button-press-events" goocanvas.ItemModel Signal</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>item</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>target_item</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>event</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><em class="parameter"><code>item</code></em>:</span></p></td><td>
The <code class="classname">goocanvas.ItemModel</code>
that received the signal.
</td></tr><tr><td><p><span class="term"><em class="parameter"><code>target_item</code></em>:</span></p></td><td>
The target of the event.
</td></tr><tr><td><p><span class="term"><em class="parameter"><code>event</code></em>:</span></p></td><td>
The event data, with coordinates translated to canvas coordinates.
</td></tr><tr><td><p><span class="term"><em class="parameter"><code>user_param</code></em>:</span></p></td><td>the first user parameter (if any) specified
with the <a
href="../pygobject/class-gobject.html#method-gobject--connect"
><code class="methodname">connect</code>()</a>
method
</td></tr><tr><td><p><span class="term"><em class="parameter"><code>...</code></em>:</span></p></td><td>additional user parameters (if any)</td></tr></tbody></table><p>
The "button-press-event" signal is emitted when a mouse button is pressed in an item.
</p></div><div class="refsect2" title='The "button-press-events" goocanvas.ItemModel Signal'><a name="signal-goocanvasitemmodel--button-release-event"></a><h3>The "button-press-events" goocanvas.ItemModel Signal</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>item</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>target_item</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>event</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><em class="parameter"><code>item</code></em>:</span></p></td><td>
The <code class="classname">goocanvas.ItemModel</code>
that received the signal.
</td></tr><tr><td><p><span class="term"><em class="parameter"><code>target_item</code></em>:</span></p></td><td>
The target of the event.
</td></tr><tr><td><p><span class="term"><em class="parameter"><code>event</code></em>:</span></p></td><td>
The event data, with coordinates translated to canvas coordinates.
</td></tr><tr><td><p><span class="term"><em class="parameter"><code>user_param</code></em>:</span></p></td><td>the first user parameter (if any) specified
with the <a
href="../pygobject/class-gobject.html#method-gobject--connect"
><code class="methodname">connect</code>()</a>
method
</td></tr><tr><td><p><span class="term"><em class="parameter"><code>...</code></em>:</span></p></td><td>additional user parameters (if any)</td></tr></tbody></table><p>
The "button-release-event" signal is emitted when a mouse button is released in an item.
</p></div><div class="refsect2" title='The "child-notify" goocanvas.ItemModel Signal'><a name="signal-goocanvasitemmodel--child-notify"></a><h3>The "child-notify" goocanvas.ItemModel Signal</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>item</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>pspec</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><em class="parameter"><code>item</code></em>:</span></p></td><td>
The <code class="classname">goocanvas.ItemModel</code>
that received the signal.
</td></tr><tr><td><p><span class="term"><em class="parameter"><code>pspec</code></em>:</span></p></td><td>The GParamSpec of the changed child property.</td></tr><tr><td><p><span class="term"><em class="parameter"><code>user_param</code></em>:</span></p></td><td>the first user parameter (if any) specified
with the <a
href="../pygobject/class-gobject.html#method-gobject--connect"
><code class="methodname">connect</code>()</a>
method
</td></tr><tr><td><p><span class="term"><em class="parameter"><code>...</code></em>:</span></p></td><td>additional user parameters (if any)</td></tr></tbody></table><p>
The "child-notify" signal is emitted for each child property that has changed.
The signal's detail holds the property name.
</p></div><div class="refsect2" title='The "enter-notify-events" goocanvas.ItemModel Signal'><a name="signal-goocanvasitemmodel--enter-notify-event"></a><h3>The "enter-notify-events" goocanvas.ItemModel Signal</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>item</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>target_item</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>event</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><em class="parameter"><code>item</code></em>:</span></p></td><td>
The <code class="classname">goocanvas.ItemModel</code>
that received the signal.
</td></tr><tr><td><p><span class="term"><em class="parameter"><code>target_item</code></em>:</span></p></td><td>
The target of the event.
</td></tr><tr><td><p><span class="term"><em class="parameter"><code>event</code></em>:</span></p></td><td>
The event data, with coordinates translated to canvas coordinates.
</td></tr><tr><td><p><span class="term"><em class="parameter"><code>user_param</code></em>:</span></p></td><td>the first user parameter (if any) specified
with the <a
href="../pygobject/class-gobject.html#method-gobject--connect"
><code class="methodname">connect</code>()</a>
method
</td></tr><tr><td><p><span class="term"><em class="parameter"><code>...</code></em>:</span></p></td><td>additional user parameters (if any)</td></tr><tr><td><p><span class="term"><em class="parameter"><code>Returns</code></em>:</span></p></td><td>True to stop the signal emission, or False to let it continue.</td></tr></tbody></table><p>
The "enter-notify-event" signal is emitted when the mouse enters an item.
</p></div><div class="refsect2" title='The "focus-in-event" goocanvas.ItemModel Signal'><a name="signal-goocanvasitemmodel--focus-in-event"></a><h3>The "focus-in-event" goocanvas.ItemModel Signal</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>item</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>target_item</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>event</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><em class="parameter"><code>item</code></em>:</span></p></td><td>
The <code class="classname">goocanvas.ItemModel</code>
that received the signal.
</td></tr><tr><td><p><span class="term"><em class="parameter"><code>target_item</code></em>:</span></p></td><td>
The target of the event.
</td></tr><tr><td><p><span class="term"><em class="parameter"><code>event</code></em>:</span></p></td><td>
The event data, with coordinates translated to canvas coordinates.
</td></tr><tr><td><p><span class="term"><em class="parameter"><code>user_param</code></em>:</span></p></td><td>the first user parameter (if any) specified
with the <a
href="../pygobject/class-gobject.html#method-gobject--connect"
><code class="methodname">connect</code>()</a>
method
</td></tr><tr><td><p><span class="term"><em class="parameter"><code>...</code></em>:</span></p></td><td>additional user parameters (if any)</td></tr><tr><td><p><span class="term"><em class="parameter"><code>Returns</code></em>:</span></p></td><td>True to stop the signal emission, or False to let it continue.</td></tr></tbody></table><p>
The "focus-in-event" signal is emitted when the item receives the keyboard focus.
</p></div><div class="refsect2" title='The "focus-out-event" goocanvas.ItemModel Signal'><a name="signal-goocanvasitemmodel--focus-out-event"></a><h3>The "focus-out-event" goocanvas.ItemModel Signal</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>item</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>target_item</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>event</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><em class="parameter"><code>item</code></em>:</span></p></td><td>
The <code class="classname">goocanvas.ItemModel</code>
that received the signal.
</td></tr><tr><td><p><span class="term"><em class="parameter"><code>target_item</code></em>:</span></p></td><td>
The target of the event.
</td></tr><tr><td><p><span class="term"><em class="parameter"><code>event</code></em>:</span></p></td><td>
The event data, with coordinates translated to canvas coordinates.
</td></tr><tr><td><p><span class="term"><em class="parameter"><code>user_param</code></em>:</span></p></td><td>the first user parameter (if any) specified
with the <a
href="../pygobject/class-gobject.html#method-gobject--connect"
><code class="methodname">connect</code>()</a>
method
</td></tr><tr><td><p><span class="term"><em class="parameter"><code>...</code></em>:</span></p></td><td>additional user parameters (if any)</td></tr><tr><td><p><span class="term"><em class="parameter"><code>Returns</code></em>:</span></p></td><td>True to stop the signal emission, or False to let it continue.</td></tr></tbody></table><p>
The "focus-out-event" signal is emitted when the item loses the keyboard focus.
</p></div><div class="refsect2" title='The "grab-broken-event" goocanvas.ItemModel Signal'><a name="signal-goocanvasitemmodel--grab-broken-event"></a><h3>The "grab-broken-event" goocanvas.ItemModel Signal</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>item</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>target_item</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>event</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><em class="parameter"><code>item</code></em>:</span></p></td><td>
The <code class="classname">goocanvas.ItemModel</code>
that received the signal.
</td></tr><tr><td><p><span class="term"><em class="parameter"><code>target_item</code></em>:</span></p></td><td>
The target of the event.
</td></tr><tr><td><p><span class="term"><em class="parameter"><code>event</code></em>:</span></p></td><td>
The event data, with coordinates translated to canvas coordinates.
</td></tr><tr><td><p><span class="term"><em class="parameter"><code>user_param</code></em>:</span></p></td><td>the first user parameter (if any) specified
with the <a
href="../pygobject/class-gobject.html#method-gobject--connect"
><code class="methodname">connect</code>()</a>
method
</td></tr><tr><td><p><span class="term"><em class="parameter"><code>...</code></em>:</span></p></td><td>additional user parameters (if any)</td></tr><tr><td><p><span class="term"><em class="parameter"><code>Returns</code></em>:</span></p></td><td>True to stop the signal emission, or False to let it continue.</td></tr></tbody></table><p>
The "grab-broken-event" signal is emitted when the item's keyboard or pointer grab was lost unexpectedly.
</p></div><div class="refsect2" title='The "key-press-event" goocanvas.ItemModel Signal'><a name="signal-goocanvasitemmodel--key-press-event"></a><h3>The "key-press-event" goocanvas.ItemModel Signal</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>item</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>target_item</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>event</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><em class="parameter"><code>item</code></em>:</span></p></td><td>
The <code class="classname">goocanvas.ItemModel</code>
that received the signal.
</td></tr><tr><td><p><span class="term"><em class="parameter"><code>target_item</code></em>:</span></p></td><td>
The target of the event.
</td></tr><tr><td><p><span class="term"><em class="parameter"><code>event</code></em>:</span></p></td><td>
The event data, with coordinates translated to canvas coordinates.
</td></tr><tr><td><p><span class="term"><em class="parameter"><code>user_param</code></em>:</span></p></td><td>the first user parameter (if any) specified
with the <a
href="../pygobject/class-gobject.html#method-gobject--connect"
><code class="methodname">connect</code>()</a>
method
</td></tr><tr><td><p><span class="term"><em class="parameter"><code>...</code></em>:</span></p></td><td>additional user parameters (if any)</td></tr><tr><td><p><span class="term"><em class="parameter"><code>Returns</code></em>:</span></p></td><td>True to stop the signal emission, or False to let it continue.</td></tr></tbody></table><p>
The "key-press-event" signal is emitted when a key is pressed and the item has the keyboard focus.
</p></div><div class="refsect2" title='The "key-release-event" goocanvas.ItemModel Signal'><a name="signal-goocanvasitemmodel--key-release-event"></a><h3>The "key-release-event" goocanvas.ItemModel Signal</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>item</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>target_item</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>event</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><em class="parameter"><code>item</code></em>:</span></p></td><td>
The <code class="classname">goocanvas.ItemModel</code>
that received the signal.
</td></tr><tr><td><p><span class="term"><em class="parameter"><code>target_item</code></em>:</span></p></td><td>
The target of the event.
</td></tr><tr><td><p><span class="term"><em class="parameter"><code>event</code></em>:</span></p></td><td>
The event data, with coordinates translated to canvas coordinates.
</td></tr><tr><td><p><span class="term"><em class="parameter"><code>user_param</code></em>:</span></p></td><td>the first user parameter (if any) specified
with the <a
href="../pygobject/class-gobject.html#method-gobject--connect"
><code class="methodname">connect</code>()</a>
method
</td></tr><tr><td><p><span class="term"><em class="parameter"><code>...</code></em>:</span></p></td><td>additional user parameters (if any)</td></tr><tr><td><p><span class="term"><em class="parameter"><code>Returns</code></em>:</span></p></td><td>True to stop the signal emission, or False to let it continue.</td></tr></tbody></table><p>
The "key-release-event" signal is emitted when a key is released and the item has the keyboard focus.
</p></div><div class="refsect2" title='The "leave-notify-event" goocanvas.ItemModel Signal'><a name="signal-goocanvasitemmodel--leave-notify-event"></a><h3>The "leave-notify-event" goocanvas.ItemModel Signal</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>item</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>target_item</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>event</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><em class="parameter"><code>item</code></em>:</span></p></td><td>
The <code class="classname">goocanvas.ItemModel</code>
that received the signal.
</td></tr><tr><td><p><span class="term"><em class="parameter"><code>target_item</code></em>:</span></p></td><td>
The target of the event.
</td></tr><tr><td><p><span class="term"><em class="parameter"><code>event</code></em>:</span></p></td><td>
The event data, with coordinates translated to canvas coordinates.
</td></tr><tr><td><p><span class="term"><em class="parameter"><code>user_param</code></em>:</span></p></td><td>the first user parameter (if any) specified
with the <a
href="../pygobject/class-gobject.html#method-gobject--connect"
><code class="methodname">connect</code>()</a>
method
</td></tr><tr><td><p><span class="term"><em class="parameter"><code>...</code></em>:</span></p></td><td>additional user parameters (if any)</td></tr><tr><td><p><span class="term"><em class="parameter"><code>Returns</code></em>:</span></p></td><td>True to stop the signal emission, or False to let it continue.</td></tr></tbody></table><p>
The "leave-notify-event" signal is emitted when the mouse leaves an item.
</p></div><div class="refsect2" title='The "motion-notify-event" goocanvas.ItemModel Signal'><a name="signal-goocanvasitemmodel--motion-notify-event"></a><h3>The "motion-notify-event" goocanvas.ItemModel Signal</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>item</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>target_item</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>event</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><em class="parameter"><code>item</code></em>:</span></p></td><td>
The <code class="classname">goocanvas.ItemModel</code>
that received the signal.
</td></tr><tr><td><p><span class="term"><em class="parameter"><code>target_item</code></em>:</span></p></td><td>
The target of the event.
</td></tr><tr><td><p><span class="term"><em class="parameter"><code>event</code></em>:</span></p></td><td>
The event data, with coordinates translated to canvas coordinates.
</td></tr><tr><td><p><span class="term"><em class="parameter"><code>user_param</code></em>:</span></p></td><td>the first user parameter (if any) specified
with the <a
href="../pygobject/class-gobject.html#method-gobject--connect"
><code class="methodname">connect</code>()</a>
method
</td></tr><tr><td><p><span class="term"><em class="parameter"><code>...</code></em>:</span></p></td><td>additional user parameters (if any)</td></tr><tr><td><p><span class="term"><em class="parameter"><code>Returns</code></em>:</span></p></td><td>True to stop the signal emission, or False to let it continue.</td></tr></tbody></table><p>
The "motion-notify-event" signal is emitted when the mouse moves within an item.
</p></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="class-canvas-item-simple.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="pygoocanvas-core-classes.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="class-canvas-item-model-simple.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">goocanvas.ItemSimple </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> goocanvas.ItemModelSimple</td></tr></table></div></body></html>
|