/usr/share/gtk-doc/html/pygtk/class-gtktreeview.html is in python-gtk2-doc 2.24.0-5.1ubuntu2.
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 312 313 314 315 316 317 318 319 320 321 322 323 324 325 326 327 328 329 330 331 332 333 334 335 336 337 338 339 340 341 342 343 344 345 346 347 348 349 350 351 352 353 354 355 356 357 358 359 360 361 362 363 364 365 366 367 368 369 370 371 372 373 374 375 376 377 378 379 380 381 382 383 384 385 386 387 388 389 390 391 392 393 394 395 396 397 398 399 400 401 402 403 404 405 406 407 408 409 410 411 412 413 414 415 416 417 418 419 420 421 422 423 424 425 426 427 428 429 430 431 432 433 434 435 436 437 438 439 440 441 442 443 444 445 446 447 448 449 450 451 452 453 454 455 456 457 458 459 460 461 462 463 464 465 466 467 468 469 470 471 472 473 474 475 476 477 478 479 480 481 482 483 484 485 486 487 488 489 490 491 492 493 494 495 496 497 498 499 500 501 502 503 504 505 506 507 508 509 510 511 512 513 514 515 516 517 518 519 520 521 522 523 524 525 526 527 528 529 530 531 532 533 534 535 536 537 538 539 540 541 542 543 544 545 546 547 548 549 550 551 552 553 554 555 556 557 558 559 560 561 562 563 564 565 566 567 568 569 570 571 572 573 574 575 576 577 578 579 580 581 582 583 584 585 586 587 588 589 590 591 592 593 594 595 596 597 598 599 600 601 602 603 604 605 606 607 608 609 610 611 612 613 614 615 616 617 618 619 620 621 622 623 624 625 626 627 628 629 630 631 632 633 634 635 636 637 638 639 640 641 642 643 644 645 646 647 648 649 650 651 652 653 654 655 656 657 658 659 660 661 662 663 664 665 666 667 668 669 670 671 672 673 674 675 676 677 678 679 680 681 682 683 684 685 686 687 688 689 690 691 692 693 694 695 696 697 698 699 700 701 702 703 704 705 706 707 708 709 710 711 712 713 714 715 | <html><head><meta http-equiv="Content-Type" content="text/html; charset=utf-8"><title>gtk.TreeView</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="PyGTK 2.0 Reference Manual"><link rel="up" href="gtk-class-reference.html" title="The gtk Class Reference"><link rel="prev" href="class-gtktreestore.html" title="gtk.TreeStore"><link rel="next" href="class-gtktreeviewcolumn.html" title="gtk.TreeViewColumn"></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">gtk.TreeView</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="class-gtktreestore.html">Prev</a> </td><th width="60%" align="center">The gtk Class Reference</th><td width="20%" align="right"> <a accesskey="n" href="class-gtktreeviewcolumn.html">Next</a></td></tr></table><hr></div><div class="refentry" title="gtk.TreeView"><a name="class-gtktreeview"></a><div class="titlepage"></div><div class="refnamediv"><h2>gtk.TreeView</h2><p>gtk.TreeView — a widget for displaying both trees and lists.</p></div><div class="refsect1" title="Synopsis"><a name="id4038867"></a><h2>Synopsis</h2><table bgcolor="#D0E0F0" width="100%"><tr><td><pre class="classsynopsis">class <span class="ooclass"><span class="classname">gtk.TreeView</span></span>(<span class="ooclass"><span class="classname"><a class="link" href="class-gtkcontainer.html" title="gtk.Container">gtk.Container</a></span></span>):
<code class="constructorsynopsis"> <span class="methodname"><a class="link" href="class-gtktreeview.html#constructor-gtktreeview" title="Constructor">gtk.TreeView</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>model</code></strong></span><span class="initializer">=None</span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtktreeview.html#method-gtktreeview--get-model" title="gtk.TreeView.get_model">get_model</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtktreeview.html#method-gtktreeview--set-model" title="gtk.TreeView.set_model">set_model</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>model</code></strong></span><span class="initializer">=None</span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtktreeview.html#method-gtktreeview--get-selection" title="gtk.TreeView.get_selection">get_selection</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtktreeview.html#method-gtktreeview--get-hadjustment" title="gtk.TreeView.get_hadjustment">get_hadjustment</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtktreeview.html#method-gtktreeview--set-hadjustment" title="gtk.TreeView.set_hadjustment">set_hadjustment</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>adjustment</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtktreeview.html#method-gtktreeview--get-vadjustment" title="gtk.TreeView.get_vadjustment">get_vadjustment</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtktreeview.html#method-gtktreeview--set-vadjustment" title="gtk.TreeView.set_vadjustment">set_vadjustment</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>adjustment</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtktreeview.html#method-gtktreeview--get-headers-visible" title="gtk.TreeView.get_headers_visible">get_headers_visible</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtktreeview.html#method-gtktreeview--set-headers-visible" title="gtk.TreeView.set_headers_visible">set_headers_visible</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>headers_visible</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtktreeview.html#method-gtktreeview--columns-autosize" title="gtk.TreeView.columns_autosize">columns_autosize</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtktreeview.html#method-gtktreeview--set-headers-clickable" title="gtk.TreeView.set_headers_clickable">set_headers_clickable</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>active</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtktreeview.html#method-gtktreeview--set-rules-hint" title="gtk.TreeView.set_rules_hint">set_rules_hint</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>setting</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtktreeview.html#method-gtktreeview--get-rules-hint" title="gtk.TreeView.get_rules_hint">get_rules_hint</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtktreeview.html#method-gtktreeview--append-column" title="gtk.TreeView.append_column">append_column</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>column</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtktreeview.html#method-gtktreeview--remove-column" title="gtk.TreeView.remove_column">remove_column</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>column</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtktreeview.html#method-gtktreeview--insert-column" title="gtk.TreeView.insert_column">insert_column</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>column</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"><a class="link" href="class-gtktreeview.html#method-gtktreeview--insert-column-with-attributes" title="gtk.TreeView.insert_column_with_attributes">insert_column_with_attributes</a></span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>position</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>title</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>cell</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtktreeview.html#method-gtktreeview--insert-column-with-data-func" title="gtk.TreeView.insert_column_with_data_func">insert_column_with_data_func</a></span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>position</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>title</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>cell</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>func</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>data</code></em></span><span class="initializer">=None</span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtktreeview.html#method-gtktreeview--get-column" title="gtk.TreeView.get_column">get_column</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>n</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtktreeview.html#method-gtktreeview--get-columns" title="gtk.TreeView.get_columns">get_columns</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtktreeview.html#method-gtktreeview--move-column-after" title="gtk.TreeView.move_column_after">move_column_after</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>column</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>base_column</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtktreeview.html#method-gtktreeview--set-expander-column" title="gtk.TreeView.set_expander_column">set_expander_column</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>column</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtktreeview.html#method-gtktreeview--get-expander-column" title="gtk.TreeView.get_expander_column">get_expander_column</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtktreeview.html#method-gtktreeview--set-column-drag-function" title="gtk.TreeView.set_column_drag_function">set_column_drag_function</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>func</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>user_data</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtktreeview.html#method-gtktreeview--scroll-to-point" title="gtk.TreeView.scroll_to_point">scroll_to_point</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>tree_x</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>tree_y</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtktreeview.html#method-gtktreeview--scroll-to-cell" title="gtk.TreeView.scroll_to_cell">scroll_to_cell</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>path</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>column</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>use_align</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>row_align</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>col_align</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtktreeview.html#method-gtktreeview--row-activated" title="gtk.TreeView.row_activated">row_activated</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>path</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>column</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtktreeview.html#method-gtktreeview--expand-all" title="gtk.TreeView.expand_all">expand_all</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtktreeview.html#method-gtktreeview--collapse-all" title="gtk.TreeView.collapse_all">collapse_all</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtktreeview.html#method-gtktreeview--expand-to-path" title="gtk.TreeView.expand_to_path">expand_to_path</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>path</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtktreeview.html#method-gtktreeview--expand-row" title="gtk.TreeView.expand_row">expand_row</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>path</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>open_all</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtktreeview.html#method-gtktreeview--collapse-row" title="gtk.TreeView.collapse_row">collapse_row</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>path</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtktreeview.html#method-gtktreeview--map-expanded-rows" title="gtk.TreeView.map_expanded_rows">map_expanded_rows</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>func</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>data</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtktreeview.html#method-gtktreeview--row-expanded" title="gtk.TreeView.row_expanded">row_expanded</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>path</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtktreeview.html#method-gtktreeview--set-reorderable" title="gtk.TreeView.set_reorderable">set_reorderable</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>reorderable</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtktreeview.html#method-gtktreeview--get-reorderable" title="gtk.TreeView.get_reorderable">get_reorderable</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtktreeview.html#method-gtktreeview--set-cursor" title="gtk.TreeView.set_cursor">set_cursor</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>path</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>focus_column</code></strong></span><span class="initializer">=None</span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>start_editing</code></strong></span><span class="initializer">=False</span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtktreeview.html#method-gtktreeview--set-cursor-on-cell" title="gtk.TreeView.set_cursor_on_cell">set_cursor_on_cell</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>path</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>focus_column</code></strong></span><span class="initializer">=None</span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>focus_cell</code></strong></span><span class="initializer">=None</span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>start_editing</code></strong></span><span class="initializer">=False</span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtktreeview.html#method-gtktreeview--get-cursor" title="gtk.TreeView.get_cursor">get_cursor</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtktreeview.html#method-gtktreeview--get-bin-window" title="gtk.TreeView.get_bin_window">get_bin_window</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtktreeview.html#method-gtktreeview--get-path-at-pos" title="gtk.TreeView.get_path_at_pos">get_path_at_pos</a></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>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtktreeview.html#method-gtktreeview--get-cell-area" title="gtk.TreeView.get_cell_area">get_cell_area</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>path</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>column</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtktreeview.html#method-gtktreeview--get-background-area" title="gtk.TreeView.get_background_area">get_background_area</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>path</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>column</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtktreeview.html#method-gtktreeview--get-visible-rect" title="gtk.TreeView.get_visible_rect">get_visible_rect</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtktreeview.html#method-gtktreeview--widget-to-tree-coords" title="gtk.TreeView.widget_to_tree_coords">widget_to_tree_coords</a></span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>wx</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>wy</code></em></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtktreeview.html#method-gtktreeview--tree-to-widget-coords" title="gtk.TreeView.tree_to_widget_coords">tree_to_widget_coords</a></span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>tx</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>ty</code></em></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtktreeview.html#method-gtktreeview--enable-model-drag-source" title="gtk.TreeView.enable_model_drag_source">enable_model_drag_source</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>start_button_mask</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>targets</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>actions</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtktreeview.html#method-gtktreeview--enable-model-drag-dest" title="gtk.TreeView.enable_model_drag_dest">enable_model_drag_dest</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>targets</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>actions</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtktreeview.html#method-gtktreeview--unset-rows-drag-source" title="gtk.TreeView.unset_rows_drag_source">unset_rows_drag_source</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtktreeview.html#method-gtktreeview--unset-rows-drag-dest" title="gtk.TreeView.unset_rows_drag_dest">unset_rows_drag_dest</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtktreeview.html#method-gtktreeview--set-drag-dest-row" title="gtk.TreeView.set_drag_dest_row">set_drag_dest_row</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>path</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>pos</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtktreeview.html#method-gtktreeview--get-drag-dest-row" title="gtk.TreeView.get_drag_dest_row">get_drag_dest_row</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtktreeview.html#method-gtktreeview--get-dest-row-at-pos" title="gtk.TreeView.get_dest_row_at_pos">get_dest_row_at_pos</a></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>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtktreeview.html#method-gtktreeview--create-row-drag-icon" title="gtk.TreeView.create_row_drag_icon">create_row_drag_icon</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>path</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtktreeview.html#method-gtktreeview--set-enable-search" title="gtk.TreeView.set_enable_search">set_enable_search</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>enable_search</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtktreeview.html#method-gtktreeview--get-enable-search" title="gtk.TreeView.get_enable_search">get_enable_search</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtktreeview.html#method-gtktreeview--get-search-column" title="gtk.TreeView.get_search_column">get_search_column</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtktreeview.html#method-gtktreeview--set-search-column" title="gtk.TreeView.set_search_column">set_search_column</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>column</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtktreeview.html#method-gtktreeview--set-search-equal-func" title="gtk.TreeView.set_search_equal_func">set_search_equal_func</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>func</code></strong></span><span class="initializer">=None</span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>user_data</code></strong></span><span class="initializer">=None</span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtktreeview.html#method-gtktreeview--get-fixed-height-mode" title="gtk.TreeView.get_fixed_height_mode">get_fixed_height_mode</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtktreeview.html#method-gtktreeview--set-fixed-height-mode" title="gtk.TreeView.set_fixed_height_mode">set_fixed_height_mode</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>enable</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtktreeview.html#method-gtktreeview--get-hover-selection" title="gtk.TreeView.get_hover_selection">get_hover_selection</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtktreeview.html#method-gtktreeview--set-hover-selection" title="gtk.TreeView.set_hover_selection">set_hover_selection</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>hover</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtktreeview.html#method-gtktreeview--get-hover-expand" title="gtk.TreeView.get_hover_expand">get_hover_expand</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtktreeview.html#method-gtktreeview--set-hover-expand" title="gtk.TreeView.set_hover_expand">set_hover_expand</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>expand</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtktreeview.html#method-gtktreeview--set-row-separator-func" title="gtk.TreeView.set_row_separator_func">set_row_separator_func</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>func</code></strong></span><span class="initializer">=None</span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>user_data</code></strong></span><span class="initializer">=None</span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtktreeview.html#method-gtktreeview--get-visible-range" title="gtk.TreeView.get_visible_range">get_visible_range</a></span>()</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtktreeview.html#method-gtktreeview--get-headers-clickable" title="gtk.TreeView.get_headers_clickable">get_headers_clickable</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtktreeview.html#method-gtktreeview--get-search-entry" title="gtk.TreeView.get_search_entry">get_search_entry</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtktreeview.html#method-gtktreeview--set-search-entry" title="gtk.TreeView.set_search_entry">set_search_entry</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>entry</code></strong></span><span class="initializer">=None</span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtktreeview.html#method-gtktreeview--set-search-position-func" title="gtk.TreeView.set_search_position_func">set_search_position_func</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>func</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>data</code></strong></span><span class="initializer">=None</span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtktreeview.html#method-gtktreeview--set-rubber-banding" title="gtk.TreeView.set_rubber_banding">set_rubber_banding</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>enable</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtktreeview.html#method-gtktreeview--get-rubber-banding" title="gtk.TreeView.get_rubber_banding">get_rubber_banding</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtktreeview.html#method-gtktreeview--get-grid-lines" title="gtk.TreeView.get_grid_lines">get_grid_lines</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtktreeview.html#method-gtktreeview--set-grid-lines" title="gtk.TreeView.set_grid_lines">set_grid_lines</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>grid_lines</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtktreeview.html#method-gtktreeview--get-enable-tree-lines" title="gtk.TreeView.get_enable_tree_lines">get_enable_tree_lines</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtktreeview.html#method-gtktreeview--set-enable-tree-lines" title="gtk.TreeView.set_enable_tree_lines">set_enable_tree_lines</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>enabled</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtktreeview.html#method-gtktreeview--convert-widget-to-bin-window-coords" title="gtk.TreeView.convert_widget_to_bin_window_coords">convert_widget_to_bin_window_coords</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>widget_x</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>widget_y</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtktreeview.html#method-gtktreeview--convert-widget-to-tree-coords" title="gtk.TreeView.convert_widget_to_tree_coords">convert_widget_to_tree_coords</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>widget_x</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>widget_y</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtktreeview.html#method-gtktreeview--convert-tree-to-widget-coords" title="gtk.TreeView.convert_tree_to_widget_coords">convert_tree_to_widget_coords</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>tree_x</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>tree_y</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtktreeview.html#method-gtktreeview--convert-tree-to-bin-window-coords" title="gtk.TreeView.convert_tree_to_bin_window_coords">convert_tree_to_bin_window_coords</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>tree_x</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>tree_y</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtktreeview.html#method-gtktreeview--convert-bin-window-to-widget-coords" title="gtk.TreeView.convert_bin_window_to_widget_coords">convert_bin_window_to_widget_coords</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>window_x</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>window_y</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtktreeview.html#method-gtktreeview--convert-bin-window-to-tree-coords" title="gtk.TreeView.convert_bin_window_to_tree_coords">convert_bin_window_to_tree_coords</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>window_x</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>window_y</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtktreeview.html#method-gtktreeview--get-level-indentation" title="gtk.TreeView.get_level_indentation">get_level_indentation</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtktreeview.html#method-gtktreeview--set-level-indentation" title="gtk.TreeView.set_level_indentation">set_level_indentation</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>indentation</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtktreeview.html#method-gtktreeview--get-show-expanders" title="gtk.TreeView.get_show_expanders">get_show_expanders</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtktreeview.html#method-gtktreeview--set-show-expanders" title="gtk.TreeView.set_show_expanders">set_show_expanders</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>enabled</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtktreeview.html#method-gtktreeview--get-tooltip-column" title="gtk.TreeView.get_tooltip_column">get_tooltip_column</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtktreeview.html#method-gtktreeview--set-tooltip-column" title="gtk.TreeView.set_tooltip_column">set_tooltip_column</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>column</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtktreeview.html#method-gtktreeview--is-rubber-banding-active" title="gtk.TreeView.is_rubber_banding_active">is_rubber_banding_active</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtktreeview.html#method-gtktreeview--set-tooltip-cell" title="gtk.TreeView.set_tooltip_cell">set_tooltip_cell</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>tooltip</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>path</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>column</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>cell</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtktreeview.html#method-gtktreeview--set-tooltip-row" title="gtk.TreeView.set_tooltip_row">set_tooltip_row</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>tooltip</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>path</code></strong></span></span>)</code><br></pre></td></tr></table></div><div class="refsect1" title="Ancestry"><a name="id4041896"></a><h2>Ancestry</h2><pre class="synopsis">+-- <PYGTKDOCLINK HREF="class-gobject">gobject.GObject</PYGTKDOCLINK>
+-- <a class="link" href="class-gtkobject.html" title="gtk.Object">gtk.Object</a>
+-- <a class="link" href="class-gtkwidget.html" title="gtk.Widget">gtk.Widget</a>
+-- <a class="link" href="class-gtkcontainer.html" title="gtk.Container">gtk.Container</a>
+-- <a class="link" href="class-gtktreeview.html" title="gtk.TreeView">gtk.TreeView</a>
</pre></div><div class="refsect1" title="Implemented Interfaces"><a name="id4041941"></a><h2>Implemented Interfaces</h2><p>
<a class="link" href="class-gtktreeview.html" title="gtk.TreeView"><code class="classname">gtk.TreeView</code></a>
implements
<a class="link" href="class-gtkbuildable.html" title="gtk.Buildable"><code class="classname">gtk.Buildable</code></a>
</p></div><div class="refsect1" title="gtk.TreeView Properties"><a name="properties-gtktreeview"></a><h2>gtk.TreeView Properties</h2><p><a class="link" href="class-gtkobject.html#properties-gtkobject" title="gtk.Object Properties">gtk.Object Properties</a></p><p><a class="link" href="class-gtkwidget.html#properties-gtkwidget" title="gtk.Widget Properties">gtk.Widget Properties</a></p><p><a class="link" href="class-gtkcontainer.html#properties-gtkcontainer" title="gtk.Container Properties">gtk.Container Properties</a></p><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="4in"></colgroup><tbody><tr valign="top"><td valign="top">"enable-grid-lines"</td><td valign="top">Read-Write</td><td valign="top">If <code class="literal">True</code> grid lines should be drawn
in the tree view</td></tr><tr valign="top"><td valign="top">"enable-search"</td><td valign="top">Read-Write</td><td valign="top">If <code class="literal">True</code>, the user can search through
columns interactively. Default value: <code class="literal">True</code></td></tr><tr valign="top"><td valign="top">"enable-tree-lines"</td><td valign="top">Read-Write</td><td valign="top">If <code class="literal">True</code> tree lines should be drawn
in the tree view</td></tr><tr valign="top"><td valign="top">"expander-column"</td><td valign="top">Read-Write</td><td valign="top">The column for the expander</td></tr><tr valign="top"><td valign="top">"fixed-height-mode"</td><td valign="top">Read-Write</td><td valign="top">If <code class="literal">True</code>, assume all rows have the
same height thereby speeding up display. Default value:
<code class="literal">False</code>. Available in GTK+ 2.4 and above.</td></tr><tr valign="top"><td valign="top">"hadjustment"</td><td valign="top">Read-Write</td><td valign="top">The horizontal Adjustment for the widget</td></tr><tr valign="top"><td valign="top">"headers-clickable"</td><td valign="top">Write</td><td valign="top">If <code class="literal">True</code>, the column headers respond
to click events. Default value: <code class="literal">False</code></td></tr><tr valign="top"><td valign="top">"headers-visible"</td><td valign="top">Read-Write</td><td valign="top">If <code class="literal">True</code>, show the column header
buttons. Default value: <code class="literal">True</code></td></tr><tr valign="top"><td valign="top">"hover-expand"</td><td valign="top">Read-Write</td><td valign="top">If <code class="literal">True</code>, rows expand or collapse if
the pointer moves over them. This mode is primarily intended for treeviews
in popups, e.g. in <a class="link" href="class-gtkcombobox.html" title="gtk.ComboBox"><code class="classname">gtk.ComboBox</code></a> or
<a class="link" href="class-gtkentrycompletion.html" title="gtk.EntryCompletion"><code class="classname">gtk.EntryCompletion</code></a>. Default
value: <code class="literal">False</code>. Available in GTK+ 2.6 and above.</td></tr><tr valign="top"><td valign="top">"hover-selection"</td><td valign="top">Read-Write</td><td valign="top">If <code class="literal">True</code>, the selected row follows
the pointer. Currently, this works only for the selection modes
<code class="literal">gtk.SELECTION_SINGLE</code> and
<code class="literal">gtk.SELECTION_BROWSE</code>. This mode is primarily intended for
treeviews in popups, e.g. in <a class="link" href="class-gtkcombobox.html" title="gtk.ComboBox"><code class="classname">gtk.ComboBox</code></a> or
<a class="link" href="class-gtkentrycompletion.html" title="gtk.EntryCompletion"><code class="classname">gtk.EntryCompletion</code></a>. Default
value: <code class="literal">False</code>. Available in GTK+ 2.6 and above.</td></tr><tr valign="top"><td valign="top">"level-indentation"</td><td valign="top">Read-Write</td><td valign="top">Extra indentation for each level</td></tr><tr valign="top"><td valign="top">"model"</td><td valign="top">Read-Write</td><td valign="top">The model for the tree view</td></tr><tr valign="top"><td valign="top">"reorderable"</td><td valign="top">Read-Write</td><td valign="top">If <code class="literal">True</code>, the view is
reorderable. Default value: <code class="literal">False</code>.</td></tr><tr valign="top"><td valign="top">"rubber-banding"</td><td valign="top">Read-Write</td><td valign="top">If <code class="literal">True</code> enable selection of multiple
items by dragging the mouse pointer</td></tr><tr valign="top"><td valign="top">"rules-hint"</td><td valign="top">Read-Write</td><td valign="top">If <code class="literal">True</code>, hint to the theme engine to
draw rows in alternating colors. Default value:
<code class="literal">False</code>.</td></tr><tr valign="top"><td valign="top">"search-column"</td><td valign="top">Read-Write</td><td valign="top">The model column to search when searching through
code. Allowed values: >= -1. Default value: -1</td></tr><tr valign="top"><td valign="top">"show-expanders"</td><td valign="top">Read-Write</td><td valign="top">View has expanders</td></tr><tr valign="top"><td valign="top">"vadjustment"</td><td valign="top">Read-Write</td><td valign="top">The vertical Adjustment for the widget</td></tr></tbody></table></div></td></tr></table></div></div><div class="refsect1" title="gtk.TreeView Style Properties"><a name="style-properties-gtktreeview"></a><h2>gtk.TreeView Style 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="4in"></colgroup><tbody><tr valign="top"><td valign="top">"allow-rules"</td><td valign="top">Read</td><td valign="top">If <code class="literal">True</code>, allow drawing of
alternating color rows. Default value: <code class="literal">True</code></td></tr><tr valign="top"><td valign="top">"even-row-color"</td><td valign="top">Read</td><td valign="top">The <a class="link" href="class-gdkcolor.html" title="gtk.gdk.Color"><code class="classname">gtk.gdk.Color</code></a>
to use for even rows. Available in GTK+ 2.2 and above.</td></tr><tr valign="top"><td valign="top">"expander-size"</td><td valign="top">Read</td><td valign="top">The size of the expander arrow. Allowed values: >= 0.
Default value: 12</td></tr><tr valign="top"><td valign="top">"grid-line-pattern"</td><td valign="top">Read</td><td valign="top">Dash pattern used to draw the tree view grid lines</td></tr><tr valign="top"><td valign="top">"grid-line-width"</td><td valign="top">Read</td><td valign="top">Width, in pixels, of the tree view grid lines</td></tr><tr valign="top"><td valign="top">"horizontal-separator"</td><td valign="top">Read</td><td valign="top">The horizontal space between cells. Must be an even
number. Allowed values: >= 0. Default value: 2</td></tr><tr valign="top"><td valign="top">"indent-expanders"</td><td valign="top">Read</td><td valign="top">If <code class="literal">True</code>, the expanders are
indented.</td></tr><tr valign="top"><td valign="top">"odd-row-color"</td><td valign="top">Read</td><td valign="top">The <a class="link" href="class-gdkcolor.html" title="gtk.gdk.Color"><code class="classname">gtk.gdk.Color</code></a>
to use for odd rows. Available in GTK+ 2.2 and above.</td></tr><tr valign="top"><td valign="top">"row-ending-details"</td><td valign="top">Read</td><td valign="top">Enable extended row background theming</td></tr><tr valign="top"><td valign="top">"tree-line-pattern"</td><td valign="top">Read</td><td valign="top">Dash pattern used to draw the tree view lines</td></tr><tr valign="top"><td valign="top">"tree-line-width"</td><td valign="top">Read</td><td valign="top">Width, in pixels, of the tree view lines</td></tr><tr valign="top"><td valign="top">"vertical-separator"</td><td valign="top">Read</td><td valign="top">The vertical space between cells. Must be an even
number. Allowed values: >= 0. Default value: 2</td></tr></tbody></table></div></td></tr></table></div></div><div class="refsect1" title="gtk.TreeView Signal Prototypes"><a name="signal-prototypes-gtktreeview"></a><h2>gtk.TreeView Signal Prototypes</h2><p><PYGTKDOCLINK HREF="signal-prototypes-gobject">gobject.GObject Signal Prototypes</PYGTKDOCLINK></p><p><a class="link" href="class-gtkobject.html#signal-prototypes-gtkobject" title="gtk.Object Signal Prototypes">gtk.Object Signal Prototypes</a></p><p><a class="link" href="class-gtkwidget.html#signal-prototypes-gtkwidget" title="gtk.Widget Signal Prototypes">gtk.Widget Signal Prototypes</a></p><p><a class="link" href="class-gtkcontainer.html#signal-prototypes-gtkcontainer" title="gtk.Container Signal Prototypes">gtk.Container Signal Prototypes</a></p><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term">"<a class="link" href="class-gtktreeview.html#signal-gtktreeview--columns-changed" title='The "columns-changed" gtk.TreeView Signal'>columns-changed</a>"</span></p></td><td><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>treeview</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</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">"<a class="link" href="class-gtktreeview.html#signal-gtktreeview--cursor-changed" title='The "cursor-changed" gtk.TreeView Signal'>cursor-changed</a>"</span></p></td><td><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>treeview</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</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">"<a class="link" href="class-gtktreeview.html#signal-gtktreeview--expand-collapse-cursor-row" title='The "expand-collapse-cursor-row" gtk.TreeView Signal'>expand-collapse-cursor-row</a>"</span></p></td><td><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>treeview</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>logical</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>expand</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>open_all</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</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">"<a class="link" href="class-gtktreeview.html#signal-gtktreeview--move-cursor" title='The "move-cursor" gtk.TreeView Signal'>move-cursor</a>"</span></p></td><td><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>treeview</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>step</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>count</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</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">"<a class="link" href="class-gtktreeview.html#signal-gtktreeview--row-activated" title='The "row-activated" gtk.TreeView Signal'>row-activated</a>"</span></p></td><td><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>treeview</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>path</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>view_column</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</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">"<a class="link" href="class-gtktreeview.html#signal-gtktreeview--row-collapsed" title='The "row-collapsed" gtk.TreeView Signal'>row-collapsed</a>"</span></p></td><td><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>treeview</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>iter</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>path</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</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">"<a class="link" href="class-gtktreeview.html#signal-gtktreeview--row-expanded" title='The "row-expanded" gtk.TreeView Signal'>row-expanded</a>"</span></p></td><td><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>treeview</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>iter</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>path</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</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">"<a class="link" href="class-gtktreeview.html#signal-gtktreeview--select-all" title='The "select-all" gtk.TreeView Signal'>select-all</a>"</span></p></td><td><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>treeview</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</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">"<a class="link" href="class-gtktreeview.html#signal-gtktreeview--select-cursor-parent" title='The "select-cursor-parent" gtk.TreeView Signal'>select-cursor-parent</a>"</span></p></td><td><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>treeview</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</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">"<a class="link" href="class-gtktreeview.html#signal-gtktreeview--select-cursor-row" title='The "select-cursor-row" gtk.TreeView Signal'>select-cursor-row</a>"</span></p></td><td><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>treeview</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>start_editing</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</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">"<a class="link" href="class-gtktreeview.html#signal-gtktreeview--set-scroll-adjustments" title='The "set-scroll-adjustments" gtk.TreeView Signal'>set-scroll-adjustments</a>"</span></p></td><td><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>treeview</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>hadjustment</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>vadjustment</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</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">"<a class="link" href="class-gtktreeview.html#signal-gtktreeview--start-interactive-search" title='The "start-interactive-search" gtk.TreeView Signal'>start-interactive-search</a>"</span></p></td><td><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>treeview</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</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">"<a class="link" href="class-gtktreeview.html#signal-gtktreeview--test-collapse-row" title='The "test-collapse-row" gtk.TreeView Signal'>test-collapse-row</a>"</span></p></td><td><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>treeview</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>iter</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>path</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</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">"<a class="link" href="class-gtktreeview.html#signal-gtktreeview--test-expand-row" title='The "test-expand-row" gtk.TreeView Signal'>test-expand-row</a>"</span></p></td><td><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>treeview</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>iter</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>path</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</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">"<a class="link" href="class-gtktreeview.html#signal-gtktreeview--toggle-cursor-row" title='The "toggle-cursor-row" gtk.TreeView Signal'>toggle-cursor-row</a>"</span></p></td><td><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>treeview</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</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">"<a class="link" href="class-gtktreeview.html#signal-gtktreeview--unselect-all" title='The "unselect-all" gtk.TreeView Signal'>unselect-all</a>"</span></p></td><td><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>treeview</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</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="Description"><a name="id4044082"></a><h2>Description</h2><p>A <a class="link" href="class-gtktreeview.html" title="gtk.TreeView"><code class="classname">gtk.TreeView</code></a>
widget is used to display the contents of any model implementing the <a class="link" href="class-gtktreemodel.html" title="gtk.TreeModel"><code class="classname">gtk.TreeModel</code></a>
interface. The tree models provided standard with <code class="literal">GTK+</code>
and <code class="literal">PyGTK</code> are:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><a class="link" href="class-gtkliststore.html" title="gtk.ListStore"><code class="classname">gtk.ListStore</code></a></li><li class="listitem"><a class="link" href="class-gtktreestore.html" title="gtk.TreeStore"><code class="classname">gtk.TreeStore</code></a></li><li class="listitem"><a class="link" href="class-gtktreemodelsort.html" title="gtk.TreeModelSort"><code class="classname">gtk.TreeModelSort</code></a></li></ul></div><p>In addition, <code class="literal">PyGTK</code> provides <a class="link" href="class-pygtkgenerictreemodel.html" title="gtk.GenericTreeModel"><code class="classname">gtk.GenericTreeModel</code></a>
that allows you to create your own tree model entirely in Python.</p><p>The <a class="link" href="class-gtktreeview.html" title="gtk.TreeView"><code class="classname">gtk.TreeView</code></a> uses
columns and cell renderers to actually display the model information.
<code class="literal">GTK+</code> and <code class="literal">PyGTK</code> provides the <a class="link" href="class-gtktreeviewcolumn.html" title="gtk.TreeViewColumn"><code class="classname">gtk.TreeViewColumn</code></a>
to manage the display of a column and the following cell renderers:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><a class="link" href="class-gtkcellrendererpixbuf.html" title="gtk.CellRendererPixbuf"><code class="classname">gtk.CellRendererPixbuf</code></a></li><li class="listitem"><a class="link" href="class-gtkcellrenderertext.html" title="gtk.CellRendererText"><code class="classname">gtk.CellRendererText</code></a></li><li class="listitem"><a class="link" href="class-gtkcellrenderertoggle.html" title="gtk.CellRendererToggle"><code class="classname">gtk.CellRendererToggle</code></a></li></ul></div><p>In addition, <code class="literal">PyGTK</code> provides the <a class="link" href="class-pygtkgenericcellrenderer.html" title="gtk.GenericCellRenderer"><code class="classname">gtk.GenericCellRenderer</code></a>
that allows you to create your own cell renderers entirely in Python.</p></div><div class="refsect1" title="Constructor"><a name="constructor-gtktreeview"></a><h2>Constructor</h2><pre class="programlisting"><code class="constructorsynopsis"> <span class="methodname">gtk.TreeView</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>model</code></strong></span><span class="initializer">=None</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>the tree model to display</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>A new <a class="link" href="class-gtktreeview.html" title="gtk.TreeView"><code class="classname">gtk.TreeView</code></a>
widget.</td></tr></tbody></table><p>Creates a new <a class="link" href="class-gtktreeview.html" title="gtk.TreeView"><code class="classname">gtk.TreeView</code></a>
widget displaying the model specified by <em class="parameter"><code>model</code></em>.</p></div><div class="refsect1" title="Methods"><a name="id4044378"></a><h2>Methods</h2><div class="refsect2" title="gtk.TreeView.get_model"><a name="method-gtktreeview--get-model"></a><h3>gtk.TreeView.get_model</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_model</span>(<span class="methodparam"></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 current <a class="link" href="class-gtktreemodel.html" title="gtk.TreeModel"><code class="classname">gtk.TreeModel</code></a>, or
<code class="literal">None</code> if none is currently being
used.</td></tr></tbody></table><p>The <code class="methodname">get_model</code>() method returns the
value of the "model" property containing the model the <a class="link" href="class-gtktreeview.html" title="gtk.TreeView"><code class="classname">gtk.TreeView</code></a> is
displaying or <code class="literal">None</code> there is no the model.</p></div><div class="refsect2" title="gtk.TreeView.set_model"><a name="method-gtktreeview--set-model"></a><h3>gtk.TreeView.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 class="initializer">=None</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>the new tree model to use with the
treeview</td></tr></tbody></table><p>The <code class="methodname">set_model</code>() method sets the "model"
property for the treeview to the value of <em class="parameter"><code>model</code></em>. If
the treeview already has a model set, this method will remove it before
setting the new model. If <em class="parameter"><code>model</code></em> is
<code class="literal">None</code>, it will unset the old model.</p></div><div class="refsect2" title="gtk.TreeView.get_selection"><a name="method-gtktreeview--get-selection"></a><h3>gtk.TreeView.get_selection</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_selection</span>(<span class="methodparam"></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 <a class="link" href="class-gtktreeselection.html" title="gtk.TreeSelection"><code class="classname">gtk.TreeSelection</code></a>
object.</td></tr></tbody></table><p>The <code class="methodname">get_selection</code>() method returns the
current <a class="link" href="class-gtktreeselection.html" title="gtk.TreeSelection"><code class="classname">gtk.TreeSelection</code></a>
associated with the treeview.</p></div><div class="refsect2" title="gtk.TreeView.get_hadjustment"><a name="method-gtktreeview--get-hadjustment"></a><h3>gtk.TreeView.get_hadjustment</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_hadjustment</span>(<span class="methodparam"></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 <a class="link" href="class-gtkadjustment.html" title="gtk.Adjustment"><code class="classname">gtk.Adjustment</code></a>
object, or <code class="literal">None</code> if none is currently being
used.</td></tr></tbody></table><p>The <code class="methodname">get_hadjustment</code>() method returns
the value of the "hadjustment" property that contains the current horizontal
<a class="link" href="class-gtkadjustment.html" title="gtk.Adjustment"><code class="classname">gtk.Adjustment</code></a>
object or <code class="literal">None</code> (if no horizontal adjustment is being
used).</p></div><div class="refsect2" title="gtk.TreeView.set_hadjustment"><a name="method-gtktreeview--set-hadjustment"></a><h3>gtk.TreeView.set_hadjustment</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_hadjustment</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>adjustment</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>adjustment</code></strong> :</span></p></td><td>the <a class="link" href="class-gtkadjustment.html" title="gtk.Adjustment"><code class="classname">gtk.Adjustment</code></a>
to set</td></tr></tbody></table><p>The <code class="methodname">set_hadjustment</code>() method sets the
"hadjustment" property to the value of <em class="parameter"><code>adjustment</code></em>
that must be a <a class="link" href="class-gtkadjustment.html" title="gtk.Adjustment"><code class="classname">gtk.Adjustment</code></a>
object.</p></div><div class="refsect2" title="gtk.TreeView.get_vadjustment"><a name="method-gtktreeview--get-vadjustment"></a><h3>gtk.TreeView.get_vadjustment</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_vadjustment</span>(<span class="methodparam"></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 <a class="link" href="class-gtkadjustment.html" title="gtk.Adjustment"><code class="classname">gtk.Adjustment</code></a>
object, or <code class="literal">None</code> if none is currently being
used.</td></tr></tbody></table><p>The <code class="methodname">get_vadjustment</code>() method returns
the value of the "vadjustment" property that contains the horizontal <a class="link" href="class-gtkadjustment.html" title="gtk.Adjustment"><code class="classname">gtk.Adjustment</code></a>
or None if there is no vertical adjustment.</p></div><div class="refsect2" title="gtk.TreeView.set_vadjustment"><a name="method-gtktreeview--set-vadjustment"></a><h3>gtk.TreeView.set_vadjustment</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_vadjustment</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>adjustment</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>adjustment</code></strong> :</span></p></td><td>the <a class="link" href="class-gtkadjustment.html" title="gtk.Adjustment"><code class="classname">gtk.Adjustment</code></a>
to set</td></tr></tbody></table><p>The <code class="methodname">set_vadjustment</code>() method sets the
"vadjustment" property to the value of <em class="parameter"><code>adjustment</code></em>.
The new <a class="link" href="class-gtkadjustment.html" title="gtk.Adjustment"><code class="classname">gtk.Adjustment</code></a>
replaces the current vertical adjustment.</p></div><div class="refsect2" title="gtk.TreeView.get_headers_visible"><a name="method-gtktreeview--get-headers-visible"></a><h3>gtk.TreeView.get_headers_visible</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_headers_visible</span>(<span class="methodparam"></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><code class="literal">True</code> if the headers are
visible.</td></tr></tbody></table><p>The <code class="methodname">get_headers_visible</code>() method
returns the value of the "headers-visible" property. If "headers-visible" is
<code class="literal">True</code> the headers on the treeview are visible.</p></div><div class="refsect2" title="gtk.TreeView.set_headers_visible"><a name="method-gtktreeview--set-headers-visible"></a><h3>gtk.TreeView.set_headers_visible</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_headers_visible</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>headers_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>headers_visible</code></strong> :</span></p></td><td>if <code class="literal">True</code> the headers are
visible</td></tr></tbody></table><p>The <code class="methodname">set_headers_visible</code>() method sets
the "headers-visible" property to the value of
<em class="parameter"><code>headers_visible</code></em>. If
<em class="parameter"><code>headers_visible</code></em> is <code class="literal">True</code> the
headers will be displayed.</p></div><div class="refsect2" title="gtk.TreeView.columns_autosize"><a name="method-gtktreeview--columns-autosize"></a><h3>gtk.TreeView.columns_autosize</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">columns_autosize</span>(<span class="methodparam"></span>)</code></pre><p>The <code class="methodname">columns_autosize</code>() method resizes
all columns to their optimal width. Only works after the treeview has been
realized.</p></div><div class="refsect2" title="gtk.TreeView.set_headers_clickable"><a name="method-gtktreeview--set-headers-clickable"></a><h3>gtk.TreeView.set_headers_clickable</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_headers_clickable</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>active</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>active</code></strong> :</span></p></td><td>if <code class="literal">True</code> the headers are
clickable</td></tr></tbody></table><p>The <code class="methodname">set_headers_clickable</code>() method sets
the "headers-clickable" property to the value of
<em class="parameter"><code>active</code></em>. If <em class="parameter"><code>active</code></em> is
<code class="literal">True</code> the column title buttons can be clicked.</p></div><div class="refsect2" title="gtk.TreeView.set_rules_hint"><a name="method-gtktreeview--set-rules-hint"></a><h3>gtk.TreeView.set_rules_hint</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_rules_hint</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>setting</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>setting</code></strong> :</span></p></td><td>if <code class="literal">True</code> the tree requires
reading across rows</td></tr></tbody></table><p>The <code class="methodname">set_rules_hint</code>() method sets the
"rules-hint" property to the value of <em class="parameter"><code>setting</code></em>. If
<em class="parameter"><code>setting</code></em> is <code class="literal">True</code> it indicates that
the user interface for your application requires users to read across tree
rows and associate cells with one another. By default, the tree will be
rendered with alternating row colors. Do <span class="emphasis"><em>not</em></span> use it
just because you prefer the appearance of the ruled tree; that's a question
for the theme. Some themes will draw tree rows in alternating colors even
when rules are turned off, and users who prefer that appearance all the time
can choose those themes. You should call this method only as a
<span class="emphasis"><em>semantic</em></span> hint to the theme engine that your tree makes
alternating colors useful from a functional standpoint (since it has lots of
columns, generally).</p></div><div class="refsect2" title="gtk.TreeView.get_rules_hint"><a name="method-gtktreeview--get-rules-hint"></a><h3>gtk.TreeView.get_rules_hint</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_rules_hint</span>(<span class="methodparam"></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><code class="literal">True</code> if rules are useful for
the user of this tree</td></tr></tbody></table><p>The <code class="methodname">get_rules_hint</code>() returns the value
of the "rules-hint" property. See the <a class="link" href="class-gtktreeview.html#method-gtktreeview--set-rules-hint" title="gtk.TreeView.set_rules_hint"><code class="methodname">set_rules_hint</code>()</a>
method for more information on the use of "rules-hint".</p></div><div class="refsect2" title="gtk.TreeView.append_column"><a name="method-gtktreeview--append-column"></a><h3>gtk.TreeView.append_column</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">append_column</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>column</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>column</code></strong> :</span></p></td><td>the <a class="link" href="class-gtktreeviewcolumn.html" title="gtk.TreeViewColumn"><code class="classname">gtk.TreeViewColumn</code></a>
to add.</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>the number of columns in
<em class="parameter"><code>tree_view</code></em> after appending.</td></tr></tbody></table><p>The <code class="methodname">append_column</code>() method appends the
specified <em class="parameter"><code>column</code></em> to the list of columns and returns
the new number of columns in the treeview.</p></div><div class="refsect2" title="gtk.TreeView.remove_column"><a name="method-gtktreeview--remove-column"></a><h3>gtk.TreeView.remove_column</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">remove_column</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>column</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>column</code></strong> :</span></p></td><td>the <a class="link" href="class-gtktreeviewcolumn.html" title="gtk.TreeViewColumn"><code class="classname">gtk.TreeViewColumn</code></a>
to remove.</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>the number of columns in the treeview after the
column removal.</td></tr></tbody></table><p>The <code class="methodname">remove_column</code>() method removes the
specified <em class="parameter"><code>column</code></em> from the treeview.</p></div><div class="refsect2" title="gtk.TreeView.insert_column"><a name="method-gtktreeview--insert-column"></a><h3>gtk.TreeView.insert_column</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">insert_column</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>column</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>column</code></strong> :</span></p></td><td>the <a class="link" href="class-gtktreeviewcolumn.html" title="gtk.TreeViewColumn"><code class="classname">gtk.TreeViewColumn</code></a>
to be inserted.</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>position</code></strong> :</span></p></td><td>the position to insert
<em class="parameter"><code>column</code></em>.</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>the number of columns in the treeview after the
insertion.</td></tr></tbody></table><p>The <code class="methodname">insert_column</code>() method inserts the
specified <em class="parameter"><code>column</code></em> into the treeview at the location
specified by <em class="parameter"><code>position</code></em>. If
<em class="parameter"><code>position</code></em> is -1, then the column is inserted at the
end.</p></div><div class="refsect2" title="gtk.TreeView.insert_column_with_attributes"><a name="method-gtktreeview--insert-column-with-attributes"></a><h3>gtk.TreeView.insert_column_with_attributes</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">insert_column_with_attributes</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>position</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>title</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>cell</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>position</code></em> :</span></p></td><td>the position to insert the new column
in.</td></tr><tr><td><p><span class="term"><em class="parameter"><code>title</code></em> :</span></p></td><td>the title to set the header
to.</td></tr><tr><td><p><span class="term"><em class="parameter"><code>cell</code></em> :</span></p></td><td>the <a class="link" href="class-gtkcellrenderer.html" title="gtk.CellRenderer"><code class="classname">gtk.CellRenderer</code></a>.</td></tr><tr><td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td><td>optional keyword-value
arguments</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>the <a class="link" href="class-gtktreeviewcolumn.html" title="gtk.TreeViewColumn"><code class="classname">gtk.TreeViewColumn</code></a>
that was inserted.</td></tr></tbody></table><p>The <code class="methodname">insert_column_with_attributes</code>()
method creates a new <a class="link" href="class-gtktreeviewcolumn.html" title="gtk.TreeViewColumn"><code class="classname">gtk.TreeViewColumn</code></a>
and inserts it into the treeview at the location specified by
<em class="parameter"><code>position</code></em> with the column title specified by
<em class="parameter"><code>title</code></em> and using the <a class="link" href="class-gtkcellrenderer.html" title="gtk.CellRenderer"><code class="classname">gtk.CellRenderer</code></a>
specified by <em class="parameter"><code>cell</code></em>. If <em class="parameter"><code>position</code></em>
is -1, then the newly created column is inserted at the end. The column is
initialized with the optional attributes passed as keyword-value pairs (e.g.
text=0, foreground=2). See the <a class="link" href="class-gtktreeviewcolumn.html#method-gtktreeviewcolumn--add-attribute" title="gtk.TreeViewColumn.add_attribute"><code class="methodname">gtk.TreeViewColumn.add_attribute</code>()</a>
method for more information.</p></div><div class="refsect2" title="gtk.TreeView.insert_column_with_data_func"><a name="method-gtktreeview--insert-column-with-data-func"></a><h3>gtk.TreeView.insert_column_with_data_func</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">insert_column_with_data_func</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>position</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>title</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>cell</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>func</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>data</code></em></span><span class="initializer">=None</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>position</code></em> :</span></p></td><td>the position to insert, -1 for
append</td></tr><tr><td><p><span class="term"><em class="parameter"><code>title</code></em> :</span></p></td><td>the column title</td></tr><tr><td><p><span class="term"><em class="parameter"><code>cell</code></em> :</span></p></td><td>a cell renderer for the
column</td></tr><tr><td><p><span class="term"><em class="parameter"><code>func</code></em> :</span></p></td><td>the function or method to set attributes of the
cell renderer</td></tr><tr><td><p><span class="term"><em class="parameter"><code>data</code></em> :</span></p></td><td>the data to pass with
<em class="parameter"><code>func</code></em></td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>the number of columns in the treeview after the
insertion</td></tr></tbody></table><p>The <code class="methodname">insert_column_with_data_func</code>()
method is a convenience function that inserts a new column into the treeview
at the location specified by <em class="parameter"><code>position</code></em> with the
specified <em class="parameter"><code>title</code></em> and the cell renderer specified by
<em class="parameter"><code>cell</code></em> and using the function or method specified by
<em class="parameter"><code>func</code></em> to set cell renderer attributes (normally using
data from the model). The signature of func is:</p><pre class="programlisting">
<code class="methodsynopsis"> def <span class="methodname">celldatafunction</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>column</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>cell</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>model</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>iter</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_data</code></em></span></span>)</code><br>
<code class="methodsynopsis"> def <span class="methodname">celldatamethod</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>self</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>column</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>cell</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>model</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>iter</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_data</code></em></span></span>)</code>
</pre><p>where <em class="parameter"><code>column</code></em> is the <a class="link" href="class-gtktreeviewcolumn.html" title="gtk.TreeViewColumn"><code class="classname">gtk.TreeViewColumn</code></a>
in the treeview, <em class="parameter"><code>cell</code></em> is the <a class="link" href="class-gtkcellrenderer.html" title="gtk.CellRenderer"><code class="classname">gtk.CellRenderer</code></a>
for <em class="parameter"><code>column</code></em>, <em class="parameter"><code>model</code></em> is the <a class="link" href="class-gtktreemodel.html" title="gtk.TreeModel"><code class="classname">gtk.TreeModel</code></a> for
the treeview and <em class="parameter"><code>iter</code></em> is the <a class="link" href="class-gtktreeiter.html" title="gtk.TreeIter"><code class="classname">gtk.TreeIter</code></a>
pointing at the row. See the <a class="link" href="class-gtktreeviewcolumn.html#method-gtktreeviewcolumn--set-cell-data-func" title="gtk.TreeViewColumn.set_cell_data_func"><code class="methodname">gtk.TreeViewColumn.set_cell_data_func</code>()</a>
and <a class="link" href="class-gtktreeviewcolumn.html#method-gtktreeviewcolumn--pack-start" title="gtk.TreeViewColumn.pack_start"><code class="methodname">gtk.TreeViewColumn.pack_start</code>()</a>
methods for more detail.</p></div><div class="refsect2" title="gtk.TreeView.get_column"><a name="method-gtktreeview--get-column"></a><h3>gtk.TreeView.get_column</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_column</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>n</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>n</code></strong> :</span></p></td><td>the position of the column, counting from
0.</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>the <a class="link" href="class-gtktreeviewcolumn.html" title="gtk.TreeViewColumn"><code class="classname">gtk.TreeViewColumn</code></a>,
or <code class="literal">None</code> if the position is outside the range of
columns.</td></tr></tbody></table><p>The <code class="methodname">get_column</code>() method returns the
<a class="link" href="class-gtktreeviewcolumn.html" title="gtk.TreeViewColumn"><code class="classname">gtk.TreeViewColumn</code></a>
at the specified <em class="parameter"><code>position</code></em> in the treeview.</p></div><div class="refsect2" title="gtk.TreeView.get_columns"><a name="method-gtktreeview--get-columns"></a><h3>gtk.TreeView.get_columns</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_columns</span>(<span class="methodparam"></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 list of <a class="link" href="class-gtktreeviewcolumn.html" title="gtk.TreeViewColumn"><code class="classname">gtk.TreeViewColumn</code></a>
s</td></tr></tbody></table><p>The <code class="methodname">get_columns</code>() method returns a list
of all the <a class="link" href="class-gtktreeviewcolumn.html" title="gtk.TreeViewColumn"><code class="classname">gtk.TreeViewColumn</code></a>
objects currently in the treeview.</p></div><div class="refsect2" title="gtk.TreeView.move_column_after"><a name="method-gtktreeview--move-column-after"></a><h3>gtk.TreeView.move_column_after</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">move_column_after</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>column</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>base_column</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>column</code></strong> :</span></p></td><td>the <a class="link" href="class-gtktreeviewcolumn.html" title="gtk.TreeViewColumn"><code class="classname">gtk.TreeViewColumn</code></a>
to be moved.</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>base_column</code></strong> :</span></p></td><td>the <a class="link" href="class-gtktreeviewcolumn.html" title="gtk.TreeViewColumn"><code class="classname">gtk.TreeViewColumn</code></a>
<em class="parameter"><code>column</code></em> is to be after, or
<code class="literal">None</code>.</td></tr></tbody></table><p>The <code class="methodname">move_column_after</code>() method moves
the <a class="link" href="class-gtktreeviewcolumn.html" title="gtk.TreeViewColumn"><code class="classname">gtk.TreeViewColumn</code></a>
specified by <em class="parameter"><code>column</code></em> to be after the treeview column
specified by <em class="parameter"><code>base_column</code></em>. If
<em class="parameter"><code>base_column</code></em> is <code class="literal">None</code>, then
<em class="parameter"><code>column</code></em> is placed in the first position.</p></div><div class="refsect2" title="gtk.TreeView.set_expander_column"><a name="method-gtktreeview--set-expander-column"></a><h3>gtk.TreeView.set_expander_column</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_expander_column</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>column</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>column</code></strong> :</span></p></td><td>the column to draw the expander arrow at
or<code class="literal">None</code>.</td></tr></tbody></table><p>The <code class="methodname">set_expander_column</code>() method sets
the "expander-column" property to the value of <em class="parameter"><code>column</code></em>
which must be a <a class="link" href="class-gtktreeviewcolumn.html" title="gtk.TreeViewColumn"><code class="classname">gtk.TreeViewColumn</code></a>
in the treeview. If <em class="parameter"><code>column</code></em> is
<code class="literal">None</code>, then the expander arrow is always at the first
visible column.</p></div><div class="refsect2" title="gtk.TreeView.get_expander_column"><a name="method-gtktreeview--get-expander-column"></a><h3>gtk.TreeView.get_expander_column</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_expander_column</span>(<span class="methodparam"></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 expander column.</td></tr></tbody></table><p>The <code class="methodname">get_expander_column</code>() method
returns the value of the "expander-column" property that contains the
current expander column i.e. the column that has the expander arrow drawn
next to it.</p></div><div class="refsect2" title="gtk.TreeView.set_column_drag_function"><a name="method-gtktreeview--set-column-drag-function"></a><h3>gtk.TreeView.set_column_drag_function</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_column_drag_function</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>func</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>user_data</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>func</code></strong> :</span></p></td><td>A function to determine which columns are reorderable, or <code class="literal">None</code>.</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>user_data</code></strong> :</span></p></td><td>User data to be passed to <em class="parameter"><code>func</code></em>, or <code class="literal">None</code></td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.4 and above.</p></div><p>The <code class="methodname">set_column_drag_function</code>() method
sets the user function specified by <em class="parameter"><code>func</code></em> for
determining where a column may be dropped when dragged. The user function is
called on every column pair in turn at the beginning of a column drag to
determine where a drop can take place. The signature of
<em class="parameter"><code>func</code></em> is:</p><pre class="programlisting">
def func(<em class="parameter"><code>tree_view</code></em>, <em class="parameter"><code>column</code></em>, <em class="parameter"><code>prev_column</code></em>, <em class="parameter"><code>next_column</code></em>, <em class="parameter"><code>data</code></em>)
</pre><p>where <em class="parameter"><code>tree_view</code></em> is the <a class="link" href="class-gtktreeview.html" title="gtk.TreeView"><code class="classname">gtk.TreeView</code></a>,
<em class="parameter"><code>column</code></em> is the <a class="link" href="class-gtktreeviewcolumn.html" title="gtk.TreeViewColumn"><code class="classname">gtk.TreeViewColumn</code></a>
being dragged, prev_column and next_column are the two <a class="link" href="class-gtktreeviewcolumn.html" title="gtk.TreeViewColumn"><code class="classname">gtk.TreeViewColumn</code></a>
objects bracketing the drop spot, and <em class="parameter"><code>data</code></em> is
<em class="parameter"><code>user_data</code></em>. If <em class="parameter"><code>prev_column</code></em> or
<em class="parameter"><code>next_column</code></em> is <code class="literal">None</code>, then the drop
is at an edge. If <em class="parameter"><code>func</code></em> is <code class="literal">None</code>,
the user drag function is removed and the <a class="link" href="class-gtktreeview.html" title="gtk.TreeView"><code class="classname">gtk.TreeView</code></a>
reverts to the default behavior of allowing any reorderable column to be
dropped anywhere.</p></div><div class="refsect2" title="gtk.TreeView.scroll_to_point"><a name="method-gtktreeview--scroll-to-point"></a><h3>gtk.TreeView.scroll_to_point</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">scroll_to_point</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>tree_x</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>tree_y</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>tree_x</code></strong> :</span></p></td><td>the X coordinate of new top-left pixel of
visible area, or -1</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>tree_y</code></strong> :</span></p></td><td>the Y coordinate of new top-left pixel of
visible area, or -1</td></tr></tbody></table><p>The <code class="methodname">scroll_to_point</code>() method scrolls
the treeview so that the top-left corner of the visible area is at the
location specified by <em class="parameter"><code>tree_x</code></em> and
<em class="parameter"><code>tree_y</code></em>, where <em class="parameter"><code>tree_x</code></em> and
<em class="parameter"><code>tree_y</code></em> are specified in tree window coordinates. The
treeview must be realized before this method is called. If it isn't, you
should use the <a class="link" href="class-gtktreeview.html#method-gtktreeview--scroll-to-cell" title="gtk.TreeView.scroll_to_cell"><code class="methodname">scroll_to_cell</code>()</a>
method instead. If either <em class="parameter"><code>tree_x</code></em> or
<em class="parameter"><code>tree_y</code></em> are -1, there is no scrolling in that
direction.</p></div><div class="refsect2" title="gtk.TreeView.scroll_to_cell"><a name="method-gtktreeview--scroll-to-cell"></a><h3>gtk.TreeView.scroll_to_cell</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">scroll_to_cell</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>path</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>column</code></strong></span><span class="initializer">=None</span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>use_align</code></strong></span><span class="initializer">=False</span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>row_align</code></strong></span><span class="initializer">=0.0</span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>col_align</code></strong></span><span class="initializer">=0.0</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>path</code></strong> :</span></p></td><td>the path of the row to move
to</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>column</code></strong> :</span></p></td><td>the <a class="link" href="class-gtktreeviewcolumn.html" title="gtk.TreeViewColumn"><code class="classname">gtk.TreeViewColumn</code></a>
to move horizontally to, or <code class="literal">None</code>.</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>use_align</code></strong> :</span></p></td><td>if <code class="literal">True</code> use the alignment
arguments</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>row_align</code></strong> :</span></p></td><td>the vertical alignment of the row specified by
<em class="parameter"><code>path</code></em>.</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>col_align</code></strong> :</span></p></td><td>the horizontal alignment of the column
specified by <em class="parameter"><code>column</code></em>.</td></tr></tbody></table><p>The <code class="methodname">scroll_to_cell</code>() method scrolls the
treeview display to the position specified by <em class="parameter"><code>column</code></em>
and <em class="parameter"><code>path</code></em>. If <em class="parameter"><code>column</code></em> is
<code class="literal">None</code>, no horizontal scrolling occurs. The alignment
parameters specified by <em class="parameter"><code>row_align</code></em> and
<em class="parameter"><code>col_align</code></em> determines where
<em class="parameter"><code>column</code></em> is placed within the treeview. The values of
<em class="parameter"><code>col_align</code></em> and <em class="parameter"><code>row_align</code></em> range
from 0.0 to 1.0. The alignment values specify the fraction of display space
that is to the left of or above the cell. If
<em class="parameter"><code>use_align</code></em> is <code class="literal">False</code>, the alignment
arguments are ignored, and the tree does the minimum amount of work to
scroll the cell onto the screen. This means that the cell will be scrolled
to the edge closest to it's current position. If the cell is currently
visible on the screen, nothing is done. This method only works if the model
is set, and <em class="parameter"><code>path</code></em> is a valid row in the model.</p></div><div class="refsect2" title="gtk.TreeView.row_activated"><a name="method-gtktreeview--row-activated"></a><h3>gtk.TreeView.row_activated</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">row_activated</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>path</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>column</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>path</code></strong> :</span></p></td><td>the tree path of the row of the cell to be
activated.</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>column</code></strong> :</span></p></td><td>the <a class="link" href="class-gtktreeviewcolumn.html" title="gtk.TreeViewColumn"><code class="classname">gtk.TreeViewColumn</code></a>
of the cell to be activated.</td></tr></tbody></table><p>The <code class="methodname">row_activated</code>() method activates
the cell determined by <em class="parameter"><code>path</code></em> and
<em class="parameter"><code>column</code></em>.</p></div><div class="refsect2" title="gtk.TreeView.expand_all"><a name="method-gtktreeview--expand-all"></a><h3>gtk.TreeView.expand_all</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">expand_all</span>(<span class="methodparam"></span>)</code></pre><p>The <code class="methodname">expand_all</code>() method recursively
expands all nodes in the treeview.</p></div><div class="refsect2" title="gtk.TreeView.collapse_all"><a name="method-gtktreeview--collapse-all"></a><h3>gtk.TreeView.collapse_all</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">collapse_all</span>(<span class="methodparam"></span>)</code></pre><p>The <code class="methodname">collapse_all</code>() method recursively
collapses all visible, expanded nodes in the treeview.</p></div><div class="refsect2" title="gtk.TreeView.expand_to_path"><a name="method-gtktreeview--expand-to-path"></a><h3>gtk.TreeView.expand_to_path</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">expand_to_path</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>path</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"><em class="parameter"><code>path</code></em> :</span></p></td><td>a path to a row.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.2 and above.</p></div><p>The <code class="methodname">expand_to_row</code>() method expands the
row with the tree path specified by <em class="parameter"><code>path</code></em>. This will
also expand all parent rows of <em class="parameter"><code>path</code></em> as
necessary.</p></div><div class="refsect2" title="gtk.TreeView.expand_row"><a name="method-gtktreeview--expand-row"></a><h3>gtk.TreeView.expand_row</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">expand_row</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>path</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>open_all</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>path</code></strong> :</span></p></td><td>the path to a row</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>open_all</code></strong> :</span></p></td><td>if <code class="literal">True</code> recursively expand,
otherwise just expand immediate children</td></tr></tbody></table><p>The <code class="methodname">expand_row</code>() method opens the row
specified by <em class="parameter"><code>path</code></em> so its children are visible. If
<em class="parameter"><code>open_all</code></em> is <code class="literal">True</code> all rows are
expanded, otherwise only the immediate children of
<em class="parameter"><code>path</code></em> are expanded.</p></div><div class="refsect2" title="gtk.TreeView.collapse_row"><a name="method-gtktreeview--collapse-row"></a><h3>gtk.TreeView.collapse_row</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">collapse_row</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>path</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>path</code></strong> :</span></p></td><td>the path to a row</td></tr></tbody></table><p>The <code class="methodname">collapse_row</code>() method collapses the
row specified by <em class="parameter"><code>path</code></em> (hides its child rows, if they
exist).</p></div><div class="refsect2" title="gtk.TreeView.map_expanded_rows"><a name="method-gtktreeview--map-expanded-rows"></a><h3>gtk.TreeView.map_expanded_rows</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">map_expanded_rows</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>func</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>data</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>func</code></strong> :</span></p></td><td>A function to be called</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>data</code></strong> :</span></p></td><td>User data to be passed to the function.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.2 and above.</p></div><p>The <code class="methodname">map_expanded_rows</code>() method calls
the function specified by <em class="parameter"><code>func</code></em> on all expanded rows
passing <em class="parameter"><code>data</code></em> as an argument.</p></div><div class="refsect2" title="gtk.TreeView.row_expanded"><a name="method-gtktreeview--row-expanded"></a><h3>gtk.TreeView.row_expanded</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">row_expanded</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>path</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>path</code></strong> :</span></p></td><td>the path to a row to test the expansion
state.</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td><code class="literal">True</code> if
<code class="literal">path</code> is expanded.</td></tr></tbody></table><p>The <code class="methodname">row_expanded</code>() method returns
<code class="literal">True</code> if the node pointed to by
<em class="parameter"><code>path</code></em> is expanded.</p></div><div class="refsect2" title="gtk.TreeView.set_reorderable"><a name="method-gtktreeview--set-reorderable"></a><h3>gtk.TreeView.set_reorderable</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_reorderable</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>reorderable</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>reorderable</code></strong> :</span></p></td><td>if <code class="literal">True</code>, the tree can be
reordered.</td></tr></tbody></table><p>The <code class="methodname">set_reorderable</code>() method sets the
"reorderable" property to the value of <em class="parameter"><code>reorderable</code></em>.
This method is a convenience method to allow you to reorder models that
support the <a class="link" href="class-gtktreedragsource.html" title="gtk.TreeDragSource"><code class="classname">gtk.TreeDragSource</code></a>
and the <a class="link" href="class-gtktreedragdest.html" title="gtk.TreeDragDest"><code class="classname">gtk.TreeDragDest</code></a>
interfaces. Both <a class="link" href="class-gtktreestore.html" title="gtk.TreeStore"><code class="classname">gtk.TreeStore</code></a> and
<a class="link" href="class-gtkliststore.html" title="gtk.ListStore"><code class="classname">gtk.ListStore</code></a>
support these. If <em class="parameter"><code>reorderable</code></em> is
<code class="literal">True</code>, then the user can reorder the model by dragging and
dropping rows. The application can listen to these changes by connecting to
the model's signals.</p><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This function does not give you any degree of control over the
order -- any reordering is allowed. If more control is needed, you should
probably handle drag and drop manually.</p></div></div><div class="refsect2" title="gtk.TreeView.get_reorderable"><a name="method-gtktreeview--get-reorderable"></a><h3>gtk.TreeView.get_reorderable</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_reorderable</span>(<span class="methodparam"></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><code class="literal">True</code> if the tree can be
reordered.</td></tr></tbody></table><p>The <code class="methodname">get_reorderable</code>() method returns
the value of the "reorderable" property that determines if the user can
reorder the tree via drag-and-drop. See the <a class="link" href="class-gtktreeview.html#method-gtktreeview--set-reorderable" title="gtk.TreeView.set_reorderable"><code class="methodname">set_reorderable</code>()</a>
method for more information.</p></div><div class="refsect2" title="gtk.TreeView.set_cursor"><a name="method-gtktreeview--set-cursor"></a><h3>gtk.TreeView.set_cursor</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_cursor</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>path</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>focus_column</code></strong></span><span class="initializer">=None</span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>start_editing</code></strong></span><span class="initializer">=False</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>path</code></strong> :</span></p></td><td>a tree path</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>focus_column</code></strong> :</span></p></td><td>a <a class="link" href="class-gtktreeviewcolumn.html" title="gtk.TreeViewColumn"><code class="classname">gtk.TreeViewColumn</code></a>,
or <code class="literal">None</code></td></tr><tr><td><p><span class="term"><strong class="parameter"><code>start_editing</code></strong> :</span></p></td><td><code class="literal">if True</code> the specified cell
should start being edited.</td></tr></tbody></table><p>The <code class="methodname">set_cursor</code>() method sets the
current keyboard focus to be at the row specified by
<em class="parameter"><code>path</code></em>, and selects it. This is useful when you want to
focus the user's attention on a particular row. If
<em class="parameter"><code>column</code></em> is not <code class="literal">None</code>, then focus is
given to the specified column. Additionally, if
<em class="parameter"><code>column</code></em> is specified, and
<em class="parameter"><code>start_editing</code></em> is <code class="literal">True</code>, then
editing should be started in the specified cell. This method is often
followed by the <a class="link" href="class-gtkwidget.html#method-gtkwidget--grab-focus" title="gtk.Widget.grab_focus"><code class="methodname">gtk.Widget.grab_focus</code>()</a>
method to give keyboard focus to the treeview. Please note that editing can
only happen when the widget is realized.</p></div><div class="refsect2" title="gtk.TreeView.set_cursor_on_cell"><a name="method-gtktreeview--set-cursor-on-cell"></a><h3>gtk.TreeView.set_cursor_on_cell</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_cursor_on_cell</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>path</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>focus_column</code></strong></span><span class="initializer">=None</span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>focus_cell</code></strong></span><span class="initializer">=None</span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>start_editing</code></strong></span><span class="initializer">=False</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>path</code></em> :</span></p></td><td>a tree path</td></tr><tr><td><p><span class="term"><em class="parameter"><code>focus_column</code></em> :</span></p></td><td>a <a class="link" href="class-gtktreeviewcolumn.html" title="gtk.TreeViewColumn"><code class="classname">gtk.TreeViewColumn</code></a>,
or <code class="literal">None</code></td></tr><tr><td><p><span class="term"><em class="parameter"><code>focus_cell</code></em> :</span></p></td><td>a <a class="link" href="class-gtkcellrenderer.html" title="gtk.CellRenderer"><code class="classname">gtk.CellRenderer</code></a>,
or <code class="literal">None</code></td></tr><tr><td><p><span class="term"><em class="parameter"><code>start_editing</code></em> :</span></p></td><td><code class="literal">True</code> if the specified cell
should start being edited.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.2 and above.</p></div><p>The <code class="methodname">set_cursor_on_cell</code>() method sets
the current keyboard focus to be at the node specified by
<em class="parameter"><code>path</code></em>, and selects it. This is useful when you want
to focus the user's attention on a particular row. If
<em class="parameter"><code>focus_column</code></em> is specified, focus is given to that
column. If <em class="parameter"><code>focus_column</code></em> and
<em class="parameter"><code>focus_cell</code></em> are specified, and
<em class="parameter"><code>focus_column</code></em> contains 2 or more editable or
activatable cells, then focus is given to the cell specified by
<em class="parameter"><code>focus_cell</code></em>. Additionally, if
<em class="parameter"><code>focus_column</code></em> is specified, and
<em class="parameter"><code>start_editing</code></em> is <code class="literal">True</code>, editing
should be started in the specified cell. This method is often followed by
the <a class="link" href="class-gtkwidget.html#method-gtkwidget--grab-focus" title="gtk.Widget.grab_focus"><code class="methodname">gtk.Widget.grab_focus</code>()</a>
method in order to give keyboard focus to the widget. Please note that
editing can only happen when the widget is realized.</p></div><div class="refsect2" title="gtk.TreeView.get_cursor"><a name="method-gtktreeview--get-cursor"></a><h3>gtk.TreeView.get_cursor</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_cursor</span>(<span class="methodparam"></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 current cursor path and
focus column.</td></tr></tbody></table><p>The <code class="methodname">get_cursor</code>() method returns a tuple
containing the current path and focus column. If the cursor isn't currently
set, the current path will be <code class="literal">None</code>. If no column
currently has focus, the current focus column will be
<code class="literal">None</code>.</p></div><div class="refsect2" title="gtk.TreeView.get_bin_window"><a name="method-gtktreeview--get-bin-window"></a><h3>gtk.TreeView.get_bin_window</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_bin_window</span>(<span class="methodparam"></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 <a class="link" href="class-gdkwindow.html" title="gtk.gdk.Window"><code class="classname">gtk.gdk.Window</code></a>, or
<code class="literal">None</code></td></tr></tbody></table><p>The <code class="methodname">get_bin_window</code>() method returns the
window that the treeview renders to or <code class="literal">None</code> if the
treeview is not realized yet. This is used primarily to compare to the
<code class="literal">event.window</code> attribute to confirm that the event on the
treeview is on the right window.</p></div><div class="refsect2" title="gtk.TreeView.get_path_at_pos"><a name="method-gtktreeview--get-path-at-pos"></a><h3>gtk.TreeView.get_path_at_pos</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_path_at_pos</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>)</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 position to be
identified.</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>y</code></strong> :</span></p></td><td>The y position to be
identified.</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>a tuple containing: a tree path; a <a class="link" href="class-gtktreeviewcolumn.html" title="gtk.TreeViewColumn"><code class="classname">gtk.TreeViewColumn</code></a>
object; the X coordinate relative to the cell; and, the Y
coordinate relative to the cell. If there is no path at the
position <code class="literal">None</code> is returned.</td></tr></tbody></table><p>The <code class="methodname">get_path_at_pos</code>() method returns a
tuple containing:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem">the path at the specified point
(<em class="parameter"><code>x</code></em>, <em class="parameter"><code>y</code></em>), relative to widget
coordinates</li><li class="listitem">the <a class="link" href="class-gtktreeviewcolumn.html" title="gtk.TreeViewColumn"><code class="classname">gtk.TreeViewColumn</code></a>
at that point</li><li class="listitem">the X coordinate relative to the cell
background</li><li class="listitem">the Y coordinate relative to the cell
background</li></ul></div><p><em class="parameter"><code>x</code></em> and <em class="parameter"><code>y</code></em> are
relative to the coordinates of an event on the treeview only when
<code class="literal">event.window==treeview.get_bin_window()</code>. It is primarily
used for popup menus. This method is only meaningful if the treeview is
realized. This method returns <code class="literal">None</code> if there is no path at
the position.</p></div><div class="refsect2" title="gtk.TreeView.get_cell_area"><a name="method-gtktreeview--get-cell-area"></a><h3>gtk.TreeView.get_cell_area</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_cell_area</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>path</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>column</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>path</code></strong> :</span></p></td><td>a tree path for the row</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>column</code></strong> :</span></p></td><td>a <a class="link" href="class-gtktreeviewcolumn.html" title="gtk.TreeViewColumn"><code class="classname">gtk.TreeViewColumn</code></a>
for the column</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>rectangle</td></tr></tbody></table><p>The <code class="methodname">get_cell_area</code>() method returns the
bounding <a class="link" href="class-gdkrectangle.html" title="gtk.gdk.Rectangle"><code class="classname">gtk.gdk.Rectangle</code></a>
in tree window coordinates for the cell at the row specified by
<em class="parameter"><code>path</code></em> and the column specified by
<em class="parameter"><code>column</code></em>. If <em class="parameter"><code>path</code></em> points to a
path not currently displayed, the <em class="parameter"><code>y</code></em> and
<em class="parameter"><code>height</code></em> attributes of the rectangle will be 0. The sum
of all cell rects does not cover the entire tree; there are extra pixels in
between rows, for example. The returned rectangle is equivalent to the
<em class="parameter"><code>cell_area</code></em> passed to the <a class="link" href="class-gtkcellrenderer.html#method-gtkcellrenderer--render" title="gtk.CellRenderer.render"><code class="methodname">gtk.CellRenderer.render</code>()</a>
method. This method is only valid if the treeview is realized.</p></div><div class="refsect2" title="gtk.TreeView.get_background_area"><a name="method-gtktreeview--get-background-area"></a><h3>gtk.TreeView.get_background_area</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_background_area</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>path</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>column</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>path</code></strong> :</span></p></td><td>a tree path for the row,</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>column</code></strong> :</span></p></td><td>a <a class="link" href="class-gtktreeviewcolumn.html" title="gtk.TreeViewColumn"><code class="classname">gtk.TreeViewColumn</code></a>
for the column</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>a rectangle</td></tr></tbody></table><p>The <code class="methodname">get_background_area</code>() method
returns the bounding <a class="link" href="class-gdkrectangle.html" title="gtk.gdk.Rectangle"><code class="classname">gtk.gdk.Rectangle</code></a>
in tree window coordinates for the cell at the row specified by
<em class="parameter"><code>path</code></em> and the column specified by
<em class="parameter"><code>column</code></em>. If <em class="parameter"><code>path</code></em> points to a
node not found in the tree, the <em class="parameter"><code>y</code></em> and
<em class="parameter"><code>height</code></em> attributes of the rectangle will be 0. The
returned rectangle is equivalent to the
<em class="parameter"><code>background_area</code></em> passed to the <a class="link" href="class-gtkcellrenderer.html#method-gtkcellrenderer--render" title="gtk.CellRenderer.render"><code class="methodname">gtk.CellRenderer.render</code>()</a>.
These background areas tile to cover the entire tree window (except for the
area used for header buttons). Contrast with the
<em class="parameter"><code>cell_area</code></em>, returned by the <a class="link" href="class-gtktreeview.html#method-gtktreeview--get-cell-area" title="gtk.TreeView.get_cell_area"><code class="methodname">get_cell_area</code>()</a>
method, that returns only the cell itself, excluding the surrounding borders
and the tree expander area.</p></div><div class="refsect2" title="gtk.TreeView.get_visible_rect"><a name="method-gtktreeview--get-visible-rect"></a><h3>gtk.TreeView.get_visible_rect</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_visible_rect</span>(<span class="methodparam"></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 rectangle</td></tr></tbody></table><p>The <code class="methodname">get_visible_rect</code>() method returns
the bounding <a class="link" href="class-gdkrectangle.html" title="gtk.gdk.Rectangle"><code class="classname">gtk.gdk.Rectangle</code></a>
for the currently visible region of the treeview widget, in tree
coordinates. Convert to widget coordinates with the <a class="link" href="class-gtktreeview.html#method-gtktreeview--tree-to-widget-coords" title="gtk.TreeView.tree_to_widget_coords"><code class="methodname">tree_to_widget_coords</code>()</a>.
Tree coordinates start at 0,0 for row 0 of the tree, and cover the entire
scrollable area of the tree.</p></div><div class="refsect2" title="gtk.TreeView.widget_to_tree_coords"><a name="method-gtktreeview--widget-to-tree-coords"></a><h3>gtk.TreeView.widget_to_tree_coords</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">widget_to_tree_coords</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>wx</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>wy</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>wx</code></em> :</span></p></td><td>the widget X coordinate</td></tr><tr><td><p><span class="term"><em class="parameter"><code>wy</code></em> :</span></p></td><td>the widget Y coordinate</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>a tuple containing the tree X and Y
coordinates</td></tr></tbody></table><p>The <code class="methodname">widget_to_tree_coords</code>() method
returns a tuple containing the tree X and Y coordinates for the widget
coordinates specified by <em class="parameter"><code>wx</code></em> and
<em class="parameter"><code>wy</code></em>. The tree coordinates cover the full scrollable
area of the tree.</p></div><div class="refsect2" title="gtk.TreeView.tree_to_widget_coords"><a name="method-gtktreeview--tree-to-widget-coords"></a><h3>gtk.TreeView.tree_to_widget_coords</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">tree_to_widget_coords</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>tx</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>ty</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>tx</code></em> :</span></p></td><td>tree X coordinate</td></tr><tr><td><p><span class="term"><em class="parameter"><code>ty</code></em> :</span></p></td><td>tree Y coordinate</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>a tuple containing the widget X and Y
coordinates</td></tr></tbody></table><p>The <code class="methodname">tree_to_widget_coords</code>() method
returns a tuple containing the widget coordinates for the tree coordinates
specified by <em class="parameter"><code>tx</code></em> and <em class="parameter"><code>ty</code></em>.</p></div><div class="refsect2" title="gtk.TreeView.enable_model_drag_source"><a name="method-gtktreeview--enable-model-drag-source"></a><h3>gtk.TreeView.enable_model_drag_source</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">enable_model_drag_source</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>start_button_mask</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>targets</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>actions</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>start_button_mask</code></strong> :</span></p></td><td>the bitmask of buttons that can start the
drag</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>targets</code></strong> :</span></p></td><td>a sequence of tuples containing target
data</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>actions</code></strong> :</span></p></td><td>the possible actions for a
drag</td></tr></tbody></table><p>The <code class="methodname">enable_model_drag_source</code>() method
sets the treeview to start a drag operation when the user click and
drags on a row. The value of <em class="parameter"><code>start_button_mask</code></em>
is a combination of the<a class="xref" href="gdk-constants.html#gdk-modifier-constants" title="GDK Modifier Constants">GDK Modifier Constants</a>.</p><p><em class="parameter"><code>targets</code></em> is a sequence (list or tuple) of
tuples that contain information about the targets. The target data
contains a string representing the drag type, target flags (a
combination of the <a class="xref" href="gtk-constants.html#gtk-target-flags-constants" title="GTK Target Flags Constants">GTK Target Flags Constants</a>) and an application
assigned integer ID used for identification purposes.</p><p>The value of <em class="parameter"><code>actions</code></em> is one of the <a class="xref" href="gdk-constants.html#gdk-drag-action-constants" title="GDK Drag Action Constants">GDK Drag Action Constants</a>.</p></div><div class="refsect2" title="gtk.TreeView.enable_model_drag_dest"><a name="method-gtktreeview--enable-model-drag-dest"></a><h3>gtk.TreeView.enable_model_drag_dest</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">enable_model_drag_dest</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>targets</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>actions</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>targets</code></strong> :</span></p></td><td>a sequence of tuples containing target
data</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>actions</code></strong> :</span></p></td><td>the possible actions for a
drag</td></tr></tbody></table><p>The <code class="methodname">enable_model_drag_dest</code>() method
sets the treeview to receive a drag drop.</p><p><em class="parameter"><code>targets</code></em> is a sequence (list or tuple) of
tuples that contain information about the targets. The target data
contains a string representing the drag type, target flags (a
combination of <code class="literal">gtk.TARGET_SAME_APP</code> and
<code class="literal">gtk.TARGET_SAME_WIDGET</code> or neither) and an
application assigned integer ID used for identification
purposes.</p><p>The value of <em class="parameter"><code>actions</code></em> is one of the <a class="xref" href="gdk-constants.html#gdk-drag-action-constants" title="GDK Drag Action Constants">GDK Drag Action Constants</a>.</p></div><div class="refsect2" title="gtk.TreeView.unset_rows_drag_source"><a name="method-gtktreeview--unset-rows-drag-source"></a><h3>gtk.TreeView.unset_rows_drag_source</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">unset_rows_drag_source</span>(<span class="methodparam"></span>)</code></pre><p>The <code class="methodname">unset_rows_drag_source</code>() method
unsets the drag source information.</p></div><div class="refsect2" title="gtk.TreeView.unset_rows_drag_dest"><a name="method-gtktreeview--unset-rows-drag-dest"></a><h3>gtk.TreeView.unset_rows_drag_dest</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">unset_rows_drag_dest</span>(<span class="methodparam"></span>)</code></pre><p>The <code class="methodname">unset_rows_drag_dest</code>() method
unsets the drag destination information.</p></div><div class="refsect2" title="gtk.TreeView.set_drag_dest_row"><a name="method-gtktreeview--set-drag-dest-row"></a><h3>gtk.TreeView.set_drag_dest_row</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_drag_dest_row</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>path</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>pos</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>path</code></strong> :</span></p></td><td>a tree path of the row to highlight, or
<code class="literal">None</code>.</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>pos</code></strong> :</span></p></td><td>a drop position</td></tr></tbody></table><p>The <code class="methodname">set_drag_dest_row</code>() method sets the
treeview drag destination row to the value specified by
<em class="parameter"><code>path</code></em> with the drop position specified by
<em class="parameter"><code>pos</code></em>. The value of <em class="parameter"><code>pos</code></em> must be
one of: <code class="literal">gtk.TREE_VIEW_DROP_BEFORE</code>,
<code class="literal">gtk.TREE_VIEW_DROP_AFTER</code>,
<code class="literal">gtk.TREE_VIEW_DROP_INTO_OR_BEFORE</code> or
<code class="literal">gtk.TREE_VIEW_DROP_INTO_OR_AFTER</code>.</p><p>In PyGTK 2.10 and above, <em class="parameter"><code>path</code></em> may be
<code class="literal">None</code>.</p></div><div class="refsect2" title="gtk.TreeView.get_drag_dest_row"><a name="method-gtktreeview--get-drag-dest-row"></a><h3>gtk.TreeView.get_drag_dest_row</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_drag_dest_row</span>(<span class="methodparam"></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 2-tuple containing the tree path and the drop
position relative to the tree path or <code class="literal">
None</code></td></tr></tbody></table><p>The <code class="methodname">get_drag_dest_row</code>() method returns
a 2-tuple containing the path of the drag destination row and a drop
position relative to the destination row. The drop position is one of:
<code class="literal">gtk.TREE_VIEW_DROP_BEFORE</code>,
<code class="literal">gtk.TREE_VIEW_DROP_AFTER</code>,
<code class="literal">gtk.TREE_VIEW_DROP_INTO_OR_BEFORE</code> or
<code class="literal">gtk.TREE_VIEW_DROP_INTO_OR_AFTER</code>. This method returns
<code class="literal">None</code> if no drag destination row is set.</p></div><div class="refsect2" title="gtk.TreeView.get_dest_row_at_pos"><a name="method-gtktreeview--get-dest-row-at-pos"></a><h3>gtk.TreeView.get_dest_row_at_pos</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_dest_row_at_pos</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>)</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
position</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>y</code></strong> :</span></p></td><td>the y coordinate of the
position</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>a 2-tuple containing the path of the row and
the drop position at the position specified by <em class="parameter"><code>x</code></em> and
<em class="parameter"><code>y</code></em> or <code class="literal">None</code></td></tr></tbody></table><p>The <code class="methodname">get_dest_row_at_pos</code>() method
returns a 2-tuple containing the path of the row and the drop position
relative to the row of the position specified by <em class="parameter"><code>x</code></em>
and <em class="parameter"><code>y</code></em>. The drop position is one of:
<code class="literal">gtk.TREE_VIEW_DROP_BEFORE</code>,
<code class="literal">gtk.TREE_VIEW_DROP_AFTER</code>,
<code class="literal">gtk.TREE_VIEW_DROP_INTO_OR_BEFORE</code> or
<code class="literal">gtk.TREE_VIEW_DROP_INTO_OR_AFTER</code>.</p></div><div class="refsect2" title="gtk.TreeView.create_row_drag_icon"><a name="method-gtktreeview--create-row-drag-icon"></a><h3>gtk.TreeView.create_row_drag_icon</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">create_row_drag_icon</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>path</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>path</code></strong> :</span></p></td><td>a tree path</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>a new pixmap of the drag
icon.</td></tr></tbody></table><p>The <code class="methodname">create_row_drag_icon</code>() method
creates a <a class="link" href="class-gdkpixmap.html" title="gtk.gdk.Pixmap"><code class="classname">gtk.gdk.Pixmap</code></a>
representation of the row specified by <em class="parameter"><code>path</code></em>. This
image is used for a drag icon.</p></div><div class="refsect2" title="gtk.TreeView.set_enable_search"><a name="method-gtktreeview--set-enable-search"></a><h3>gtk.TreeView.set_enable_search</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_enable_search</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>enable_search</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>enable_search</code></strong> :</span></p></td><td>if <code class="literal">True</code>, the user can search
interactively</td></tr></tbody></table><p>The <code class="methodname">set_enable_search</code>() method sets the
"enable-search" property to the value of
<em class="parameter"><code>enable_search</code></em>. If
<em class="parameter"><code>enable_search</code></em> is <code class="literal">True</code> the user can
type in text to search through the tree interactively.</p></div><div class="refsect2" title="gtk.TreeView.get_enable_search"><a name="method-gtktreeview--get-enable-search"></a><h3>gtk.TreeView.get_enable_search</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_enable_search</span>(<span class="methodparam"></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><code class="literal">True</code> if the user can search
interactively</td></tr></tbody></table><p>The <code class="methodname">get_enable_search</code>() method returns
the value of the "enable-search" property. If "enable-search" is
<code class="literal">True</code> the tree allows interactive searching.</p></div><div class="refsect2" title="gtk.TreeView.get_search_column"><a name="method-gtktreeview--get-search-column"></a><h3>gtk.TreeView.get_search_column</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_search_column</span>(<span class="methodparam"></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 column the interactive search code
searches.</td></tr></tbody></table><p>The <code class="methodname">get_search_column</code>() method returns
the value of the "search-column" property that is the column searched by
the interactive search code.</p></div><div class="refsect2" title="gtk.TreeView.set_search_column"><a name="method-gtktreeview--set-search-column"></a><h3>gtk.TreeView.set_search_column</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_search_column</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>column</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>column</code></strong> :</span></p></td><td>the column to search</td></tr></tbody></table><p>The <code class="methodname">set_search_column</code>() method sets the
"search-column" property to the value of <em class="parameter"><code>column</code></em>. The
value of <em class="parameter"><code>column</code></em> is the column where the interactive
search code should search. Additionally, this method turns on interactive
searching (see the <a class="link" href="class-gtktreeview.html#method-gtktreeview--set-enable-search" title="gtk.TreeView.set_enable_search"><code class="methodname">set_enable_search</code>()</a>
method).</p></div><div class="refsect2" title="gtk.TreeView.set_search_equal_func"><a name="method-gtktreeview--set-search-equal-func"></a><h3>gtk.TreeView.set_search_equal_func</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_search_equal_func</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>func</code></strong></span><span class="initializer">=None</span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>user_data</code></strong></span><span class="initializer">=None</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>func</code></strong> :</span></p></td><td>the compare function to use during the search or <code class="literal">None</code></td></tr><tr><td><p><span class="term"><strong class="parameter"><code>user_data</code></strong> :</span></p></td><td>user data to pass to <em class="parameter"><code>func</code></em>, or <code class="literal">None</code></td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.4 and above.</p></div><p>The <code class="methodname">set_search_equal_func</code>() method sets
the compare function for the interactive search capabilities to the function
specified by <em class="parameter"><code>func</code></em>. If
<em class="parameter"><code>user_data</code></em> is specified and not
<code class="literal">None</code>, it is passed to <em class="parameter"><code>func</code></em>. If
<em class="parameter"><code>func</code></em> is <code class="literal">None</code>, the default <a class="link" href="class-gtktreeview.html" title="gtk.TreeView"><code class="classname">gtk.TreeView</code></a>
search equal function will be used. The signature of
<em class="parameter"><code>func</code></em> is:</p><pre class="programlisting">
def func(<em class="parameter"><code>model</code></em>, <em class="parameter"><code>column</code></em>, <em class="parameter"><code>key</code></em>, <em class="parameter"><code>iter</code></em>, <em class="parameter"><code>data</code></em>)
</pre><p>where <em class="parameter"><code>model</code></em> is the <a class="link" href="class-gtktreemodel.html" title="gtk.TreeModel"><code class="classname">gtk.TreeModel</code></a> of
the <a class="link" href="class-gtktreeview.html" title="gtk.TreeView"><code class="classname">gtk.TreeView</code></a>,
<em class="parameter"><code>column</code></em> is the number of the column being searched
(see the <a class="link" href="class-gtktreeview.html#method-gtktreeview--set-search-column" title="gtk.TreeView.set_search_column"><code class="methodname">set_search_column</code>()</a>
method for more information), <em class="parameter"><code>key</code></em> is the string being
searched for, <em class="parameter"><code>iter</code></em> is a <a class="link" href="class-gtktreeiter.html" title="gtk.TreeIter"><code class="classname">gtk.TreeIter</code></a>
pointing to the current candidate row and <em class="parameter"><code>data</code></em> is the
context data <em class="parameter"><code>user_data</code></em>. <em class="parameter"><code>func</code></em>
should return <code class="literal">False</code> to indicate that the row matches the
search criteria.</p></div><div class="refsect2" title="gtk.TreeView.get_fixed_height_mode"><a name="method-gtktreeview--get-fixed-height-mode"></a><h3>gtk.TreeView.get_fixed_height_mode</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_fixed_height_mode</span>(<span class="methodparam"></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><code class="literal">True</code> if fixed height mode
is enabled.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.6 and above.</p></div><p>The <code class="methodname">get_fixed_height_mode</code>() method
returns the value of the "fixed-height-mode" property. If the
"fixed-height-mode" property is <code class="literal">True</code>, all rows are
assumed to be the same height.</p></div><div class="refsect2" title="gtk.TreeView.set_fixed_height_mode"><a name="method-gtktreeview--set-fixed-height-mode"></a><h3>gtk.TreeView.set_fixed_height_mode</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_fixed_height_mode</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>enable</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>enable</code></strong> :</span></p></td><td>if <code class="literal">True</code> enable fixed height
mode.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.6 and above.</p></div><p>The <code class="methodname">set_fixed_height_mode</code>() method sets
the "fixed-height-mode" property to the value of
<em class="parameter"><code>enable</code></em>. If <em class="parameter"><code>enable</code></em> is
<code class="literal">True</code> all rows are assumed to have the same height which
speeds up <a class="link" href="class-gtktreeview.html" title="gtk.TreeView"><code class="classname">gtk.TreeView</code></a>
displays. Only enable this option if all rows are the same height and all
columns are of type <code class="literal">gtk.TREE_VIEW_COLUMN_FIXED</code> (see the
<a class="xref" href="gtk-constants.html#gtk-treeviewcolumn-sizing-constants" title="GTK TreeViewColumn Sizing Constants">GTK TreeViewColumn Sizing Constants</a>).</p></div><div class="refsect2" title="gtk.TreeView.get_hover_selection"><a name="method-gtktreeview--get-hover-selection"></a><h3>gtk.TreeView.get_hover_selection</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_hover_selection</span>(<span class="methodparam"></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><code class="literal">True</code> if hover selection
mode is enabled.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.6 and above.</p></div><p>The <code class="methodname">get_hover_selection</code>() method
returns the value of the "hover-selection" property. If the
"hover-selection" property is <code class="literal">True</code> the selected row
follows the pointer. See the <a class="link" href="class-gtktreeview.html#method-gtktreeview--set-hover-selection" title="gtk.TreeView.set_hover_selection"><code class="methodname">set_hover_selection</code>()</a>
method for more detail.</p></div><div class="refsect2" title="gtk.TreeView.set_hover_selection"><a name="method-gtktreeview--set-hover-selection"></a><h3>gtk.TreeView.set_hover_selection</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_hover_selection</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>hover</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>hover</code></strong> :</span></p></td><td>if <code class="literal">True</code> enable hover
selection mode.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.6 and above.</p></div><p>The <code class="methodname"></code>() method sets the
"hover-selection" property to the value of <em class="parameter"><code>hover</code></em>. If
<em class="parameter"><code>hover</code></em> is <code class="literal">True</code> the hover selection
mode is enables and the selected row follows the pointer. Currently, this
works only for the selection modes <code class="literal">gtk.SELECTION_SINGLE</code>
and <code class="literal">gtk.SELECTION_BROWSE</code> (see the <a class="xref" href="gtk-constants.html#gtk-selection-mode-constants" title="GTK Selection Mode Constants">GTK Selection Mode Constants</a>).</p></div><div class="refsect2" title="gtk.TreeView.get_hover_expand"><a name="method-gtktreeview--get-hover-expand"></a><h3>gtk.TreeView.get_hover_expand</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_hover_expand</span>(<span class="methodparam"></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><code class="literal">True</code> if hover expand mode is
enabled</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.6 and above.</p></div><p>The <code class="methodname">get_hover_expand</code>() method returns
the value of the "hover-expand" property. If the "hover-expand" property is
<code class="literal">True</code> rows expand or collapse if the pointer moves over
them.</p></div><div class="refsect2" title="gtk.TreeView.set_hover_expand"><a name="method-gtktreeview--set-hover-expand"></a><h3>gtk.TreeView.set_hover_expand</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_hover_expand</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>expand</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>expand</code></strong> :</span></p></td><td>if <code class="literal">True</code> enable hover expand
mode.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.6 and above.</p></div><p>The <code class="methodname">set_hover_expand</code>() method sets the
"hover-expand" property to the value of <em class="parameter"><code>expand</code></em>. If
<em class="parameter"><code>expand</code></em> is <code class="literal">True</code>, rows expand or
collapse if the pointer moves over them. </p></div><div class="refsect2" title="gtk.TreeView.set_row_separator_func"><a name="method-gtktreeview--set-row-separator-func"></a><h3>gtk.TreeView.set_row_separator_func</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_row_separator_func</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>func</code></strong></span><span class="initializer">=None</span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>user_data</code></strong></span><span class="initializer">=None</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>func</code></strong> :</span></p></td><td>the row separator function or
<code class="literal">None</code></td></tr><tr><td><p><span class="term"><strong class="parameter"><code>user_data</code></strong> :</span></p></td><td>user data to pass to <em class="parameter"><code>func</code></em>, or <code class="literal">None</code></td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.6 and above.</p></div><p>The <code class="methodname">set_row_separator_func</code>() method
sets the row separator function to the function specified by
<em class="parameter"><code>func</code></em>. The row separator function is used to determine
if a row should be displayed as a separator. If
<em class="parameter"><code>user_data</code></em> is specified and not
<code class="literal">None</code>, it is passed to <em class="parameter"><code>func</code></em>. If
<em class="parameter"><code>func</code></em> is <code class="literal">None</code>, no separators will
be drawn. The signature of <em class="parameter"><code>func</code></em> is:</p><pre class="programlisting">
def func(<em class="parameter"><code>model</code></em>, <em class="parameter"><code>iter</code></em>, <em class="parameter"><code>data</code></em>)
</pre><p>where <em class="parameter"><code>model</code></em> is the <a class="link" href="class-gtktreemodel.html" title="gtk.TreeModel"><code class="classname">gtk.TreeModel</code></a> of
the <a class="link" href="class-gtktreeview.html" title="gtk.TreeView"><code class="classname">gtk.TreeView</code></a>,
<em class="parameter"><code>iter</code></em> is a <a class="link" href="class-gtktreeiter.html" title="gtk.TreeIter"><code class="classname">gtk.TreeIter</code></a>
pointing to the current candidate row and <em class="parameter"><code>data</code></em> is the
context data <em class="parameter"><code>user_data</code></em>. <em class="parameter"><code>func</code></em>
should return <code class="literal">True</code> to indicate that the row is a
separator.</p><p>A common way to implement this is to have a boolean column in
<em class="parameter"><code>model</code></em>, whose values <em class="parameter"><code>func</code></em>
returns.</p></div><div class="refsect2" title="gtk.TreeView.get_visible_range"><a name="method-gtktreeview--get-visible-range"></a><h3>gtk.TreeView.get_visible_range</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_visible_range</span>(<span class="methodparam"></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 2-tuple containing the start and end paths of
the visible region or <code class="literal">None</code>.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.10 and above.</p></div><p>The <code class="methodname">get_visible_range</code>() method returns
a 2-tuple containing the start and end paths for the visible region in the
treeview. If no valid paths are available this method returns
<code class="literal">None</code>.</p></div><div class="refsect2" title="gtk.TreeView.get_headers_clickable"><a name="method-gtktreeview--get-headers-clickable"></a><h3>gtk.TreeView.get_headers_clickable</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_headers_clickable</span>(<span class="methodparam"></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><code class="literal">True</code> if all header columns
are clickable</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.10 and above.</p></div><p>Returns <code class="literal">True</code> if all header columns are
clickable.</p></div><div class="refsect2" title="gtk.TreeView.get_search_entry"><a name="method-gtktreeview--get-search-entry"></a><h3>gtk.TreeView.get_search_entry</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_search_entry</span>(<span class="methodparam"></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 entry currently in use as the search
entry.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.10 and above.</p></div><p>Returns the <a class="link" href="class-gtkentry.html" title="gtk.Entry"><code class="classname">gtk.Entry</code></a> which
is currently in use as the interactive search entry for the treeview.
In case the built-in entry is being used, <code class="literal">None</code> will
be returned.</p></div><div class="refsect2" title="gtk.TreeView.set_search_entry"><a name="method-gtktreeview--set-search-entry"></a><h3>gtk.TreeView.set_search_entry</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_search_entry</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>entry</code></strong></span><span class="initializer">=None</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>entry</code></strong> :</span></p></td><td>the entry the interactive search code of the
treeview should use or
<code class="literal">None</code></td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.10 and above.</p></div><p>Sets the entry which the interactive search code will use for
this treeview. This is useful when you want to provide a search entry
in our interface at all time at a fixed position. Passing
<code class="literal">None</code> for <em class="parameter"><code>entry</code></em> will make the
interactive search code use the built-in popup entry again.</p></div><div class="refsect2" title="gtk.TreeView.set_search_position_func"><a name="method-gtktreeview--set-search-position-func"></a><h3>gtk.TreeView.set_search_position_func</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_search_position_func</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>func</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>data</code></strong></span><span class="initializer">=None</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>func</code></strong> :</span></p></td><td>the function to use to position the search
dialog, or <code class="literal">None</code> to use the default search
position function</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>data</code></strong> :</span></p></td><td>user data to pass to
<em class="parameter"><code>func</code></em>, or
<code class="literal">None</code></td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.10 and above.</p></div><p>Sets the function to use when positioning the search dialog. The
signature of <em class="parameter"><code>func</code></em> is:</p><pre class="programlisting">
def func(treeview, search_dialog, user_data):
</pre><p>where <em class="parameter"><code>search_dialog</code></em> is the dialog to be
positioned and <em class="parameter"><code>user_data</code></em> is
<em class="parameter"><code>data</code></em>.</p></div><div class="refsect2" title="gtk.TreeView.set_rubber_banding"><a name="method-gtktreeview--set-rubber-banding"></a><h3>gtk.TreeView.set_rubber_banding</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_rubber_banding</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>enable</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>enable</code></strong> :</span></p></td><td>if <code class="literal">True</code> enable rubber
banding</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.10 and above.</p></div><p>Enables or disables rubber banding. If the selection mode is
<code class="literal">gtk.SELECTION_MULTIPLE</code>, rubber banding will allow
the user to select multiple rows by dragging the mouse.</p></div><div class="refsect2" title="gtk.TreeView.get_rubber_banding"><a name="method-gtktreeview--get-rubber-banding"></a><h3>gtk.TreeView.get_rubber_banding</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_rubber_banding</span>(<span class="methodparam"></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><code class="literal">True</code> if rubber banding is
enabled.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.10 and above.</p></div><p>Returns whether rubber banding is enabled. If the selection
mode is <code class="literal">gtk.SELECTION_MULTIPLE</code>, rubber banding will
allow the user to select multiple rows by dragging the mouse.</p></div><div class="refsect2" title="gtk.TreeView.get_grid_lines"><a name="method-gtktreeview--get-grid-lines"></a><h3>gtk.TreeView.get_grid_lines</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_grid_lines</span>(<span class="methodparam"></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>one of the <a class="xref" href="gtk-constants.html#gtk-treeview-grid-lines-constants" title="GTK TreeView Grid Lines Constants">GTK TreeView Grid Lines Constants</a>
indicating which grid lines are enabled.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.10 and above.</p></div><p>Returns which grid lines are enabled.</p></div><div class="refsect2" title="gtk.TreeView.set_grid_lines"><a name="method-gtktreeview--set-grid-lines"></a><h3>gtk.TreeView.set_grid_lines</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_grid_lines</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>grid_lines</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>grid_lines</code></strong> :</span></p></td><td>one of the <a class="xref" href="gtk-constants.html#gtk-treeview-grid-lines-constants" title="GTK TreeView Grid Lines Constants">GTK TreeView Grid Lines Constants</a>
indicating which grid lines to enable.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.10 and above.</p></div><p>Sets which grid lines to draw.</p></div><div class="refsect2" title="gtk.TreeView.get_enable_tree_lines"><a name="method-gtktreeview--get-enable-tree-lines"></a><h3>gtk.TreeView.get_enable_tree_lines</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_enable_tree_lines</span>(<span class="methodparam"></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><code class="literal">True</code> if tree lines are
drawn.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.10 and above.</p></div><p>Returns <code class="literal">True</code> if tree lines are drawn.</p></div><div class="refsect2" title="gtk.TreeView.set_enable_tree_lines"><a name="method-gtktreeview--set-enable-tree-lines"></a><h3>gtk.TreeView.set_enable_tree_lines</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_enable_tree_lines</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>enabled</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>enabled</code></strong> :</span></p></td><td>if <code class="literal">True</code> enable tree line
drawing.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.10 and above.</p></div><p>Sets whether to draw lines interconnecting the expanders. This
does not have any visible effects for lists.</p></div><div class="refsect2" title="gtk.TreeView.convert_widget_to_bin_window_coords"><a name="method-gtktreeview--convert-widget-to-bin-window-coords"></a><h3>gtk.TreeView.convert_widget_to_bin_window_coords</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">convert_widget_to_bin_window_coords</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>widget_x</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>widget_y</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>widget_x</code></strong> :</span></p></td><td>X coordinate relative to the widget.</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>widget_y</code></strong> :</span></p></td><td>Y coordinate relative to the widget.</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>A tuple containing the bin_window X and Y coordinates.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.12 and above.</p></div><p>
Converts widget coordinates to coordinates for the bin_window (see <code class="methodname"><a class="link" href="class-gtktreeview.html#method-gtktreeview--get-bin-window" title="gtk.TreeView.get_bin_window">get_bin_window</a></code>).
</p></div><div class="refsect2" title="gtk.TreeView.convert_widget_to_tree_coords"><a name="method-gtktreeview--convert-widget-to-tree-coords"></a><h3>gtk.TreeView.convert_widget_to_tree_coords</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">convert_widget_to_tree_coords</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>widget_x</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>widget_y</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>widget_x</code></strong> :</span></p></td><td>X coordinate relative to the widget.</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>widget_y</code></strong> :</span></p></td><td>Y coordinate relative to the widget.</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>A tuple containing the tree X and Y coordinates.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.12 and above.</p></div><p>
Converts widget coordinates to coordinates for the tree (the full scrollable area of the tree).
</p></div><div class="refsect2" title="gtk.TreeView.convert_tree_to_widget_coords"><a name="method-gtktreeview--convert-tree-to-widget-coords"></a><h3>gtk.TreeView.convert_tree_to_widget_coords</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">convert_tree_to_widget_coords</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>tree_x</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>tree_y</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>tree_x</code></strong> :</span></p></td><td>X coordinate relative to the tree.</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>tree_y</code></strong> :</span></p></td><td>Y coordinate relative to the tree.</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>A tuple containing the widget X and Y coordinates.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.12 and above.</p></div><p>
Converts tree coordinates (coordinates in full scrollable area of the tree) to widget coordinates.
</p></div><div class="refsect2" title="gtk.TreeView.convert_tree_to_bin_window_coords"><a name="method-gtktreeview--convert-tree-to-bin-window-coords"></a><h3>gtk.TreeView.convert_tree_to_bin_window_coords</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">convert_tree_to_bin_window_coords</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>tree_x</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>tree_y</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>tree_x</code></strong> :</span></p></td><td>X coordinate relative to the tree.</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>tree_y</code></strong> :</span></p></td><td>Y coordinate relative to the tree.</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>A tuple containing the bin window X and Y coordinates.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.12 and above.</p></div><p>
Converts tree coordinates (coordinates in full scrollable area of the tree) to bin_window coordinates.
</p></div><div class="refsect2" title="gtk.TreeView.convert_bin_window_to_widget_coords"><a name="method-gtktreeview--convert-bin-window-to-widget-coords"></a><h3>gtk.TreeView.convert_bin_window_to_widget_coords</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">convert_bin_window_to_widget_coords</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>window_x</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>window_y</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>window_x</code></strong> :</span></p></td><td>X coordinate relative to the bin window.</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>window_y</code></strong> :</span></p></td><td>Y coordinate relative to the bin window.</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>A tuple containing the widget X and Y coordinates.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.12 and above.</p></div><p>
Converts bin window coordinates (see <code class="methodname"><a class="link" href="class-gtktreeview.html#method-gtktreeview--get-bin-window" title="gtk.TreeView.get_bin_window">get_bin_window</a></code>)
to widget relative coordinates.
</p></div><div class="refsect2" title="gtk.TreeView.convert_bin_window_to_tree_coords"><a name="method-gtktreeview--convert-bin-window-to-tree-coords"></a><h3>gtk.TreeView.convert_bin_window_to_tree_coords</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">convert_bin_window_to_tree_coords</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>window_x</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>window_y</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>window_x</code></strong> :</span></p></td><td>X coordinate relative to the bin window.</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>window_y</code></strong> :</span></p></td><td>Y coordinate relative to the bin window.</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>A tuple containing the tree X and Y coordinates.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.12 and above.</p></div><p>
Converts bin window coordinates (see <code class="methodname"><a class="link" href="class-gtktreeview.html#method-gtktreeview--get-bin-window" title="gtk.TreeView.get_bin_window">get_bin_window</a></code>)
to the tree (the full scrollable area of the tree).
</p></div><div class="refsect2" title="gtk.TreeView.get_level_indentation"><a name="method-gtktreeview--get-level-indentation"></a><h3>gtk.TreeView.get_level_indentation</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_level_indentation</span>(<span class="methodparam"></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 amount of extra indentation for child levels in tree_view.
A return value of 0 means that this feature is disabled.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.12 and above.</p></div><p>
Returns the amount, in pixels, of extra indentation for child levels in tree_view.
</p></div><div class="refsect2" title="gtk.TreeView.set_level_indentation"><a name="method-gtktreeview--set-level-indentation"></a><h3>gtk.TreeView.set_level_indentation</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_level_indentation</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>indentation</code></strong></span></span>, <span class="methodparam"></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>indentation</code></strong> :</span></p></td><td>the amount, in pixels, of extra indentation in tree_view.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.12 and above.</p></div><p>
Sets the amount of extra indentation for child levels to use in tree_view
in addition to the default indentation. The value should be specified in pixels,
a value of 0 disables this feature and in this case only the default indentation
will be used. This does not have any visible effects for lists.
</p></div><div class="refsect2" title="gtk.TreeView.get_show_expanders"><a name="method-gtktreeview--get-show-expanders"></a><h3>gtk.TreeView.get_show_expanders</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_show_expanders</span>(<span class="methodparam"></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><code class="literal">True</code> if expanders are drawn
in tree_view, <code class="literal">False</code> otherwise.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.12 and above.</p></div><p>
Returns whether or not expanders are drawn in tree_view.
</p></div><div class="refsect2" title="gtk.TreeView.set_show_expanders"><a name="method-gtktreeview--set-show-expanders"></a><h3>gtk.TreeView.set_show_expanders</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_show_expanders</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>enabled</code></strong></span></span>, <span class="methodparam"></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>indentation</code></strong> :</span></p></td><td><code class="literal">True</code> to enable expander drawing, <code class="literal">False</code> otherwise.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.12 and above.</p></div><p>
Sets whether to draw and enable expanders and indent child rows in tree_view.
When disabled there will be no expanders visible in trees and there will be
no way to expand and collapse rows by default. Also note that hiding the expanders
will disable the default indentation. You can set a custom indentation in this case using
gtk_tree_view_set_level_indentation().
This does not have any visible effects for lists.
</p></div><div class="refsect2" title="gtk.TreeView.get_tooltip_column"><a name="method-gtktreeview--get-tooltip-column"></a><h3>gtk.TreeView.get_tooltip_column</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_tooltip_column</span>(<span class="methodparam"></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 index of the tooltip column that is currently
being used, or -1 if this is disabled.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.12 and above.</p></div><p>
Returns the column of tree_view's model which is being used for
displaying tooltips on tree_view's rows.
</p></div><div class="refsect2" title="gtk.TreeView.set_tooltip_column"><a name="method-gtktreeview--set-tooltip-column"></a><h3>gtk.TreeView.set_tooltip_column</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_tooltip_column</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>column</code></strong></span></span>, <span class="methodparam"></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>column</code></strong> :</span></p></td><td>an integer, which is a valid column number
for tree_view's model</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.12 and above.</p></div><p>
If you only plan to have simple (text-only) tooltips on full rows, you can
use this function to have GtkTreeView handle these automatically for you.
column should be set to the column in tree_view's model containing the
tooltip texts, or -1 to disable this feature.
</p><p>
When enabled, GtkWidget::has-tooltip will be set to <code class="literal">True</code>
and tree_view will connect a GtkWidget::query-tooltip signal handler.
</p></div><div class="refsect2" title="gtk.TreeView.is_rubber_banding_active"><a name="method-gtktreeview--is-rubber-banding-active"></a><h3>gtk.TreeView.is_rubber_banding_active</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">is_rubber_banding_active</span>(<span class="methodparam"></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><code class="literal">True</code> if a rubber banding
operation is currently being done in tree_view.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.12 and above.</p></div><p>
Returns whether a rubber banding operation is currently being done in tree_view.
</p></div><div class="refsect2" title="gtk.TreeView.set_tooltip_cell"><a name="method-gtktreeview--set-tooltip-cell"></a><h3>gtk.TreeView.set_tooltip_cell</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_tooltip_cell</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>tooltip</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>path</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>column</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>cell</code></strong></span></span>, <span class="methodparam"></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>tooltip</code></strong> :</span></p></td><td>a <code class="classname"><a class="link" href="class-gtktooltip.html" title="gtk.Tooltip">gtk.Tooltip</a></code>.
</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>path</code></strong> :</span></p></td><td>a tree path or <code class="literal">None</code>.</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>column</code></strong> :</span></p></td><td>a <code class="classname"><a class="link" href="class-gtktreeviewcolumn.html" title="gtk.TreeViewColumn">gtk.TreeViewColumn</a></code>
or <code class="literal">None</code>.</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>cell</code></strong> :</span></p></td><td>a <code class="classname"><a class="link" href="class-gtkcellrenderer.html" title="gtk.CellRenderer">gtk.CellRenderer</a></code>
or <code class="literal">None</code>.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.12 and above.</p></div><p>
Sets the tip area of tooltip to the area path, column and cell have in common.
For example if path is <code class="literal">None</code> and column is set, the tip
area will be set to the full area covered by column.
</p></div><div class="refsect2" title="gtk.TreeView.set_tooltip_row"><a name="method-gtktreeview--set-tooltip-row"></a><h3>gtk.TreeView.set_tooltip_row</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_tooltip_row</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>tooltip</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>path</code></strong></span></span>, <span class="methodparam"></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>tooltip</code></strong> :</span></p></td><td>a <code class="classname"><a class="link" href="class-gtktooltip.html" title="gtk.Tooltip">gtk.Tooltip</a></code>.
</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>path</code></strong> :</span></p></td><td>a tree path.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.12 and above.</p></div><p>
Sets the tip area of tooltip to be the area covered by the row at path.
</p></div></div><div class="refsect1" title="Signals"><a name="id4055636"></a><h2>Signals</h2><div class="refsect2" title='The "columns-changed" gtk.TreeView Signal'><a name="signal-gtktreeview--columns-changed"></a><h3>The "columns-changed" gtk.TreeView Signal</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>treeview</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</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>treeview</code></em> :</span></p></td><td>the treeview that received the
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>user_param1</code></em> :</span></p></td><td>the first user parameter (if any) specified
with the <PYGTKDOCLINK HREF="method-gobject--connect"><code class="methodname">connect</code>()</PYGTKDOCLINK>
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 "columns-changed" signal is emitted when a column has been
added to, removed from or moved in <em class="parameter"><code>treeview</code></em>.</p></div><div class="refsect2" title='The "cursor-changed" gtk.TreeView Signal'><a name="signal-gtktreeview--cursor-changed"></a><h3>The "cursor-changed" gtk.TreeView Signal</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>treeview</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</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>treeview</code></em> :</span></p></td><td>the treeview that received the
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>user_param1</code></em> :</span></p></td><td>the first user parameter (if any) specified
with the <PYGTKDOCLINK HREF="method-gobject--connect"><code class="methodname">connect</code>()</PYGTKDOCLINK>
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 "cursor-changed" signal is emitted when the cursor moves or
is set.</p></div><div class="refsect2" title='The "expand-collapse-cursor-row" gtk.TreeView Signal'><a name="signal-gtktreeview--expand-collapse-cursor-row"></a><h3>The "expand-collapse-cursor-row" gtk.TreeView Signal</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>treeview</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>logical</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>expand</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>open_all</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</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>treeview</code></em> :</span></p></td><td>the treeview that received the
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>logical</code></em> :</span></p></td><td>if <code class="literal">True</code>
</td></tr><tr><td><p><span class="term"><em class="parameter"><code>expand</code></em> :</span></p></td><td>if <code class="literal">True</code> the row should be
expanded</td></tr><tr><td><p><span class="term"><em class="parameter"><code>open_all</code></em> :</span></p></td><td>if <code class="literal">True</code> recursively expand
all children</td></tr><tr><td><p><span class="term"><em class="parameter"><code>user_param1</code></em> :</span></p></td><td>the first user parameter (if any) specified
with the <PYGTKDOCLINK HREF="method-gobject--connect"><code class="methodname">connect</code>()</PYGTKDOCLINK>
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"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td><code class="literal">True</code> if the signal was
handled.</td></tr></tbody></table><p>The "expand-collapse-cursor-row" signal is emitted when the row
at the cursor needs to be expanded or collapsed.</p></div><div class="refsect2" title='The "move-cursor" gtk.TreeView Signal'><a name="signal-gtktreeview--move-cursor"></a><h3>The "move-cursor" gtk.TreeView Signal</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>treeview</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>step</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>count</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</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>treeview</code></em> :</span></p></td><td>the treeview that received the
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>step</code></em> :</span></p></td><td>the movement step size</td></tr><tr><td><p><span class="term"><em class="parameter"><code>count</code></em> :</span></p></td><td>the number of steps to
take</td></tr><tr><td><p><span class="term"><em class="parameter"><code>user_param1</code></em> :</span></p></td><td>the first user parameter (if any) specified
with the <PYGTKDOCLINK HREF="method-gobject--connect"><code class="methodname">connect</code>()</PYGTKDOCLINK>
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"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td><code class="literal">True</code> if the signal was
handled.</td></tr></tbody></table><p>The "move-cursor" signal is emitted when the user moves the
cursor using the <span class="keycap"><strong>Right</strong></span>, <span class="keycap"><strong>Left</strong></span>,
<span class="keycap"><strong>Up</strong></span> or <span class="keycap"><strong>Down</strong></span> arrow keys or the
<span class="keycap"><strong>Page Up</strong></span>, <span class="keycap"><strong>Page Down</strong></span>, <span class="keycap"><strong>Home</strong></span>
and <span class="keycap"><strong>End</strong></span> keys.</p></div><div class="refsect2" title='The "row-activated" gtk.TreeView Signal'><a name="signal-gtktreeview--row-activated"></a><h3>The "row-activated" gtk.TreeView Signal</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>treeview</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>path</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>view_column</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</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>treeview</code></em> :</span></p></td><td>the treeview that received the
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>path</code></em> :</span></p></td><td>the path of the activated
row</td></tr><tr><td><p><span class="term"><em class="parameter"><code>view_column</code></em> :</span></p></td><td>the column in the activated
row</td></tr><tr><td><p><span class="term"><em class="parameter"><code>user_param1</code></em> :</span></p></td><td>the first user parameter (if any) specified
with the <PYGTKDOCLINK HREF="method-gobject--connect"><code class="methodname">connect</code>()</PYGTKDOCLINK>
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 "row-activated" signal is emitted when the <a class="link" href="class-gtktreeview.html#method-gtktreeview--row-activated" title="gtk.TreeView.row_activated"><code class="methodname">row_activated</code>()</a>
method is called or the user double clicks a <em class="parameter"><code>treeview</code></em>
row. "row-activated" is also emitted when a non-editable row is selected and
one of the keys: <span class="keycap"><strong>Space</strong></span>, <span class="keycap"><strong>Shift</strong></span>+<span class="keycap"><strong>Space</strong></span>,
<span class="keycap"><strong>Return</strong></span> or <span class="keycap"><strong>Enter</strong></span> is pressed.</p></div><div class="refsect2" title='The "row-collapsed" gtk.TreeView Signal'><a name="signal-gtktreeview--row-collapsed"></a><h3>The "row-collapsed" gtk.TreeView Signal</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>treeview</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>iter</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>path</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</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>treeview</code></em> :</span></p></td><td>the treeview that received the
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>iter</code></em> :</span></p></td><td>a <a class="link" href="class-gtktreeiter.html" title="gtk.TreeIter"><code class="classname">gtk.TreeIter</code></a>
pointing to the row that collapsed</td></tr><tr><td><p><span class="term"><em class="parameter"><code>path</code></em> :</span></p></td><td>the path of the row that
collapsed</td></tr><tr><td><p><span class="term"><em class="parameter"><code>user_param1</code></em> :</span></p></td><td>the first user parameter (if any) specified
with the <PYGTKDOCLINK HREF="method-gobject--connect"><code class="methodname">connect</code>()</PYGTKDOCLINK>
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 "row-collapsed" signal is emitted when a row is collapsed by
user of programmatic action.</p></div><div class="refsect2" title='The "row-expanded" gtk.TreeView Signal'><a name="signal-gtktreeview--row-expanded"></a><h3>The "row-expanded" gtk.TreeView Signal</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>treeview</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>iter</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>path</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</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>treeview</code></em> :</span></p></td><td>the treeview that received the
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>iter</code></em> :</span></p></td><td>a <a class="link" href="class-gtktreeiter.html" title="gtk.TreeIter"><code class="classname">gtk.TreeIter</code></a>
pointing to the row that expanded</td></tr><tr><td><p><span class="term"><em class="parameter"><code>path</code></em> :</span></p></td><td>the path of the row that
expanded</td></tr><tr><td><p><span class="term"><em class="parameter"><code>user_param1</code></em> :</span></p></td><td>the first user parameter (if any) specified
with the <PYGTKDOCLINK HREF="method-gobject--connect"><code class="methodname">connect</code>()</PYGTKDOCLINK>
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 "row-expanded" signal is emitted when a row is expanded via
user or programmatic action.</p></div><div class="refsect2" title='The "select-all" gtk.TreeView Signal'><a name="signal-gtktreeview--select-all"></a><h3>The "select-all" gtk.TreeView Signal</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>treeview</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</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>treeview</code></em> :</span></p></td><td>the treeview that received the
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>user_param1</code></em> :</span></p></td><td>the first user parameter (if any) specified
with the <PYGTKDOCLINK HREF="method-gobject--connect"><code class="methodname">connect</code>()</PYGTKDOCLINK>
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"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td><code class="literal">True</code> if the signal was
handled.</td></tr></tbody></table><p>The "select-all" signal is emitted when the user presses
<span class="keycap"><strong>Control</strong></span>+<span class="keycap"><strong>a</strong></span> or <span class="keycap"><strong>Control</strong></span>+<span class="keycap"><strong>/</strong></span>.</p></div><div class="refsect2" title='The "select-cursor-parent" gtk.TreeView Signal'><a name="signal-gtktreeview--select-cursor-parent"></a><h3>The "select-cursor-parent" gtk.TreeView Signal</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>treeview</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</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>treeview</code></em> :</span></p></td><td>the treeview that received the
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>user_param1</code></em> :</span></p></td><td>the first user parameter (if any) specified
with the <PYGTKDOCLINK HREF="method-gobject--connect"><code class="methodname">connect</code>()</PYGTKDOCLINK>
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"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td><code class="literal">True</code> if the signal was
handled.</td></tr></tbody></table><p>The "select-cursor-parent" signal is emitted when the user
presses <span class="keycap"><strong>Backspace</strong></span> while
a row has the cursor.</p></div><div class="refsect2" title='The "select-cursor-row" gtk.TreeView Signal'><a name="signal-gtktreeview--select-cursor-row"></a><h3>The "select-cursor-row" gtk.TreeView Signal</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>treeview</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>start_editing</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</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>treeview</code></em> :</span></p></td><td>the treeview that received the
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>start_editing</code></em> :</span></p></td><td>if <code class="literal">True</code> the cell editing is
started</td></tr><tr><td><p><span class="term"><em class="parameter"><code>user_param1</code></em> :</span></p></td><td>the first user parameter (if any) specified
with the <PYGTKDOCLINK HREF="method-gobject--connect"><code class="methodname">connect</code>()</PYGTKDOCLINK>
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"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td><code class="literal">True</code> if the signal was
handled.</td></tr></tbody></table><p>The "select-cursor-row" signal is emitted when a non-editable
row is selected and one of the keys: <span class="keycap"><strong>Space</strong></span>, <span class="keycap"><strong>Shift</strong></span>+<span class="keycap"><strong>Space</strong></span>,
<span class="keycap"><strong>Return</strong></span> or <span class="keycap"><strong>Enter</strong></span> is pressed.</p></div><div class="refsect2" title='The "set-scroll-adjustments" gtk.TreeView Signal'><a name="signal-gtktreeview--set-scroll-adjustments"></a><h3>The "set-scroll-adjustments" gtk.TreeView Signal</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>treeview</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>hadjustment</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>vadjustment</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</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>treeview</code></em> :</span></p></td><td>the treeview that received the
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>hadjustment</code></em> :</span></p></td><td>a horizontal <a class="link" href="class-gtkadjustment.html" title="gtk.Adjustment"><code class="classname">gtk.Adjustment</code></a></td></tr><tr><td><p><span class="term"><em class="parameter"><code>vadjustment</code></em> :</span></p></td><td>a vertical <a class="link" href="class-gtkadjustment.html" title="gtk.Adjustment"><code class="classname">gtk.Adjustment</code></a></td></tr><tr><td><p><span class="term"><em class="parameter"><code>user_param1</code></em> :</span></p></td><td>the first user parameter (if any) specified
with the <PYGTKDOCLINK HREF="method-gobject--connect"><code class="methodname">connect</code>()</PYGTKDOCLINK>
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"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td><code class="literal">True</code> if the signal was
handled.</td></tr></tbody></table><p>The "set-scroll-adjustments" signal is emitted when new
horizontal or vertical adjustments are set on the
<em class="parameter"><code>treeview</code></em>.</p></div><div class="refsect2" title='The "start-interactive-search" gtk.TreeView Signal'><a name="signal-gtktreeview--start-interactive-search"></a><h3>The "start-interactive-search" gtk.TreeView Signal</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>treeview</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</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>treeview</code></em> :</span></p></td><td>the treeview that received the
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>user_param1</code></em> :</span></p></td><td>the first user parameter (if any) specified
with the <PYGTKDOCLINK HREF="method-gobject--connect"><code class="methodname">connect</code>()</PYGTKDOCLINK>
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"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td><code class="literal">True</code> if the signal was
handled.</td></tr></tbody></table><p>The "start-interactive-search" signal is emitted when the user
presses <span class="keycap"><strong>Control</strong></span>+<span class="keycap"><strong>f</strong></span>.</p></div><div class="refsect2" title='The "test-collapse-row" gtk.TreeView Signal'><a name="signal-gtktreeview--test-collapse-row"></a><h3>The "test-collapse-row" gtk.TreeView Signal</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>treeview</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>iter</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>path</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</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>treeview</code></em> :</span></p></td><td>the treeview that received the
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>iter</code></em> :</span></p></td><td>the <a class="link" href="class-gtktreeiter.html" title="gtk.TreeIter"><code class="classname">gtk.TreeIter</code></a>
pointing at the row to test.</td></tr><tr><td><p><span class="term"><em class="parameter"><code>path</code></em> :</span></p></td><td>the path of the row to be
tested</td></tr><tr><td><p><span class="term"><em class="parameter"><code>user_param1</code></em> :</span></p></td><td>the first user parameter (if any) specified
with the <PYGTKDOCLINK HREF="method-gobject--connect"><code class="methodname">connect</code>()</PYGTKDOCLINK>
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"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td><code class="literal">True</code> if the row should be
collapsed.</td></tr></tbody></table><p>The "test-collapse-row" signal is emitted when the row pointed
to by <em class="parameter"><code>iter</code></em> and <em class="parameter"><code>path</code></em> is to be
collapsed.</p></div><div class="refsect2" title='The "test-expand-row" gtk.TreeView Signal'><a name="signal-gtktreeview--test-expand-row"></a><h3>The "test-expand-row" gtk.TreeView Signal</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>treeview</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>iter</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>path</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</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>treeview</code></em> :</span></p></td><td>the treeview that received the
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>iter</code></em> :</span></p></td><td>the <a class="link" href="class-gtktreeiter.html" title="gtk.TreeIter"><code class="classname">gtk.TreeIter</code></a>
pointing at the row to test.</td></tr><tr><td><p><span class="term"><em class="parameter"><code>path</code></em> :</span></p></td><td>the path of the row to
test</td></tr><tr><td><p><span class="term"><em class="parameter"><code>user_param1</code></em> :</span></p></td><td>the first user parameter (if any) specified
with the <PYGTKDOCLINK HREF="method-gobject--connect"><code class="methodname">connect</code>()</PYGTKDOCLINK>
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"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td><code class="literal">True</code> if the row should be
expanded.</td></tr></tbody></table><p>The "test-expand-row" signal is emitted when the row pointed to
by <em class="parameter"><code>iter</code></em> and <em class="parameter"><code>path</code></em> is to be
expanded.</p></div><div class="refsect2" title='The "toggle-cursor-row" gtk.TreeView Signal'><a name="signal-gtktreeview--toggle-cursor-row"></a><h3>The "toggle-cursor-row" gtk.TreeView Signal</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>treeview</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</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>treeview</code></em> :</span></p></td><td>the treeview that received the
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>user_param1</code></em> :</span></p></td><td>the first user parameter (if any) specified
with the <PYGTKDOCLINK HREF="method-gobject--connect"><code class="methodname">connect</code>()</PYGTKDOCLINK>
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"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td><code class="literal">True</code> if the signal was
handled.</td></tr></tbody></table><p>The "toggle-cursor-row" signal is emitted when the user presses
<span class="keycap"><strong>Control</strong></span>+<span class="keycap"><strong>Space</strong></span>.</p></div><div class="refsect2" title='The "unselect-all" gtk.TreeView Signal'><a name="signal-gtktreeview--unselect-all"></a><h3>The "unselect-all" gtk.TreeView Signal</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>treeview</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</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>treeview</code></em> :</span></p></td><td>the treeview that received the
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>user_param1</code></em> :</span></p></td><td>the first user parameter (if any) specified
with the <PYGTKDOCLINK HREF="method-gobject--connect"><code class="methodname">connect</code>()</PYGTKDOCLINK>
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"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td><code class="literal">True</code> if the signal was
handled.</td></tr></tbody></table><p>The "unselect-all" signal is emitted when the user presses
<span class="keycap"><strong>Shift</strong></span>+<span class="keycap"><strong>Control</strong></span>+<span class="keycap"><strong>a</strong></span> or <span class="keycap"><strong>Shift</strong></span>+<span class="keycap"><strong>Control</strong></span>+<span class="keycap"><strong>/</strong></span>.</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-gtktreestore.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="gtk-class-reference.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="class-gtktreeviewcolumn.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">gtk.TreeStore </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> gtk.TreeViewColumn</td></tr></table></div></body></html>
|