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
|
<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>gtk.TreeView</title><meta name="generator" content="DocBook XSL Stylesheets V1.65.1"><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="previous" 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" lang="en"><a name="class-gtktreeview"></a><div class="titlepage"><div></div><div></div></div><div class="refnamediv"><h2>gtk.TreeView</h2><p>gtk.TreeView — a widget for displaying both trees and lists.</p></div><div class="refsect1" lang="en"><a name="id3595023"></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 href="class-gtkcontainer.html" title="gtk.Container">gtk.Container</a></span></span>):
<code class="constructorsynopsis"> <span class="methodname"><a href="class-gtktreeview.html#constructor-gtktreeview" title="Constructor">gtk.TreeView</a></span>(<span class="methodparam"><span class="parameter"><b class="parameter"><tt>model</tt></b></span><span class="initializer">=None</span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a 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 href="class-gtktreeview.html#method-gtktreeview--set-model" title="gtk.TreeView.set_model">set_model</a></span>(<span class="methodparam"><span class="parameter"><b class="parameter"><tt>model</tt></b></span><span class="initializer">=None</span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a 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 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 href="class-gtktreeview.html#method-gtktreeview--set-hadjustment" title="gtk.TreeView.set_hadjustment">set_hadjustment</a></span>(<span class="methodparam"><span class="parameter"><b class="parameter"><tt>adjustment</tt></b></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a 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 href="class-gtktreeview.html#method-gtktreeview--set-vadjustment" title="gtk.TreeView.set_vadjustment">set_vadjustment</a></span>(<span class="methodparam"><span class="parameter"><b class="parameter"><tt>adjustment</tt></b></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a 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 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"><b class="parameter"><tt>headers_visible</tt></b></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a 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 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"><b class="parameter"><tt>active</tt></b></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a 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"><b class="parameter"><tt>setting</tt></b></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a 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 href="class-gtktreeview.html#method-gtktreeview--append-column" title="gtk.TreeView.append_column">append_column</a></span>(<span class="methodparam"><span class="parameter"><b class="parameter"><tt>column</tt></b></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a href="class-gtktreeview.html#method-gtktreeview--remove-column" title="gtk.TreeView.remove_column">remove_column</a></span>(<span class="methodparam"><span class="parameter"><b class="parameter"><tt>column</tt></b></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a href="class-gtktreeview.html#method-gtktreeview--insert-column" title="gtk.TreeView.insert_column">insert_column</a></span>(<span class="methodparam"><span class="parameter"><b class="parameter"><tt>column</tt></b></span></span>, <span class="methodparam"><span class="parameter"><b class="parameter"><tt>position</tt></b></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a 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"><i class="parameter"><tt>position</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>title</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>cell</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>...</tt></i></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a 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"><i class="parameter"><tt>position</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>title</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>cell</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>func</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>data</tt></i></span><span class="initializer">=None</span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a href="class-gtktreeview.html#method-gtktreeview--get-column" title="gtk.TreeView.get_column">get_column</a></span>(<span class="methodparam"><span class="parameter"><b class="parameter"><tt>n</tt></b></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a 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 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"><b class="parameter"><tt>column</tt></b></span></span>, <span class="methodparam"><span class="parameter"><b class="parameter"><tt>base_column</tt></b></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a 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"><b class="parameter"><tt>column</tt></b></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a 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 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"><b class="parameter"><tt>func</tt></b></span></span>, <span class="methodparam"><span class="parameter"><b class="parameter"><tt>user_data</tt></b></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a 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"><b class="parameter"><tt>tree_x</tt></b></span></span>, <span class="methodparam"><span class="parameter"><b class="parameter"><tt>tree_y</tt></b></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a 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"><b class="parameter"><tt>path</tt></b></span></span>, <span class="methodparam"><span class="parameter"><b class="parameter"><tt>column</tt></b></span></span>, <span class="methodparam"><span class="parameter"><b class="parameter"><tt>use_align</tt></b></span></span>, <span class="methodparam"><span class="parameter"><b class="parameter"><tt>row_align</tt></b></span></span>, <span class="methodparam"><span class="parameter"><b class="parameter"><tt>col_align</tt></b></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a href="class-gtktreeview.html#method-gtktreeview--row-activated" title="gtk.TreeView.row_activated">row_activated</a></span>(<span class="methodparam"><span class="parameter"><b class="parameter"><tt>path</tt></b></span></span>, <span class="methodparam"><span class="parameter"><b class="parameter"><tt>column</tt></b></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a 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 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 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"><b class="parameter"><tt>path</tt></b></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a href="class-gtktreeview.html#method-gtktreeview--expand-row" title="gtk.TreeView.expand_row">expand_row</a></span>(<span class="methodparam"><span class="parameter"><b class="parameter"><tt>path</tt></b></span></span>, <span class="methodparam"><span class="parameter"><b class="parameter"><tt>open_all</tt></b></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a href="class-gtktreeview.html#method-gtktreeview--collapse-row" title="gtk.TreeView.collapse_row">collapse_row</a></span>(<span class="methodparam"><span class="parameter"><b class="parameter"><tt>path</tt></b></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a 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"><b class="parameter"><tt>func</tt></b></span></span>, <span class="methodparam"><span class="parameter"><b class="parameter"><tt>data</tt></b></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a href="class-gtktreeview.html#method-gtktreeview--row-expanded" title="gtk.TreeView.row_expanded">row_expanded</a></span>(<span class="methodparam"><span class="parameter"><b class="parameter"><tt>path</tt></b></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a href="class-gtktreeview.html#method-gtktreeview--set-reorderable" title="gtk.TreeView.set_reorderable">set_reorderable</a></span>(<span class="methodparam"><span class="parameter"><b class="parameter"><tt>reorderable</tt></b></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a 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 href="class-gtktreeview.html#method-gtktreeview--set-cursor" title="gtk.TreeView.set_cursor">set_cursor</a></span>(<span class="methodparam"><span class="parameter"><b class="parameter"><tt>path</tt></b></span></span>, <span class="methodparam"><span class="parameter"><b class="parameter"><tt>focus_column</tt></b></span><span class="initializer">=None</span></span>, <span class="methodparam"><span class="parameter"><b class="parameter"><tt>start_editing</tt></b></span><span class="initializer">=False</span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a 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"><b class="parameter"><tt>path</tt></b></span></span>, <span class="methodparam"><span class="parameter"><b class="parameter"><tt>focus_column</tt></b></span><span class="initializer">=None</span></span>, <span class="methodparam"><span class="parameter"><b class="parameter"><tt>focus_cell</tt></b></span><span class="initializer">=None</span></span>, <span class="methodparam"><span class="parameter"><b class="parameter"><tt>start_editing</tt></b></span><span class="initializer">=False</span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a 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 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 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"><b class="parameter"><tt>x</tt></b></span></span>, <span class="methodparam"><span class="parameter"><b class="parameter"><tt>y</tt></b></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a 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"><b class="parameter"><tt>path</tt></b></span></span>, <span class="methodparam"><span class="parameter"><b class="parameter"><tt>column</tt></b></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a 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"><b class="parameter"><tt>path</tt></b></span></span>, <span class="methodparam"><span class="parameter"><b class="parameter"><tt>column</tt></b></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a 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 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"><i class="parameter"><tt>wx</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>wy</tt></i></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a 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"><i class="parameter"><tt>tx</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>ty</tt></i></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a 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"><b class="parameter"><tt>start_button_mask</tt></b></span></span>, <span class="methodparam"><span class="parameter"><b class="parameter"><tt>targets</tt></b></span></span>, <span class="methodparam"><span class="parameter"><b class="parameter"><tt>actions</tt></b></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a 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"><b class="parameter"><tt>targets</tt></b></span></span>, <span class="methodparam"><span class="parameter"><b class="parameter"><tt>actions</tt></b></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a 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 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 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"><b class="parameter"><tt>path</tt></b></span></span>, <span class="methodparam"><span class="parameter"><b class="parameter"><tt>pos</tt></b></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a 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 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"><b class="parameter"><tt>x</tt></b></span></span>, <span class="methodparam"><span class="parameter"><b class="parameter"><tt>y</tt></b></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a 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"><b class="parameter"><tt>path</tt></b></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a 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"><b class="parameter"><tt>enable_search</tt></b></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a 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 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 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"><b class="parameter"><tt>column</tt></b></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a 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"><b class="parameter"><tt>func</tt></b></span><span class="initializer">=None</span></span>, <span class="methodparam"><span class="parameter"><b class="parameter"><tt>user_data</tt></b></span><span class="initializer">=None</span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a 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 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"><b class="parameter"><tt>enable</tt></b></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a 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 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"><b class="parameter"><tt>hover</tt></b></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a 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 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"><b class="parameter"><tt>expand</tt></b></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a 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"><b class="parameter"><tt>func</tt></b></span><span class="initializer">=None</span></span>, <span class="methodparam"><span class="parameter"><b class="parameter"><tt>user_data</tt></b></span><span class="initializer">=None</span></span>)</code><br></pre></td></tr></table></div><div class="refsect1" lang="en"><a name="id3596605"></a><h2>Ancestry</h2><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="synopsis">+-- <a href="class-gobject.html" title="gobject.GObject">gobject.GObject</a>
+-- <a href="class-gtkobject.html" title="gtk.Object">gtk.Object</a>
+-- <a href="class-gtkwidget.html" title="gtk.Widget">gtk.Widget</a>
+-- <a href="class-gtkcontainer.html" title="gtk.Container">gtk.Container</a>
+-- <a href="class-gtktreeview.html" title="gtk.TreeView">gtk.TreeView</a>
</pre></td></tr></table></div><div class="refsect1" lang="en"><a name="id3596648"></a><h2>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><col><col></colgroup><tbody><tr valign="top"><td valign="top">"enable-search"</td><td valign="top">Read-Write</td><td valign="top">If <tt class="literal">TRUE</tt>, the user can search through
columns interactively. Default value: <tt class="literal">TRUE</tt></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 <tt class="literal">TRUE</tt>, assume all rows have the
same height thereby speeding up display. Default value:
<tt class="literal">FALSE</tt>. 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 <tt class="literal">TRUE</tt>, the column headers respond
to click events. Default value: <tt class="literal">FALSE</tt></td></tr><tr valign="top"><td valign="top">"headers-visible"</td><td valign="top">Read-Write</td><td valign="top">If <tt class="literal">TRUE</tt>, show the column header
buttons. Default value: <tt class="literal">TRUE</tt></td></tr><tr valign="top"><td valign="top">"hover-expand"</td><td valign="top">Read-Write</td><td valign="top">If <tt class="literal">TRUE</tt>, rows expand or collapse if
the pointer moves over them. This mode is primarily intended for treeviews
in popups, e.g. in <a href="class-gtkcombobox.html" title="gtk.ComboBox"><tt class="classname">gtk.ComboBox</tt></a> or
<a href="class-gtkentrycompletion.html" title="gtk.EntryCompletion"><tt class="classname">gtk.EntryCompletion</tt></a>. Default
value: <tt class="literal">FALSE</tt>. 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 <tt class="literal">TRUE</tt>, the selected row follows
the pointer. Currently, this works only for the selection modes
<tt class="literal">gtk.SELECTION_SINGLE</tt> and
<tt class="literal">gtk.SELECTION_BROWSE</tt>. This mode is primarily intended for
treeviews in popups, e.g. in <a href="class-gtkcombobox.html" title="gtk.ComboBox"><tt class="classname">gtk.ComboBox</tt></a> or
<a href="class-gtkentrycompletion.html" title="gtk.EntryCompletion"><tt class="classname">gtk.EntryCompletion</tt></a>. Default
value: <tt class="literal">FALSE</tt>. Available in GTK+ 2.6 and above.</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 <tt class="literal">TRUE</tt>, the view is
reorderable. Default value: <tt class="literal">FALSE</tt>.</td></tr><tr valign="top"><td valign="top">"rules-hint"</td><td valign="top">Read-Write</td><td valign="top">If <tt class="literal">TRUE</tt>, hint to the theme engine to
draw rows in alternating colors. Default value:
<tt class="literal">FALSE</tt>.</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">"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" lang="en"><a name="id3597033"></a><h2>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><col><col></colgroup><tbody><tr valign="top"><td valign="top">"allow-rules"</td><td valign="top">Read</td><td valign="top">If <tt class="literal">TRUE</tt>, allow drawing of
alternating color rows. Default value: <tt class="literal">TRUE</tt></td></tr><tr valign="top"><td valign="top">"even-row-color"</td><td valign="top">Read</td><td valign="top">The <a href="class-gdkcolor.html" title="gtk.gdk.Color"><tt class="classname">gtk.gdk.Color</tt></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">"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 <tt class="literal">TRUE</tt>, 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 href="class-gdkcolor.html" title="gtk.gdk.Color"><tt class="classname">gtk.gdk.Color</tt></a>
to use for odd rows. Available in GTK+ 2.2 and above.</td></tr><tr valign="top"><td valign="top">"vertical-separator"</td><td valign="top">Read-Write</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" lang="en"><a name="id3597238"></a><h2>Signal Prototypes</h2><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term">"<a href="class-gtktreeview.html#signal-gtktreeview--columns-changed" title='The "columns-changed" gtk.TreeView Signal'>columns-changed</a>"</span></td><td><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><i class="parameter"><tt>treeview</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>user_param1</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>...</tt></i></span></span>)</code></td></tr><tr><td><span class="term">"<a href="class-gtktreeview.html#signal-gtktreeview--cursor-changed" title='The "cursor-changed" gtk.TreeView Signal'>cursor-changed</a>"</span></td><td><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><i class="parameter"><tt>treeview</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>user_param1</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>...</tt></i></span></span>)</code></td></tr><tr><td><span class="term">"<a 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></td><td><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><i class="parameter"><tt>treeview</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>logical</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>expand</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>open_all</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>user_param1</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>...</tt></i></span></span>)</code></td></tr><tr><td><span class="term">"<a href="class-gtktreeview.html#signal-gtktreeview--move-cursor" title='The "move-cursor" gtk.TreeView Signal'>move-cursor</a>"</span></td><td><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><i class="parameter"><tt>treeview</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>step</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>count</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>user_param1</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>...</tt></i></span></span>)</code></td></tr><tr><td><span class="term">"<a href="class-gtktreeview.html#signal-gtktreeview--row-activated" title='The "row-activated" gtk.TreeView Signal'>row-activated</a>"</span></td><td><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><i class="parameter"><tt>treeview</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>path</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>view_column</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>user_param1</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>...</tt></i></span></span>)</code></td></tr><tr><td><span class="term">"<a href="class-gtktreeview.html#signal-gtktreeview--row-collapsed" title='The "row-collapsed" gtk.TreeView Signal'>row-collapsed</a>"</span></td><td><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><i class="parameter"><tt>treeview</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>iter</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>path</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>user_param1</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>...</tt></i></span></span>)</code></td></tr><tr><td><span class="term">"<a href="class-gtktreeview.html#signal-gtktreeview--row-expanded" title='The "row-expanded" gtk.TreeView Signal'>row-expanded</a>"</span></td><td><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><i class="parameter"><tt>treeview</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>iter</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>path</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>user_param1</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>...</tt></i></span></span>)</code></td></tr><tr><td><span class="term">"<a href="class-gtktreeview.html#signal-gtktreeview--select-all" title='The "select-all" gtk.TreeView Signal'>select-all</a>"</span></td><td><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><i class="parameter"><tt>treeview</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>user_param1</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>...</tt></i></span></span>)</code></td></tr><tr><td><span class="term">"<a href="class-gtktreeview.html#signal-gtktreeview--select-cursor-parent" title='The "select-cursor-parent" gtk.TreeView Signal'>select-cursor-parent</a>"</span></td><td><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><i class="parameter"><tt>treeview</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>user_param1</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>...</tt></i></span></span>)</code></td></tr><tr><td><span class="term">"<a href="class-gtktreeview.html#signal-gtktreeview--select-cursor-row" title='The "select-cursor-row" gtk.TreeView Signal'>select-cursor-row</a>"</span></td><td><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><i class="parameter"><tt>treeview</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>start_editing</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>user_param1</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>...</tt></i></span></span>)</code></td></tr><tr><td><span class="term">"<a href="class-gtktreeview.html#signal-gtktreeview--set-scroll-adjustments" title='The "set-scroll-adjustments" gtk.TreeView Signal'>set-scroll-adjustments</a>"</span></td><td><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><i class="parameter"><tt>treeview</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>hadjustment</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>vadjustment</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>user_param1</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>...</tt></i></span></span>)</code></td></tr><tr><td><span class="term">"<a href="class-gtktreeview.html#signal-gtktreeview--start-interactive-search" title='The "start-interactive-search" gtk.TreeView Signal'>start-interactive-search</a>"</span></td><td><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><i class="parameter"><tt>treeview</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>user_param1</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>...</tt></i></span></span>)</code></td></tr><tr><td><span class="term">"<a href="class-gtktreeview.html#signal-gtktreeview--test-collapse-row" title='The "test-collapse-row" gtk.TreeView Signal'>test-collapse-row</a>"</span></td><td><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><i class="parameter"><tt>treeview</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>iter</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>path</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>user_param1</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>...</tt></i></span></span>)</code></td></tr><tr><td><span class="term">"<a href="class-gtktreeview.html#signal-gtktreeview--test-expand-row" title='The "test-expand-row" gtk.TreeView Signal'>test-expand-row</a>"</span></td><td><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><i class="parameter"><tt>treeview</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>iter</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>path</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>user_param1</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>...</tt></i></span></span>)</code></td></tr><tr><td><span class="term">"<a href="class-gtktreeview.html#signal-gtktreeview--toggle-cursor-row" title='The "toggle-cursor-row" gtk.TreeView Signal'>toggle-cursor-row</a>"</span></td><td><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><i class="parameter"><tt>treeview</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>user_param1</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>...</tt></i></span></span>)</code></td></tr><tr><td><span class="term">"<a href="class-gtktreeview.html#signal-gtktreeview--unselect-all" title='The "unselect-all" gtk.TreeView Signal'>unselect-all</a>"</span></td><td><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><i class="parameter"><tt>treeview</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>user_param1</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>...</tt></i></span></span>)</code></td></tr></tbody></table></div><div class="refsect1" lang="en"><a name="id3597995"></a><h2>Description</h2><p>A <a href="class-gtktreeview.html" title="gtk.TreeView"><tt class="classname">gtk.TreeView</tt></a>
widget is used to display the contents of any model implementing the <a href="class-gtktreemodel.html" title="gtk.TreeModel"><tt class="classname">gtk.TreeModel</tt></a>
interface. The tree models provided standard with <tt class="literal">GTK+</tt>
and <tt class="literal">PyGTK</tt> are:</p><div class="itemizedlist"><ul type="disc"><li><a href="class-gtkliststore.html" title="gtk.ListStore"><tt class="classname">gtk.ListStore</tt></a></li><li><a href="class-gtktreestore.html" title="gtk.TreeStore"><tt class="classname">gtk.TreeStore</tt></a></li><li><a href="class-gtktreemodelsort.html" title="gtk.TreeModelSort"><tt class="classname">gtk.TreeModelSort</tt></a></li></ul></div><p>In addition, <tt class="literal">PyGTK</tt> provides <a href="class-pygtkgenerictreemodel.html" title="gtk.GenericTreeModel"><tt class="classname">gtk.GenericTreeModel</tt></a>
that allows you to create your own tree model entirely in Python.</p><p>The <a href="class-gtktreeview.html" title="gtk.TreeView"><tt class="classname">gtk.TreeView</tt></a> uses
columns and cell renderers to actually display the model information.
<tt class="literal">GTK+</tt> and <tt class="literal">PyGTK</tt> provides the <a href="class-gtktreeviewcolumn.html" title="gtk.TreeViewColumn"><tt class="classname">gtk.TreeViewColumn</tt></a>
to manage the display of a column and the following cell renderers:</p><div class="itemizedlist"><ul type="disc"><li><a href="class-gtkcellrendererpixbuf.html" title="gtk.CellRendererPixbuf"><tt class="classname">gtk.CellRendererPixbuf</tt></a></li><li><a href="class-gtkcellrenderertext.html" title="gtk.CellRendererText"><tt class="classname">gtk.CellRendererText</tt></a></li><li><a href="class-gtkcellrenderertoggle.html" title="gtk.CellRendererToggle"><tt class="classname">gtk.CellRendererToggle</tt></a></li></ul></div><p>In addition, <tt class="literal">PyGTK</tt> provides the <a href="class-pygtkgenericcellrenderer.html" title="gtk.GenericCellRenderer"><tt class="classname">gtk.GenericCellRenderer</tt></a>
that allows you to create your own cell renderers entirely in Python.</p></div><div class="refsect1" lang="en"><a name="constructor-gtktreeview"></a><h2>Constructor</h2><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="constructorsynopsis"> <span class="methodname">gtk.TreeView</span>(<span class="methodparam"><span class="parameter"><b class="parameter"><tt>model</tt></b></span><span class="initializer">=None</span></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><b class="parameter"><tt>model</tt></b>:</span></td><td>the tree model to display</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>:</span></td><td>A new <a href="class-gtktreeview.html" title="gtk.TreeView"><tt class="classname">gtk.TreeView</tt></a>
widget.</td></tr></tbody></table><p>Creates a new <a href="class-gtktreeview.html" title="gtk.TreeView"><tt class="classname">gtk.TreeView</tt></a>
widget displaying the model specified by <i class="parameter"><tt>model</tt></i>.</p></div><div class="refsect1" lang="en"><a name="id3598264"></a><h2>Methods</h2><div class="refsect2" lang="en"><a name="method-gtktreeview--get-model"></a><h3>gtk.TreeView.get_model</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_model</span>(<span class="methodparam"></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>:</span></td><td>the current <a href="class-gtktreemodel.html" title="gtk.TreeModel"><tt class="classname">gtk.TreeModel</tt></a>, or
<tt class="literal">None</tt> if none is currently being
used.</td></tr></tbody></table><p>The <tt class="methodname">get_model</tt>() method returns the
value of the "model" property containing the model the <a href="class-gtktreeview.html" title="gtk.TreeView"><tt class="classname">gtk.TreeView</tt></a> is
displaying or <tt class="literal">None</tt> there is no the model.</p></div><div class="refsect2" lang="en"><a name="method-gtktreeview--set-model"></a><h3>gtk.TreeView.set_model</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_model</span>(<span class="methodparam"><span class="parameter"><b class="parameter"><tt>model</tt></b></span><span class="initializer">=None</span></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><b class="parameter"><tt>model</tt></b>:</span></td><td>the new tree model to use with the
treeview</td></tr></tbody></table><p>The <tt class="methodname">set_model</tt>() method sets the "model"
property for the treeview to the value of <i class="parameter"><tt>model</tt></i>. If
the treeview already has a model set, this method will remove it before
setting the new model. If <i class="parameter"><tt>model</tt></i> is
<tt class="literal">None</tt>, it will unset the old model.</p></div><div class="refsect2" lang="en"><a name="method-gtktreeview--get-selection"></a><h3>gtk.TreeView.get_selection</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_selection</span>(<span class="methodparam"></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>:</span></td><td>A <a href="class-gtktreeselection.html" title="gtk.TreeSelection"><tt class="classname">gtk.TreeSelection</tt></a>
object.</td></tr></tbody></table><p>The <tt class="methodname">get_selection</tt>() method returns the
current <a href="class-gtktreeselection.html" title="gtk.TreeSelection"><tt class="classname">gtk.TreeSelection</tt></a>
associated with the treeview.</p></div><div class="refsect2" lang="en"><a name="method-gtktreeview--get-hadjustment"></a><h3>gtk.TreeView.get_hadjustment</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_hadjustment</span>(<span class="methodparam"></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>:</span></td><td>a <a href="class-gtkadjustment.html" title="gtk.Adjustment"><tt class="classname">gtk.Adjustment</tt></a>
object, or <tt class="literal">None</tt> if none is currently being
used.</td></tr></tbody></table><p>The <tt class="methodname">get_hadjustment</tt>() method returns
the value of the "hadjustment" property that contains the current horizontal
<a href="class-gtkadjustment.html" title="gtk.Adjustment"><tt class="classname">gtk.Adjustment</tt></a>
object or <tt class="literal">None</tt> (if no horizontal adjustment is being
used).</p></div><div class="refsect2" lang="en"><a name="method-gtktreeview--set-hadjustment"></a><h3>gtk.TreeView.set_hadjustment</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_hadjustment</span>(<span class="methodparam"><span class="parameter"><b class="parameter"><tt>adjustment</tt></b></span></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><b class="parameter"><tt>adjustment</tt></b>:</span></td><td>the <a href="class-gtkadjustment.html" title="gtk.Adjustment"><tt class="classname">gtk.Adjustment</tt></a>
to set</td></tr></tbody></table><p>The <tt class="methodname">set_hadjustment</tt>() method sets the
"hadjustment" property to the value of <i class="parameter"><tt>adjustment</tt></i>
that must be a <a href="class-gtkadjustment.html" title="gtk.Adjustment"><tt class="classname">gtk.Adjustment</tt></a>
object.</p></div><div class="refsect2" lang="en"><a name="method-gtktreeview--get-vadjustment"></a><h3>gtk.TreeView.get_vadjustment</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_vadjustment</span>(<span class="methodparam"></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>:</span></td><td>a <a href="class-gtkadjustment.html" title="gtk.Adjustment"><tt class="classname">gtk.Adjustment</tt></a>
object, or <tt class="literal">None</tt> if none is currently being
used.</td></tr></tbody></table><p>The <tt class="methodname">get_vadjustment</tt>() method returns
the value of the "vadjustment" property that contains the horizontal <a href="class-gtkadjustment.html" title="gtk.Adjustment"><tt class="classname">gtk.Adjustment</tt></a>
or None if there is no vertical adjustment.</p></div><div class="refsect2" lang="en"><a name="method-gtktreeview--set-vadjustment"></a><h3>gtk.TreeView.set_vadjustment</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_vadjustment</span>(<span class="methodparam"><span class="parameter"><b class="parameter"><tt>adjustment</tt></b></span></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><b class="parameter"><tt>adjustment</tt></b>:</span></td><td>the <a href="class-gtkadjustment.html" title="gtk.Adjustment"><tt class="classname">gtk.Adjustment</tt></a>
to set</td></tr></tbody></table><p>The <tt class="methodname">set_vadjustment</tt>() method sets the
"vadjustment" property to the value of <i class="parameter"><tt>adjustment</tt></i>.
The new <a href="class-gtkadjustment.html" title="gtk.Adjustment"><tt class="classname">gtk.Adjustment</tt></a>
replaces the current vertical adjustment.</p></div><div class="refsect2" lang="en"><a name="method-gtktreeview--get-headers-visible"></a><h3>gtk.TreeView.get_headers_visible</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_headers_visible</span>(<span class="methodparam"></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>:</span></td><td><tt class="literal">TRUE</tt> if the headers are
visible.</td></tr></tbody></table><p>The <tt class="methodname">get_headers_visible</tt>() method
returns the value of the "headers-visible" property. If "headers-visible" is
<tt class="literal">TRUE</tt> the headers on the treeview are visible.</p></div><div class="refsect2" lang="en"><a name="method-gtktreeview--set-headers-visible"></a><h3>gtk.TreeView.set_headers_visible</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_headers_visible</span>(<span class="methodparam"><span class="parameter"><b class="parameter"><tt>headers_visible</tt></b></span></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><b class="parameter"><tt>headers_visible</tt></b>:</span></td><td>if <tt class="literal">TRUE</tt> the headers are
visible</td></tr></tbody></table><p>The <tt class="methodname">set_headers_visible</tt>() method sets
the "headers-visible" property to the value of
<i class="parameter"><tt>headers_visible</tt></i>. If
<i class="parameter"><tt>headers_visible</tt></i> is <tt class="literal">TRUE</tt> the
headers will be displayed.</p></div><div class="refsect2" lang="en"><a name="method-gtktreeview--columns-autosize"></a><h3>gtk.TreeView.columns_autosize</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">columns_autosize</span>(<span class="methodparam"></span>)</code></pre></td></tr></table><p>The <tt class="methodname">columns_autosize</tt>() method resizes
all columns to their optimal width. Only works after the treeview has been
realized.</p></div><div class="refsect2" lang="en"><a name="method-gtktreeview--set-headers-clickable"></a><h3>gtk.TreeView.set_headers_clickable</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_headers_clickable</span>(<span class="methodparam"><span class="parameter"><b class="parameter"><tt>active</tt></b></span></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><b class="parameter"><tt>active</tt></b>:</span></td><td>if <tt class="literal">TRUE</tt> the headers are
clickable</td></tr></tbody></table><p>The <tt class="methodname">set_headers_clickable</tt>() method sets
the "headers-clickable" property to the value of
<i class="parameter"><tt>active</tt></i>. If <i class="parameter"><tt>active</tt></i> is
<tt class="literal">TRUE</tt> the column title buttons can be clicked.</p></div><div class="refsect2" lang="en"><a name="method-gtktreeview--set-rules-hint"></a><h3>gtk.TreeView.set_rules_hint</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_rules_hint</span>(<span class="methodparam"><span class="parameter"><b class="parameter"><tt>setting</tt></b></span></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><b class="parameter"><tt>setting</tt></b>:</span></td><td>if <tt class="literal">TRUE</tt> the tree requires
reading across rows</td></tr></tbody></table><p>The <tt class="methodname">set_rules_hint</tt>() method sets the
"rules-hint" property to the value of <i class="parameter"><tt>setting</tt></i>. If
<i class="parameter"><tt>setting</tt></i> is <tt class="literal">TRUE</tt> 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" lang="en"><a name="method-gtktreeview--get-rules-hint"></a><h3>gtk.TreeView.get_rules_hint</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_rules_hint</span>(<span class="methodparam"></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>:</span></td><td><tt class="literal">TRUE</tt> if rules are useful for
the user of this tree</td></tr></tbody></table><p>The <tt class="methodname">get_rules_hint</tt>() returns the value
of the "rules-hint" property. See the <a href="class-gtktreeview.html#method-gtktreeview--set-rules-hint" title="gtk.TreeView.set_rules_hint"><tt class="methodname">set_rules_hint</tt>()</a>
method for more information on the use of "rules-hint".</p></div><div class="refsect2" lang="en"><a name="method-gtktreeview--append-column"></a><h3>gtk.TreeView.append_column</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">append_column</span>(<span class="methodparam"><span class="parameter"><b class="parameter"><tt>column</tt></b></span></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><b class="parameter"><tt>column</tt></b>:</span></td><td>the <a href="class-gtktreeviewcolumn.html" title="gtk.TreeViewColumn"><tt class="classname">gtk.TreeViewColumn</tt></a>
to add.</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>:</span></td><td>the number of columns in
<i class="parameter"><tt>tree_view</tt></i> after appending.</td></tr></tbody></table><p>The <tt class="methodname">append_column</tt>() method appends the
specified <i class="parameter"><tt>column</tt></i> to the list of columns and returns
the new number of columns in the treeview.</p></div><div class="refsect2" lang="en"><a name="method-gtktreeview--remove-column"></a><h3>gtk.TreeView.remove_column</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">remove_column</span>(<span class="methodparam"><span class="parameter"><b class="parameter"><tt>column</tt></b></span></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><b class="parameter"><tt>column</tt></b>:</span></td><td>the <a href="class-gtktreeviewcolumn.html" title="gtk.TreeViewColumn"><tt class="classname">gtk.TreeViewColumn</tt></a>
to remove.</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>:</span></td><td>the number of columns in the treeview after the
column removal.</td></tr></tbody></table><p>The <tt class="methodname">remove_column</tt>() method removes the
specified <i class="parameter"><tt>column</tt></i> from the treeview.</p></div><div class="refsect2" lang="en"><a name="method-gtktreeview--insert-column"></a><h3>gtk.TreeView.insert_column</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">insert_column</span>(<span class="methodparam"><span class="parameter"><b class="parameter"><tt>column</tt></b></span></span>, <span class="methodparam"><span class="parameter"><b class="parameter"><tt>position</tt></b></span></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><b class="parameter"><tt>column</tt></b>:</span></td><td>the <a href="class-gtktreeviewcolumn.html" title="gtk.TreeViewColumn"><tt class="classname">gtk.TreeViewColumn</tt></a>
to be inserted.</td></tr><tr><td><span class="term"><b class="parameter"><tt>position</tt></b>:</span></td><td>the position to insert
<i class="parameter"><tt>column</tt></i>.</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>:</span></td><td>the number of columns in the treeview after the
insertion.</td></tr></tbody></table><p>The <tt class="methodname">insert_column</tt>() method inserts the
specified <i class="parameter"><tt>column</tt></i> into the treeview at the location
specified by <i class="parameter"><tt>position</tt></i>. If
<i class="parameter"><tt>position</tt></i> is -1, then the column is inserted at the
end.</p></div><div class="refsect2" lang="en"><a name="method-gtktreeview--insert-column-with-attributes"></a><h3>gtk.TreeView.insert_column_with_attributes</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">insert_column_with_attributes</span>(<span class="methodparam"><span class="parameter"><i class="parameter"><tt>position</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>title</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>cell</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>...</tt></i></span></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><i class="parameter"><tt>position</tt></i>:</span></td><td>the position to insert the new column
in.</td></tr><tr><td><span class="term"><i class="parameter"><tt>title</tt></i>:</span></td><td>the title to set the header
to.</td></tr><tr><td><span class="term"><i class="parameter"><tt>cell</tt></i>:</span></td><td>the <a href="class-gtkcellrenderer.html" title="gtk.CellRenderer"><tt class="classname">gtk.CellRenderer</tt></a>.</td></tr><tr><td><span class="term"><i class="parameter"><tt>...</tt></i>:</span></td><td>optional keyword-value
arguments</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>:</span></td><td>the number of columns in
<i class="parameter"><tt>tree_view</tt></i> after the insertion.</td></tr></tbody></table><p>The <tt class="methodname">insert_columns_with_attributes</tt>()
method creates a new <a href="class-gtktreeviewcolumn.html" title="gtk.TreeViewColumn"><tt class="classname">gtk.TreeViewColumn</tt></a>
and inserts it into the treeview at the location specified by
<i class="parameter"><tt>position</tt></i> with the column title specified by
<i class="parameter"><tt>title</tt></i> and using the <a href="class-gtkcellrenderer.html" title="gtk.CellRenderer"><tt class="classname">gtk.CellRenderer</tt></a>
specified by <i class="parameter"><tt>cell</tt></i>. If <i class="parameter"><tt>position</tt></i>
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 href="class-gtktreeviewcolumn.html#method-gtktreeviewcolumn--add-attribute" title="gtk.TreeViewColumn.add_attribute"><tt class="methodname">gtk.TreeViewColumn.add_attribute</tt>()</a>
method for more information.</p></div><div class="refsect2" lang="en"><a name="method-gtktreeview--insert-column-with-data-func"></a><h3>gtk.TreeView.insert_column_with_data_func</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">insert_column_with_data_func</span>(<span class="methodparam"><span class="parameter"><i class="parameter"><tt>position</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>title</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>cell</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>func</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>data</tt></i></span><span class="initializer">=None</span></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><i class="parameter"><tt>position</tt></i>:</span></td><td>the position to insert, -1 for
append</td></tr><tr><td><span class="term"><i class="parameter"><tt>title</tt></i>:</span></td><td>the column title</td></tr><tr><td><span class="term"><i class="parameter"><tt>cell</tt></i>:</span></td><td>a cell renderer for the
column</td></tr><tr><td><span class="term"><i class="parameter"><tt>func</tt></i>:</span></td><td>the function or method to set attributes of the
cell renderer</td></tr><tr><td><span class="term"><i class="parameter"><tt>data</tt></i>:</span></td><td>the data to pass with
<i class="parameter"><tt>func</tt></i></td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>:</span></td><td>the number of columns in the treeview after the
insertion</td></tr></tbody></table><p>The <tt class="methodname">insert_column_with_data_func</tt>()
method is a convenience function that inserts a new column into the treeview
at the location specified by <i class="parameter"><tt>position</tt></i> with the
specified <i class="parameter"><tt>title</tt></i> and the cell renderer specified by
<i class="parameter"><tt>cell</tt></i> and using the function or method specified by
<i class="parameter"><tt>func</tt></i> to set cell renderer attributes (normally using
data from the model). The signature of func is:</p><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting">
<code class="methodsynopsis"> def <span class="methodname">celldatafunction</span>(<span class="methodparam"><span class="parameter"><i class="parameter"><tt>column</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>cell</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>model</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>iter</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>user_data</tt></i></span></span>)</code><br>
<code class="methodsynopsis"> def <span class="methodname">celldatamethod</span>(<span class="methodparam"><span class="parameter"><i class="parameter"><tt>self</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>column</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>cell</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>model</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>iter</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>user_data</tt></i></span></span>)</code>
</pre></td></tr></table><p>where <i class="parameter"><tt>column</tt></i> is the <a href="class-gtktreeviewcolumn.html" title="gtk.TreeViewColumn"><tt class="classname">gtk.TreeViewColumn</tt></a>
in the treeview, <i class="parameter"><tt>cell</tt></i> is the <a href="class-gtkcellrenderer.html" title="gtk.CellRenderer"><tt class="classname">gtk.CellRenderer</tt></a>
for <i class="parameter"><tt>column</tt></i>, <i class="parameter"><tt>model</tt></i> is the <a href="class-gtktreemodel.html" title="gtk.TreeModel"><tt class="classname">gtk.TreeModel</tt></a> for
the treeview and <i class="parameter"><tt>iter</tt></i> is the <a href="class-gtktreeiter.html" title="gtk.TreeIter"><tt class="classname">gtk.TreeIter</tt></a>
pointing at the row. See the <a href="class-gtktreeviewcolumn.html#method-gtktreeviewcolumn--set-cell-data-func" title="gtk.TreeViewColumn.set_cell_data_func"><tt class="methodname">gtk.TreeViewColumn.set_cell_data_func</tt>()</a>
and <a href="class-gtktreeviewcolumn.html#method-gtktreeviewcolumn--pack-start" title="gtk.TreeViewColumn.pack_start"><tt class="methodname">gtk.TreeViewColumn.pack_start</tt>()</a>
methods for more detail.</p></div><div class="refsect2" lang="en"><a name="method-gtktreeview--get-column"></a><h3>gtk.TreeView.get_column</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_column</span>(<span class="methodparam"><span class="parameter"><b class="parameter"><tt>n</tt></b></span></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><b class="parameter"><tt>n</tt></b>:</span></td><td>the position of the column, counting from
0.</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>:</span></td><td>the <a href="class-gtktreeviewcolumn.html" title="gtk.TreeViewColumn"><tt class="classname">gtk.TreeViewColumn</tt></a>,
or <tt class="literal">None</tt> if the position is outside the range of
columns.</td></tr></tbody></table><p>The <tt class="methodname">get_column</tt>() method returns the
<a href="class-gtktreeviewcolumn.html" title="gtk.TreeViewColumn"><tt class="classname">gtk.TreeViewColumn</tt></a>
at the specified <i class="parameter"><tt>position</tt></i> in the treeview.</p></div><div class="refsect2" lang="en"><a name="method-gtktreeview--get-columns"></a><h3>gtk.TreeView.get_columns</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_columns</span>(<span class="methodparam"></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>:</span></td><td>a list of <a href="class-gtktreeviewcolumn.html" title="gtk.TreeViewColumn"><tt class="classname">gtk.TreeViewColumn</tt></a>
s</td></tr></tbody></table><p>The <tt class="methodname">get_columns</tt>() method returns a list
of all the <a href="class-gtktreeviewcolumn.html" title="gtk.TreeViewColumn"><tt class="classname">gtk.TreeViewColumn</tt></a>
objects currently in the treeview.</p></div><div class="refsect2" lang="en"><a name="method-gtktreeview--move-column-after"></a><h3>gtk.TreeView.move_column_after</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">move_column_after</span>(<span class="methodparam"><span class="parameter"><b class="parameter"><tt>column</tt></b></span></span>, <span class="methodparam"><span class="parameter"><b class="parameter"><tt>base_column</tt></b></span></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><b class="parameter"><tt>column</tt></b>:</span></td><td>the <a href="class-gtktreeviewcolumn.html" title="gtk.TreeViewColumn"><tt class="classname">gtk.TreeViewColumn</tt></a>
to be moved.</td></tr><tr><td><span class="term"><b class="parameter"><tt>base_column</tt></b>:</span></td><td>the <a href="class-gtktreeviewcolumn.html" title="gtk.TreeViewColumn"><tt class="classname">gtk.TreeViewColumn</tt></a>
<i class="parameter"><tt>column</tt></i> is to be after, or
<tt class="literal">None</tt>.</td></tr></tbody></table><p>The <tt class="methodname">move_column_after</tt>() method moves
the <a href="class-gtktreeviewcolumn.html" title="gtk.TreeViewColumn"><tt class="classname">gtk.TreeViewColumn</tt></a>
specified by <i class="parameter"><tt>column</tt></i> to be after the treeview column
specified by <i class="parameter"><tt>base_column</tt></i>. If
<i class="parameter"><tt>base_column</tt></i> is <tt class="literal">None</tt>, then
<i class="parameter"><tt>column</tt></i> is placed in the first position.</p></div><div class="refsect2" lang="en"><a name="method-gtktreeview--set-expander-column"></a><h3>gtk.TreeView.set_expander_column</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_expander_column</span>(<span class="methodparam"><span class="parameter"><b class="parameter"><tt>column</tt></b></span></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><b class="parameter"><tt>column</tt></b>:</span></td><td>the column to draw the expander arrow at
or<tt class="literal">None</tt>.</td></tr></tbody></table><p>The <tt class="methodname">set_expander_column</tt>() method sets
the "expander-column" property to the value of <i class="parameter"><tt>column</tt></i>
which must be a <a href="class-gtktreeviewcolumn.html" title="gtk.TreeViewColumn"><tt class="classname">gtk.TreeViewColumn</tt></a>
in the treeview. If <i class="parameter"><tt>column</tt></i> is
<tt class="literal">None</tt>, then the expander arrow is always at the first
visible column.</p></div><div class="refsect2" lang="en"><a name="method-gtktreeview--get-expander-column"></a><h3>gtk.TreeView.get_expander_column</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_expander_column</span>(<span class="methodparam"></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>:</span></td><td>the expander column.</td></tr></tbody></table><p>The <tt class="methodname">get_expander_column</tt>() 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" lang="en"><a name="method-gtktreeview--set-column-drag-function"></a><h3>gtk.TreeView.set_column_drag_function</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_column_drag_function</span>(<span class="methodparam"><span class="parameter"><b class="parameter"><tt>func</tt></b></span></span>, <span class="methodparam"><span class="parameter"><b class="parameter"><tt>user_data</tt></b></span></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><b class="parameter"><tt>func</tt></b>:</span></td><td>A function to determine which columns are reorderable, or <tt class="literal">None</tt>.</td></tr><tr><td><span class="term"><b class="parameter"><tt>user_data</tt></b>:</span></td><td>User data to be passed to <i class="parameter"><tt>func</tt></i>, or <tt class="literal">None</tt></td></tr></tbody></table><div class="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 <tt class="methodname">set_column_drag_function</tt>() method
sets the user function specified by <i class="parameter"><tt>func</tt></i> 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
<i class="parameter"><tt>func</tt></i> is:</p><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting">
def func(<i class="parameter"><tt>tree_view</tt></i>, <i class="parameter"><tt>column</tt></i>, <i class="parameter"><tt>prev_column</tt></i>, <i class="parameter"><tt>next_column</tt></i>, <i class="parameter"><tt>data</tt></i>)
</pre></td></tr></table><p>where <i class="parameter"><tt>tree_view</tt></i> is the <a href="class-gtktreeview.html" title="gtk.TreeView"><tt class="classname">gtk.TreeView</tt></a>,
<i class="parameter"><tt>column</tt></i> is the <a href="class-gtktreeviewcolumn.html" title="gtk.TreeViewColumn"><tt class="classname">gtk.TreeViewColumn</tt></a>
being dragged, prev_column and next_column are the two <a href="class-gtktreeviewcolumn.html" title="gtk.TreeViewColumn"><tt class="classname">gtk.TreeViewColumn</tt></a>
objects bracketing the drop spot, and <i class="parameter"><tt>data</tt></i> is
<i class="parameter"><tt>user_data</tt></i>. If <i class="parameter"><tt>prev_column</tt></i> or
<i class="parameter"><tt>next_column</tt></i> is <tt class="literal">None</tt>, then the drop
is at an edge. If <i class="parameter"><tt>func</tt></i> is <tt class="literal">None</tt>,
the user drag function is removed and the <a href="class-gtktreeview.html" title="gtk.TreeView"><tt class="classname">gtk.TreeView</tt></a>
reverts to the default behavior of allowing any reorderable column to be
dropped anywhere.</p></div><div class="refsect2" lang="en"><a name="method-gtktreeview--scroll-to-point"></a><h3>gtk.TreeView.scroll_to_point</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">scroll_to_point</span>(<span class="methodparam"><span class="parameter"><b class="parameter"><tt>tree_x</tt></b></span></span>, <span class="methodparam"><span class="parameter"><b class="parameter"><tt>tree_y</tt></b></span></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><b class="parameter"><tt>tree_x</tt></b>:</span></td><td>the X coordinate of new top-left pixel of
visible area, or -1</td></tr><tr><td><span class="term"><b class="parameter"><tt>tree_y</tt></b>:</span></td><td>the Y coordinate of new top-left pixel of
visible area, or -1</td></tr></tbody></table><p>The <tt class="methodname">scroll_to_point</tt>() method scrolls
the treeview so that the top-left corner of the visible area is at the
location specified by <i class="parameter"><tt>tree_x</tt></i> and
<i class="parameter"><tt>tree_y</tt></i>, where <i class="parameter"><tt>tree_x</tt></i> and
<i class="parameter"><tt>tree_y</tt></i> 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 href="class-gtktreeview.html#method-gtktreeview--scroll-to-cell" title="gtk.TreeView.scroll_to_cell"><tt class="methodname">scroll_to_cell</tt>()</a>
method instead. If either <i class="parameter"><tt>tree_x</tt></i> or
<i class="parameter"><tt>tree_y</tt></i> are -1, there is no scrolling in that
direction.</p></div><div class="refsect2" lang="en"><a name="method-gtktreeview--scroll-to-cell"></a><h3>gtk.TreeView.scroll_to_cell</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">scroll_to_cell</span>(<span class="methodparam"><span class="parameter"><b class="parameter"><tt>path</tt></b></span></span>, <span class="methodparam"><span class="parameter"><b class="parameter"><tt>column</tt></b></span><span class="initializer">=None</span></span>, <span class="methodparam"><span class="parameter"><b class="parameter"><tt>use_align</tt></b></span><span class="initializer">=FALSE</span></span>, <span class="methodparam"><span class="parameter"><b class="parameter"><tt>row_align</tt></b></span><span class="initializer">=0.0</span></span>, <span class="methodparam"><span class="parameter"><b class="parameter"><tt>col_align</tt></b></span><span class="initializer">=0.0</span></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><b class="parameter"><tt>path</tt></b>:</span></td><td>the path of the row to move
to</td></tr><tr><td><span class="term"><b class="parameter"><tt>column</tt></b>:</span></td><td>the <a href="class-gtktreeviewcolumn.html" title="gtk.TreeViewColumn"><tt class="classname">gtk.TreeViewColumn</tt></a>
to move horizontally to, or <tt class="literal">None</tt>.</td></tr><tr><td><span class="term"><b class="parameter"><tt>use_align</tt></b>:</span></td><td>if <tt class="literal">TRUE</tt> use the alignment
arguments</td></tr><tr><td><span class="term"><b class="parameter"><tt>row_align</tt></b>:</span></td><td>the vertical alignment of the row specified by
<i class="parameter"><tt>path</tt></i>.</td></tr><tr><td><span class="term"><b class="parameter"><tt>col_align</tt></b>:</span></td><td>the horizontal alignment of the column
specified by <i class="parameter"><tt>column</tt></i>.</td></tr></tbody></table><p>The <tt class="methodname">scroll_to_cell</tt>() method scrolls the
treeview display to the position specified by <i class="parameter"><tt>column</tt></i>
and <i class="parameter"><tt>path</tt></i>. If <i class="parameter"><tt>column</tt></i> is
<tt class="literal">None</tt>, no horizontal scrolling occurs. The alignment
parameters specified by <i class="parameter"><tt>row_align</tt></i> and
<i class="parameter"><tt>col_align</tt></i> determines where
<i class="parameter"><tt>column</tt></i> is placed within the treeview. The values of
<i class="parameter"><tt>col_align</tt></i> and <i class="parameter"><tt>row_align</tt></i> 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
<i class="parameter"><tt>use_align</tt></i> is <tt class="literal">FALSE</tt>, 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 <i class="parameter"><tt>path</tt></i> is a valid row in the model.</p></div><div class="refsect2" lang="en"><a name="method-gtktreeview--row-activated"></a><h3>gtk.TreeView.row_activated</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">row_activated</span>(<span class="methodparam"><span class="parameter"><b class="parameter"><tt>path</tt></b></span></span>, <span class="methodparam"><span class="parameter"><b class="parameter"><tt>column</tt></b></span></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><b class="parameter"><tt>path</tt></b>:</span></td><td>the tree path of the row of the cell to be
activated.</td></tr><tr><td><span class="term"><b class="parameter"><tt>column</tt></b>:</span></td><td>the <a href="class-gtktreeviewcolumn.html" title="gtk.TreeViewColumn"><tt class="classname">gtk.TreeViewColumn</tt></a>
of the cell to be activated.</td></tr></tbody></table><p>The <tt class="methodname">row_activated</tt>() method activates
the cell determined by <i class="parameter"><tt>path</tt></i> and
<i class="parameter"><tt>column</tt></i>.</p></div><div class="refsect2" lang="en"><a name="method-gtktreeview--expand-all"></a><h3>gtk.TreeView.expand_all</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">expand_all</span>(<span class="methodparam"></span>)</code></pre></td></tr></table><p>The <tt class="methodname">expand_all</tt>() method recursively
expands all nodes in the treeview.</p></div><div class="refsect2" lang="en"><a name="method-gtktreeview--collapse-all"></a><h3>gtk.TreeView.collapse_all</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">collapse_all</span>(<span class="methodparam"></span>)</code></pre></td></tr></table><p>The <tt class="methodname">collapse_all</tt>() method recursively
collapses all visible, expanded nodes in the treeview.</p></div><div class="refsect2" lang="en"><a name="method-gtktreeview--expand-to-path"></a><h3>gtk.TreeView.expand_to_path</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">expand_to_path</span>(<span class="methodparam"><span class="parameter"><b class="parameter"><tt>path</tt></b></span></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><i class="parameter"><tt>path</tt></i>:</span></td><td>a path to a row.</td></tr></tbody></table><div class="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 <tt class="methodname">expand_to_row</tt>() method expands the
row with the tree path specified by <i class="parameter"><tt>path</tt></i>. This will
also expand all parent rows of <i class="parameter"><tt>path</tt></i> as
necessary.</p></div><div class="refsect2" lang="en"><a name="method-gtktreeview--expand-row"></a><h3>gtk.TreeView.expand_row</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">expand_row</span>(<span class="methodparam"><span class="parameter"><b class="parameter"><tt>path</tt></b></span></span>, <span class="methodparam"><span class="parameter"><b class="parameter"><tt>open_all</tt></b></span></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><b class="parameter"><tt>path</tt></b>:</span></td><td>the path to a row</td></tr><tr><td><span class="term"><b class="parameter"><tt>open_all</tt></b>:</span></td><td>if <tt class="literal">TRUE</tt> recursively expand,
otherwise just expand immediate children</td></tr></tbody></table><p>The <tt class="methodname">expand_row</tt>() method opens the row
specified by <i class="parameter"><tt>path</tt></i> so its children are visible. If
<i class="parameter"><tt>open_all</tt></i> is <tt class="literal">TRUE</tt> all rows are
expanded, otherwise only the immediate children of
<i class="parameter"><tt>path</tt></i> are expanded.</p></div><div class="refsect2" lang="en"><a name="method-gtktreeview--collapse-row"></a><h3>gtk.TreeView.collapse_row</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">collapse_row</span>(<span class="methodparam"><span class="parameter"><b class="parameter"><tt>path</tt></b></span></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><b class="parameter"><tt>path</tt></b>:</span></td><td>the path to a row</td></tr></tbody></table><p>The <tt class="methodname">collapse_row</tt>() method collapses the
row specified by <i class="parameter"><tt>path</tt></i> (hides its child rows, if they
exist).</p></div><div class="refsect2" lang="en"><a name="method-gtktreeview--map-expanded-rows"></a><h3>gtk.TreeView.map_expanded_rows</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">map_expanded_rows</span>(<span class="methodparam"><span class="parameter"><b class="parameter"><tt>func</tt></b></span></span>, <span class="methodparam"><span class="parameter"><b class="parameter"><tt>data</tt></b></span></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><b class="parameter"><tt>func</tt></b>:</span></td><td>A function to be called</td></tr><tr><td><span class="term"><b class="parameter"><tt>data</tt></b>:</span></td><td>User data to be passed to the function.</td></tr></tbody></table><div class="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 <tt class="methodname">map_expanded_rows</tt>() method calls
the function specified by <i class="parameter"><tt>func</tt></i> on all expanded rows
passing <i class="parameter"><tt>data</tt></i> as an argument.</p></div><div class="refsect2" lang="en"><a name="method-gtktreeview--row-expanded"></a><h3>gtk.TreeView.row_expanded</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">row_expanded</span>(<span class="methodparam"><span class="parameter"><b class="parameter"><tt>path</tt></b></span></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><b class="parameter"><tt>path</tt></b>:</span></td><td>the path to a row to test the expansion
state.</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>:</span></td><td><tt class="literal">TRUE</tt> if
<tt class="literal">path</tt> is expanded.</td></tr></tbody></table><p>The <tt class="methodname">row_expanded</tt>() method returns
<tt class="literal">TRUE</tt> if the node pointed to by
<i class="parameter"><tt>path</tt></i> is expanded.</p></div><div class="refsect2" lang="en"><a name="method-gtktreeview--set-reorderable"></a><h3>gtk.TreeView.set_reorderable</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_reorderable</span>(<span class="methodparam"><span class="parameter"><b class="parameter"><tt>reorderable</tt></b></span></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><b class="parameter"><tt>reorderable</tt></b>:</span></td><td>if <tt class="literal">TRUE</tt>, the tree can be
reordered.</td></tr></tbody></table><p>The <tt class="methodname">set_reorderable</tt>() method sets the
"reorderable" property to the value of <i class="parameter"><tt>reorderable</tt></i>.
This method is a convenience method to allow you to reorder models that
support the <a href="class-gtktreedragsource.html" title="gtk.TreeDragSource"><tt class="classname">gtk.TreeDragSource</tt></a>
and the <a href="class-gtktreedragdest.html" title="gtk.TreeDragDest"><tt class="classname">gtk.TreeDragDest</tt></a>
interfaces. Both <a href="class-gtktreestore.html" title="gtk.TreeStore"><tt class="classname">gtk.TreeStore</tt></a> and
<a href="class-gtkliststore.html" title="gtk.ListStore"><tt class="classname">gtk.ListStore</tt></a>
support these. If <i class="parameter"><tt>reorderable</tt></i> is
<tt class="literal">TRUE</tt>, 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" 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" lang="en"><a name="method-gtktreeview--get-reorderable"></a><h3>gtk.TreeView.get_reorderable</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_reorderable</span>(<span class="methodparam"></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>:</span></td><td><tt class="literal">TRUE</tt> if the tree can be
reordered.</td></tr></tbody></table><p>The <tt class="methodname">get_reorderable</tt>() method returns
the value of the "reorderable" property that determines if the user can
reorder the tree via drag-and-drop. See the <a href="class-gtktreeview.html#method-gtktreeview--set-reorderable" title="gtk.TreeView.set_reorderable"><tt class="methodname">set_reorderable</tt>()</a>
method for more information.</p></div><div class="refsect2" lang="en"><a name="method-gtktreeview--set-cursor"></a><h3>gtk.TreeView.set_cursor</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_cursor</span>(<span class="methodparam"><span class="parameter"><b class="parameter"><tt>path</tt></b></span></span>, <span class="methodparam"><span class="parameter"><b class="parameter"><tt>focus_column</tt></b></span><span class="initializer">=None</span></span>, <span class="methodparam"><span class="parameter"><b class="parameter"><tt>start_editing</tt></b></span><span class="initializer">=False</span></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><b class="parameter"><tt>path</tt></b>:</span></td><td>a tree path</td></tr><tr><td><span class="term"><b class="parameter"><tt>focus_column</tt></b>:</span></td><td>a <a href="class-gtktreeviewcolumn.html" title="gtk.TreeViewColumn"><tt class="classname">gtk.TreeViewColumn</tt></a>,
or <tt class="literal">None</tt></td></tr><tr><td><span class="term"><b class="parameter"><tt>start_editing</tt></b>:</span></td><td><tt class="literal">if TRUE</tt> the specified cell
should start being edited.</td></tr></tbody></table><p>The <tt class="methodname">set_cursor</tt>() method sets the
current keyboard focus to be at the row specified by
<i class="parameter"><tt>path</tt></i>, and selects it. This is useful when you want to
focus the user's attention on a particular row. If
<i class="parameter"><tt>column</tt></i> is not <tt class="literal">None</tt>, then focus is
given to the specified column. Additionally, if
<i class="parameter"><tt>column</tt></i> is specified, and
<i class="parameter"><tt>start_editing</tt></i> is <tt class="literal">TRUE</tt>, then
editing should be started in the specified cell. This method is often
followed by the <a href="class-gtkwidget.html#method-gtkwidget--grab-focus" title="gtk.Widget.grab_focus"><tt class="methodname">gtk.Widget.grab_focus</tt>()</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" lang="en"><a name="method-gtktreeview--set-cursor-on-cell"></a><h3>gtk.TreeView.set_cursor_on_cell</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_cursor_on_cell</span>(<span class="methodparam"><span class="parameter"><b class="parameter"><tt>path</tt></b></span></span>, <span class="methodparam"><span class="parameter"><b class="parameter"><tt>focus_column</tt></b></span><span class="initializer">=None</span></span>, <span class="methodparam"><span class="parameter"><b class="parameter"><tt>focus_cell</tt></b></span><span class="initializer">=None</span></span>, <span class="methodparam"><span class="parameter"><b class="parameter"><tt>start_editing</tt></b></span><span class="initializer">=False</span></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><i class="parameter"><tt>path</tt></i>:</span></td><td>a tree path</td></tr><tr><td><span class="term"><i class="parameter"><tt>focus_column</tt></i>:</span></td><td>a <a href="class-gtktreeviewcolumn.html" title="gtk.TreeViewColumn"><tt class="classname">gtk.TreeViewColumn</tt></a>,
or <tt class="literal">None</tt></td></tr><tr><td><span class="term"><i class="parameter"><tt>focus_cell</tt></i>:</span></td><td>a <a href="class-gtkcellrenderer.html" title="gtk.CellRenderer"><tt class="classname">gtk.CellRenderer</tt></a>,
or <tt class="literal">None</tt></td></tr><tr><td><span class="term"><i class="parameter"><tt>start_editing</tt></i>:</span></td><td><tt class="literal">TRUE</tt> if the specified cell
should start being edited.</td></tr></tbody></table><div class="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 <tt class="methodname">set_cursor_on_cell</tt>() method sets
the current keyboard focus to be at the node specified by
<i class="parameter"><tt>path</tt></i>, and selects it. This is useful when you want
to focus the user's attention on a particular row. If
<i class="parameter"><tt>focus_column</tt></i> is specified, focus is given to that
column. If <i class="parameter"><tt>focus_column</tt></i> and
<i class="parameter"><tt>focus_cell</tt></i> are specified, and
<i class="parameter"><tt>focus_column</tt></i> contains 2 or more editable or
activatable cells, then focus is given to the cell specified by
<i class="parameter"><tt>focus_cell</tt></i>. Additionally, if
<i class="parameter"><tt>focus_column</tt></i> is specified, and
<i class="parameter"><tt>start_editing</tt></i> is <tt class="literal">True</tt>, editing
should be started in the specified cell. This method is often followed by
the <a href="class-gtkwidget.html#method-gtkwidget--grab-focus" title="gtk.Widget.grab_focus"><tt class="methodname">gtk.Widget.grab_focus</tt>()</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" lang="en"><a name="method-gtktreeview--get-cursor"></a><h3>gtk.TreeView.get_cursor</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_cursor</span>(<span class="methodparam"></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>:</span></td><td>a tuple containing the current cursor path and
focus column.</td></tr></tbody></table><p>The <tt class="methodname">get_cursor</tt>() method returns a tuple
containing the current path and focus column. If the cursor isn't currently
set, the current path will be <tt class="literal">None</tt>. If no column
currently has focus, the current focus column will be
<tt class="literal">None</tt>.</p></div><div class="refsect2" lang="en"><a name="method-gtktreeview--get-bin-window"></a><h3>gtk.TreeView.get_bin_window</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_bin_window</span>(<span class="methodparam"></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>:</span></td><td>a <a href="class-gdkwindow.html" title="gtk.gdk.Window"><tt class="classname">gtk.gdk.Window</tt></a>, or
<tt class="literal">None</tt></td></tr></tbody></table><p>The <tt class="methodname">get_bin_window</tt>() method returns the
window that the treeview renders to or <tt class="literal">None</tt> if the
treeview is not realized yet. This is used primarily to compare to the
<tt class="literal">event.window</tt> attribute to confirm that the event on the
treeview is on the right window.</p></div><div class="refsect2" lang="en"><a name="method-gtktreeview--get-path-at-pos"></a><h3>gtk.TreeView.get_path_at_pos</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_path_at_pos</span>(<span class="methodparam"><span class="parameter"><b class="parameter"><tt>x</tt></b></span></span>, <span class="methodparam"><span class="parameter"><b class="parameter"><tt>y</tt></b></span></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><b class="parameter"><tt>x</tt></b>:</span></td><td>The x position to be
identified.</td></tr><tr><td><span class="term"><b class="parameter"><tt>y</tt></b>:</span></td><td>The y position to be
identified.</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>:</span></td><td>a tuple containing: a tree path; a <a href="class-gtktreeviewcolumn.html" title="gtk.TreeViewColumn"><tt class="classname">gtk.TreeViewColumn</tt></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 <tt class="literal">None</tt> is returned.</td></tr></tbody></table><p>The <tt class="methodname">get_path_at_pos</tt>() method returns a
tuple containing:</p><div class="itemizedlist"><ul type="disc"><li>the path at the specified point
(<i class="parameter"><tt>x</tt></i>, <i class="parameter"><tt>y</tt></i>), relative to widget
coordinates</li><li>the <a href="class-gtktreeviewcolumn.html" title="gtk.TreeViewColumn"><tt class="classname">gtk.TreeViewColumn</tt></a>
at that point</li><li>the X coordinate relative to the cell
background</li><li>the Y coordinate relative to the cell
background</li></ul></div><p><i class="parameter"><tt>x</tt></i> and <i class="parameter"><tt>y</tt></i> are
relative to the coordinates of an event on the treeview only when
<tt class="literal">event.window==treeview.get_bin_window()</tt>. It is primarily
used for popup menus. This method is only meaningful if the treeview is
realized. This method returns <tt class="literal">None</tt> if there is no path at
the position.</p></div><div class="refsect2" lang="en"><a name="method-gtktreeview--get-cell-area"></a><h3>gtk.TreeView.get_cell_area</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_cell_area</span>(<span class="methodparam"><span class="parameter"><b class="parameter"><tt>path</tt></b></span></span>, <span class="methodparam"><span class="parameter"><b class="parameter"><tt>column</tt></b></span></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><b class="parameter"><tt>path</tt></b>:</span></td><td>a tree path for the row</td></tr><tr><td><span class="term"><b class="parameter"><tt>column</tt></b>:</span></td><td>a <a href="class-gtktreeviewcolumn.html" title="gtk.TreeViewColumn"><tt class="classname">gtk.TreeViewColumn</tt></a>
for the column</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>:</span></td><td>rectangle</td></tr></tbody></table><p>The <tt class="methodname">get_cell_area</tt>() method returns the
bounding <a href="class-gdkrectangle.html" title="gtk.gdk.Rectangle"><tt class="classname">gtk.gdk.Rectangle</tt></a>
in tree window coordinates for the cell at the row specified by
<i class="parameter"><tt>path</tt></i> and the column specified by
<i class="parameter"><tt>column</tt></i>. If <i class="parameter"><tt>path</tt></i> points to a
path not currently displayed, the <i class="parameter"><tt>y</tt></i> and
<i class="parameter"><tt>height</tt></i> 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
<i class="parameter"><tt>cell_area</tt></i> passed to the <a href="class-gtkcellrenderer.html#method-gtkcellrenderer--render" title="gtk.CellRenderer.render"><tt class="methodname">gtk.CellRenderer.render</tt>()</a>
method. This method is only valid if the treeview is realized.</p></div><div class="refsect2" lang="en"><a name="method-gtktreeview--get-background-area"></a><h3>gtk.TreeView.get_background_area</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_background_area</span>(<span class="methodparam"><span class="parameter"><b class="parameter"><tt>path</tt></b></span></span>, <span class="methodparam"><span class="parameter"><b class="parameter"><tt>column</tt></b></span></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><b class="parameter"><tt>path</tt></b>:</span></td><td>a tree path for the row,</td></tr><tr><td><span class="term"><b class="parameter"><tt>column</tt></b>:</span></td><td>a <a href="class-gtktreeviewcolumn.html" title="gtk.TreeViewColumn"><tt class="classname">gtk.TreeViewColumn</tt></a>
for the column</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>:</span></td><td>a rectangle</td></tr></tbody></table><p>The <tt class="methodname">get_background_area</tt>() method
returns the bounding <a href="class-gdkrectangle.html" title="gtk.gdk.Rectangle"><tt class="classname">gtk.gdk.Rectangle</tt></a>
in tree window coordinates for the cell at the row specified by
<i class="parameter"><tt>path</tt></i> and the column specified by
<i class="parameter"><tt>column</tt></i>. If <i class="parameter"><tt>path</tt></i> points to a
node not found in the tree, the <i class="parameter"><tt>y</tt></i> and
<i class="parameter"><tt>height</tt></i> attributes of the rectangle will be 0. The
returned rectangle is equivalent to the
<i class="parameter"><tt>background_area</tt></i> passed to the <a href="class-gtkcellrenderer.html#method-gtkcellrenderer--render" title="gtk.CellRenderer.render"><tt class="methodname">gtk.CellRenderer.render</tt>()</a>.
These background areas tile to cover the entire tree window (except for the
area used for header buttons). Contrast with the
<i class="parameter"><tt>cell_area</tt></i>, returned by the <a href="class-gtktreeview.html#method-gtktreeview--get-cell-area" title="gtk.TreeView.get_cell_area"><tt class="methodname">get_cell_area</tt>()</a>
method, that returns only the cell itself, excluding the surrounding borders
and the tree expander area.</p></div><div class="refsect2" lang="en"><a name="method-gtktreeview--get-visible-rect"></a><h3>gtk.TreeView.get_visible_rect</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_visible_rect</span>(<span class="methodparam"></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>:</span></td><td>a rectangle</td></tr></tbody></table><p>The <tt class="methodname">get_visible_rect</tt>() method returns
the bounding <a href="class-gdkrectangle.html" title="gtk.gdk.Rectangle"><tt class="classname">gtk.gdk.Rectangle</tt></a>
for the currently visible region of the treeview widget, in tree
coordinates. Convert to widget coordinates with the <a href="class-gtktreeview.html#method-gtktreeview--tree-to-widget-coords" title="gtk.TreeView.tree_to_widget_coords"><tt class="methodname">tree_to_widget_coords</tt>()</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" lang="en"><a name="method-gtktreeview--widget-to-tree-coords"></a><h3>gtk.TreeView.widget_to_tree_coords</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">widget_to_tree_coords</span>(<span class="methodparam"><span class="parameter"><i class="parameter"><tt>wx</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>wy</tt></i></span></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><i class="parameter"><tt>wx</tt></i>:</span></td><td>the widget X coordinate</td></tr><tr><td><span class="term"><i class="parameter"><tt>wy</tt></i>:</span></td><td>the widget Y coordinate</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>:</span></td><td>a tuple containing the tree X and Y
coordinates</td></tr></tbody></table><p>The <tt class="methodname">widget_to_tree_coords</tt>() method
returns a tuple containing the tree X and Y coordinates for the widget
coordinates specified by <i class="parameter"><tt>wx</tt></i> and
<i class="parameter"><tt>wy</tt></i>. The tree coordinates cover the full scrollable
area of the tree.</p></div><div class="refsect2" lang="en"><a name="method-gtktreeview--tree-to-widget-coords"></a><h3>gtk.TreeView.tree_to_widget_coords</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">tree_to_widget_coords</span>(<span class="methodparam"><span class="parameter"><i class="parameter"><tt>tx</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>ty</tt></i></span></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><i class="parameter"><tt>tx</tt></i>:</span></td><td>tree X coordinate</td></tr><tr><td><span class="term"><i class="parameter"><tt>ty</tt></i>:</span></td><td>tree Y coordinate</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>:</span></td><td>a tuple containing the widget X and Y
coordinates</td></tr></tbody></table><p>The <tt class="methodname">tree_to_widget_coords</tt>() method
returns a tuple containing the widget coordinates for the tree coordinates
specified by <i class="parameter"><tt>tx</tt></i> and <i class="parameter"><tt>ty</tt></i>.</p></div><div class="refsect2" lang="en"><a name="method-gtktreeview--enable-model-drag-source"></a><h3>gtk.TreeView.enable_model_drag_source</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">enable_model_drag_source</span>(<span class="methodparam"><span class="parameter"><b class="parameter"><tt>start_button_mask</tt></b></span></span>, <span class="methodparam"><span class="parameter"><b class="parameter"><tt>targets</tt></b></span></span>, <span class="methodparam"><span class="parameter"><b class="parameter"><tt>actions</tt></b></span></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><b class="parameter"><tt>start_button_mask</tt></b>:</span></td><td>the bitmask of buttons that can start the
drag</td></tr><tr><td><span class="term"><b class="parameter"><tt>targets</tt></b>:</span></td><td>a sequence of tuples containing target
data</td></tr><tr><td><span class="term"><b class="parameter"><tt>actions</tt></b>:</span></td><td>the possible actions for a
drag</td></tr></tbody></table><p>The <tt class="methodname">enable_model_drag_source</tt>() method
sets the treeview to start a drag operation when the user click and drags on
a row. The value of <i class="parameter"><tt>start_button_mask</tt></i> is a
combination of:</p><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><tt class="literal">gtk.gdk.SHIFT_MASK</tt></span></td><td>The Shift key.</td></tr><tr><td><span class="term"><tt class="literal">gtk.gdk.LOCK_MASK</tt></span></td><td>A Lock key (depending on the modifier mapping of the X
server this may either be Caps Lock or Shift Lock).</td></tr><tr><td><span class="term"><tt class="literal">gtk.gdk.CONTROL_MASK</tt></span></td><td>The Control key. </td></tr><tr><td><span class="term"><tt class="literal">gtk.gdk.MOD1_MASK</tt></span></td><td>The fourth modifier key (it depends on the modifier
mapping of the X server which key is interpreted as this modifier, but
normally it is the Alt key).</td></tr><tr><td><span class="term"><tt class="literal">gtk.gdk.MOD2_MASK</tt></span></td><td>The fifth modifier key (it depends on the modifier
mapping of the X server which key is interpreted as this
modifier).</td></tr><tr><td><span class="term"><tt class="literal">gtk.gdk.MOD3_MASK</tt></span></td><td>The sixth modifier key (it depends on the modifier
mapping of the X server which key is interpreted as this
modifier).</td></tr><tr><td><span class="term"><tt class="literal">gtk.gdk.MOD4_MASK</tt></span></td><td>The seventh modifier key (it depends on the modifier
mapping of the X server which key is interpreted as this
modifier).</td></tr><tr><td><span class="term"><tt class="literal">gtk.gdk.MOD5_MASK</tt></span></td><td>The eighth modifier key (it depends on the modifier
mapping of the X server which key is interpreted as this
modifier).</td></tr><tr><td><span class="term"><tt class="literal">gtk.gdk.BUTTON1_MASK</tt></span></td><td>The first mouse button.</td></tr><tr><td><span class="term"><tt class="literal">gtk.gdk.BUTTON2_MASK</tt></span></td><td>The second mouse button.</td></tr><tr><td><span class="term"><tt class="literal">gtk.gdk.BUTTON3_MASK</tt></span></td><td>The third mouse button.</td></tr><tr><td><span class="term"><tt class="literal">gtk.gdk.BUTTON4_MASK</tt></span></td><td>The fourth mouse button.</td></tr><tr><td><span class="term"><tt class="literal">gtk.gdk.BUTTON5_MASK</tt></span></td><td>The fifth mouse button.</td></tr><tr><td><span class="term"><tt class="literal">gtk.gdk.RELEASE_MASK</tt></span></td><td>Differentiates between (keyval, modifiers) pairs from
key press and release events.</td></tr><tr><td><span class="term"><tt class="literal">gtk.gdk.MODIFIER_MASK</tt></span></td><td>all of the above</td></tr></tbody></table><p><i class="parameter"><tt>targets</tt></i> 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
<tt class="literal">gtk.TARGET_SAME_APP</tt> and
<tt class="literal">gtk.TARGET_SAME_WIDGET</tt> or neither) and an application
assigned integer ID used for identification purposes.</p><p>The value of <i class="parameter"><tt>actions</tt></i> is one of:</p><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><tt class="literal">gtk.gdk.ACTION_DEFAULT</tt>, </span><span class="term"><tt class="literal">gtk.gdk.ACTION_COPY</tt>, </span></td><td>Copy the data.</td></tr><tr><td><span class="term"><tt class="literal">gtk.gdk.ACTION_MOVE</tt></span></td><td>Move the data, i.e. first copy it, then delete it from
the source using the <tt class="literal">DELETE</tt> target of the X selection
protocol.</td></tr><tr><td><span class="term"><tt class="literal">gtk.gdk.ACTION_LINK</tt></span></td><td>Add a link to the data. Note that this is only useful
if source and destination agree on what it means.</td></tr><tr><td><span class="term"><tt class="literal">gtk.gdk.ACTION_PRIVATE</tt></span></td><td>Special action which tells the source that the
destination will do something that the source doesn't understand.</td></tr><tr><td><span class="term"><tt class="literal">gtk.gdk.ACTION_ASK</tt></span></td><td>Ask the user what to do with the data.</td></tr></tbody></table><p></p></div><div class="refsect2" lang="en"><a name="method-gtktreeview--enable-model-drag-dest"></a><h3>gtk.TreeView.enable_model_drag_dest</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">enable_model_drag_dest</span>(<span class="methodparam"><span class="parameter"><b class="parameter"><tt>targets</tt></b></span></span>, <span class="methodparam"><span class="parameter"><b class="parameter"><tt>actions</tt></b></span></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><b class="parameter"><tt>targets</tt></b>:</span></td><td>a sequence of tuples containing target
data</td></tr><tr><td><span class="term"><b class="parameter"><tt>actions</tt></b>:</span></td><td>the possible actions for a
drag</td></tr></tbody></table><p>The <tt class="methodname">enable_model_drag_dest</tt>() method
sets the treeview to receive a drag drop.</p><p><i class="parameter"><tt>targets</tt></i> 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
<tt class="literal">gtk.TARGET_SAME_APP</tt> and
<tt class="literal">gtk.TARGET_SAME_WIDGET</tt> or neither) and an application
assigned integer ID used for identification purposes.</p><p>The value of <i class="parameter"><tt>actions</tt></i> is one of:</p><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><tt class="literal">gtk.gdk.ACTION_DEFAULT</tt>, </span><span class="term"><tt class="literal">gtk.gdk.ACTION_COPY</tt>, </span></td><td>Copy the data.</td></tr><tr><td><span class="term"><tt class="literal">gtk.gdk.ACTION_MOVE</tt></span></td><td>Move the data, i.e. first copy it, then delete it from
the source using the <tt class="literal">DELETE</tt> target of the X selection
protocol.</td></tr><tr><td><span class="term"><tt class="literal">gtk.gdk.ACTION_LINK</tt></span></td><td>Add a link to the data. Note that this is only useful
if source and destination agree on what it means.</td></tr><tr><td><span class="term"><tt class="literal">gtk.gdk.ACTION_PRIVATE</tt></span></td><td>Special action which tells the source that the
destination will do something that the source doesn't understand.</td></tr><tr><td><span class="term"><tt class="literal">gtk.gdk.ACTION_ASK</tt></span></td><td>Ask the user what to do with the data.</td></tr></tbody></table><p></p></div><div class="refsect2" lang="en"><a name="method-gtktreeview--unset-rows-drag-source"></a><h3>gtk.TreeView.unset_rows_drag_source</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">unset_rows_drag_source</span>(<span class="methodparam"></span>)</code></pre></td></tr></table><p>The <tt class="methodname">unset_rows_drag_source</tt>() method
unsets the drag source information.</p></div><div class="refsect2" lang="en"><a name="method-gtktreeview--unset-rows-drag-dest"></a><h3>gtk.TreeView.unset_rows_drag_dest</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">unset_rows_drag_dest</span>(<span class="methodparam"></span>)</code></pre></td></tr></table><p>The <tt class="methodname">unset_rows_drag_dest</tt>() method
unsets the drag destination information.</p></div><div class="refsect2" lang="en"><a name="method-gtktreeview--set-drag-dest-row"></a><h3>gtk.TreeView.set_drag_dest_row</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_drag_dest_row</span>(<span class="methodparam"><span class="parameter"><b class="parameter"><tt>path</tt></b></span></span>, <span class="methodparam"><span class="parameter"><b class="parameter"><tt>pos</tt></b></span></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><b class="parameter"><tt>path</tt></b>:</span></td><td>a tree path</td></tr><tr><td><span class="term"><b class="parameter"><tt>pos</tt></b>:</span></td><td>a drop position</td></tr></tbody></table><p>The <tt class="methodname">set_drag_dest_row</tt>() method sets the
treeview drag destination row to the value specified by
<i class="parameter"><tt>path</tt></i> with the drop position specified by
<i class="parameter"><tt>pos</tt></i>. The value of <i class="parameter"><tt>pos</tt></i> must be
one of: <tt class="literal">gtk.TREE_VIEW_DROP_BEFORE</tt>,
<tt class="literal">gtk.TREE_VIEW_DROP_AFTER</tt>,
<tt class="literal">gtk.TREE_VIEW_DROP_INTO_OR_BEFORE</tt> or
<tt class="literal">gtk.TREE_VIEW_DROP_INTO_OR_AFTER</tt>.</p></div><div class="refsect2" lang="en"><a name="method-gtktreeview--get-drag-dest-row"></a><h3>gtk.TreeView.get_drag_dest_row</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_drag_dest_row</span>(<span class="methodparam"></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>:</span></td><td>a 2-tuple containing the tree path and the drop
position relative to the tree path or <tt class="literal">
None</tt></td></tr></tbody></table><p>The <tt class="methodname">get_drag_dest_row</tt>() 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:
<tt class="literal">gtk.TREE_VIEW_DROP_BEFORE</tt>,
<tt class="literal">gtk.TREE_VIEW_DROP_AFTER</tt>,
<tt class="literal">gtk.TREE_VIEW_DROP_INTO_OR_BEFORE</tt> or
<tt class="literal">gtk.TREE_VIEW_DROP_INTO_OR_AFTER</tt>. This method returns
<tt class="literal">None</tt> if no drag destination row is set.</p></div><div class="refsect2" lang="en"><a name="method-gtktreeview--get-dest-row-at-pos"></a><h3>gtk.TreeView.get_dest_row_at_pos</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_dest_row_at_pos</span>(<span class="methodparam"><span class="parameter"><b class="parameter"><tt>x</tt></b></span></span>, <span class="methodparam"><span class="parameter"><b class="parameter"><tt>y</tt></b></span></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><b class="parameter"><tt>x</tt></b>:</span></td><td>the x coordinate of the
position</td></tr><tr><td><span class="term"><b class="parameter"><tt>y</tt></b>:</span></td><td>the y coordinate of the
position</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>:</span></td><td>a 2-tuple containing the path of the row and
the drop position at the position specified by <i class="parameter"><tt>x</tt></i> and
<i class="parameter"><tt>y</tt></i> or <tt class="literal">None</tt></td></tr></tbody></table><p>The <tt class="methodname">get_dest_row_at_pos</tt>() method
returns a 2-tuple containing the path of the row and the drop position
relative to the row of the position specified by <i class="parameter"><tt>x</tt></i>
and <i class="parameter"><tt>y</tt></i>. The drop position is one of:
<tt class="literal">gtk.TREE_VIEW_DROP_BEFORE</tt>,
<tt class="literal">gtk.TREE_VIEW_DROP_AFTER</tt>,
<tt class="literal">gtk.TREE_VIEW_DROP_INTO_OR_BEFORE</tt> or
<tt class="literal">gtk.TREE_VIEW_DROP_INTO_OR_AFTER</tt>.</p></div><div class="refsect2" lang="en"><a name="method-gtktreeview--create-row-drag-icon"></a><h3>gtk.TreeView.create_row_drag_icon</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">create_row_drag_icon</span>(<span class="methodparam"><span class="parameter"><b class="parameter"><tt>path</tt></b></span></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><b class="parameter"><tt>path</tt></b>:</span></td><td>a tree path</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>:</span></td><td>a new pixmap of the drag
icon.</td></tr></tbody></table><p>The <tt class="methodname">create_row_drag_icon</tt>() method
creates a <a href="class-gdkpixmap.html" title="gtk.gdk.Pixmap"><tt class="classname">gtk.gdk.Pixmap</tt></a>
representation of the row specified by <i class="parameter"><tt>path</tt></i>. This
image is used for a drag icon.</p></div><div class="refsect2" lang="en"><a name="method-gtktreeview--set-enable-search"></a><h3>gtk.TreeView.set_enable_search</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_enable_search</span>(<span class="methodparam"><span class="parameter"><b class="parameter"><tt>enable_search</tt></b></span></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><b class="parameter"><tt>enable_search</tt></b>:</span></td><td>if <tt class="literal">TRUE</tt>, the user can search
interactively</td></tr></tbody></table><p>The <tt class="methodname">set_enable_search</tt>() method sets the
"enable-search" property to the value of
<i class="parameter"><tt>enable_search</tt></i>. If
<i class="parameter"><tt>enable_search</tt></i> is <tt class="literal">TRUE</tt> the user can
type in text to search through the tree interactively.</p></div><div class="refsect2" lang="en"><a name="method-gtktreeview--get-enable-search"></a><h3>gtk.TreeView.get_enable_search</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_enable_search</span>(<span class="methodparam"></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>:</span></td><td><tt class="literal">TRUE</tt> if the user can search
interactively</td></tr></tbody></table><p>The <tt class="methodname">get_enable_search</tt>() method returns
the value of the "enable-search" property. If "enable-search" is
<tt class="literal">TRUE</tt> the tree allows interactive searching.</p></div><div class="refsect2" lang="en"><a name="method-gtktreeview--get-search-column"></a><h3>gtk.TreeView.get_search_column</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_search_column</span>(<span class="methodparam"></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>:</span></td><td>the column the interactive search code
searches.</td></tr></tbody></table><p>The <tt class="methodname">get_search_column</tt>() method returns
the value of the "search-column" property that is the column searched by
the interactive search code.</p></div><div class="refsect2" lang="en"><a name="method-gtktreeview--set-search-column"></a><h3>gtk.TreeView.set_search_column</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_search_column</span>(<span class="methodparam"><span class="parameter"><b class="parameter"><tt>column</tt></b></span></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><b class="parameter"><tt>column</tt></b>:</span></td><td>the column to search</td></tr></tbody></table><p>The <tt class="methodname">set_search_column</tt>() method sets the
"search-column" property to the value of <i class="parameter"><tt>column</tt></i>. The
value of <i class="parameter"><tt>column</tt></i> is the column where the interactive
search code should search. Additionally, this method turns on interactive
searching (see the <a href="class-gtktreeview.html#method-gtktreeview--set-enable-search" title="gtk.TreeView.set_enable_search"><tt class="methodname">set_enable_search</tt>()</a>
method).</p></div><div class="refsect2" lang="en"><a name="method-gtktreeview--set-search-equal-func"></a><h3>gtk.TreeView.set_search_equal_func</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_search_equal_func</span>(<span class="methodparam"><span class="parameter"><b class="parameter"><tt>func</tt></b></span><span class="initializer">=None</span></span>, <span class="methodparam"><span class="parameter"><b class="parameter"><tt>user_data</tt></b></span><span class="initializer">=None</span></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><b class="parameter"><tt>func</tt></b>:</span></td><td>the compare function to use during the search or <tt class="literal">None</tt></td></tr><tr><td><span class="term"><b class="parameter"><tt>user_data</tt></b>:</span></td><td>user data to pass to <i class="parameter"><tt>func</tt></i>, or <tt class="literal">None</tt></td></tr></tbody></table><div class="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 <tt class="methodname">set_search_equal_func</tt>() method sets
the compare function for the interactive search capabilities to the function
specified by <i class="parameter"><tt>func</tt></i>. If
<i class="parameter"><tt>user_data</tt></i> is specified and not
<tt class="literal">None</tt>, it is passed to <i class="parameter"><tt>func</tt></i>. If
<i class="parameter"><tt>func</tt></i> is <tt class="literal">None</tt>, the default <a href="class-gtktreeview.html" title="gtk.TreeView"><tt class="classname">gtk.TreeView</tt></a>
search equal function will be used. The signature of
<i class="parameter"><tt>func</tt></i> is:</p><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting">
def func(<i class="parameter"><tt>model</tt></i>, <i class="parameter"><tt>column</tt></i>, <i class="parameter"><tt>key</tt></i>, <i class="parameter"><tt>iter</tt></i>, <i class="parameter"><tt>data</tt></i>)
</pre></td></tr></table><p>where <i class="parameter"><tt>model</tt></i> is the <a href="class-gtktreemodel.html" title="gtk.TreeModel"><tt class="classname">gtk.TreeModel</tt></a> of
the <a href="class-gtktreeview.html" title="gtk.TreeView"><tt class="classname">gtk.TreeView</tt></a>,
<i class="parameter"><tt>column</tt></i> is the number of the column being searched
(see the <a href="class-gtktreeview.html#method-gtktreeview--set-search-column" title="gtk.TreeView.set_search_column"><tt class="methodname">set_search_column</tt>()</a>
method for more information), <i class="parameter"><tt>key</tt></i> is the string being
searched for, <i class="parameter"><tt>iter</tt></i> is a <a href="class-gtktreeiter.html" title="gtk.TreeIter"><tt class="classname">gtk.TreeIter</tt></a>
pointing to the current candidate row and <i class="parameter"><tt>data</tt></i> is the
context data <i class="parameter"><tt>user_data</tt></i>. <i class="parameter"><tt>func</tt></i>
should return <tt class="literal">FALSE</tt> to indicate that the row matches the
search criteria.</p></div><div class="refsect2" lang="en"><a name="method-gtktreeview--get-fixed-height-mode"></a><h3>gtk.TreeView.get_fixed_height_mode</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_fixed_height_mode</span>(<span class="methodparam"></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>:</span></td><td><tt class="literal">TRUE</tt> if fixed height mode
is enabled.</td></tr></tbody></table><div class="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 <tt class="methodname">get_fixed_height_mode</tt>() method
returns the value of the "fixed-height-mode" property. If the
"fixed-height-mode" property is <tt class="literal">TRUE</tt>, all rows are
assumed to be the same height.</p></div><div class="refsect2" lang="en"><a name="method-gtktreeview--set-fixed-height-mode"></a><h3>gtk.TreeView.set_fixed_height_mode</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_fixed_height_mode</span>(<span class="methodparam"><span class="parameter"><b class="parameter"><tt>enable</tt></b></span></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><b class="parameter"><tt>enable</tt></b>:</span></td><td>if <tt class="literal">TRUE</tt> enable fixed height
mode.</td></tr></tbody></table><div class="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 <tt class="methodname">set_fixed_height_mode</tt>() method sets
the "fixed-height-mode" property to the value of
<i class="parameter"><tt>enable</tt></i>. If <i class="parameter"><tt>enable</tt></i> is
<tt class="literal">TRUE</tt> all rows are assumed to have the same height which
speeds up <a href="class-gtktreeview.html" title="gtk.TreeView"><tt class="classname">gtk.TreeView</tt></a>
displays. Only enable this option if all rows are the same height and all
columns are of type <tt class="literal">gtk.TREE_VIEW_COLUMN_FIXED</tt> (see the
<a href="gtk-constants.html#gtk-treeviewcolumn-sizing-constants">GTK TreeViewColumn Sizing Constants</a>).</p></div><div class="refsect2" lang="en"><a name="method-gtktreeview--get-hover-selection"></a><h3>gtk.TreeView.get_hover_selection</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_hover_selection</span>(<span class="methodparam"></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>:</span></td><td><tt class="literal">TRUE</tt> if hover selection
mode is enabled.</td></tr></tbody></table><div class="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 <tt class="methodname">get_hover_selection</tt>() method
returns the value of the "hover-selection" property. If the
"hover-selection" property is <tt class="literal">TRUE</tt> the selected row
follows the pointer. See the <a href="class-gtktreeview.html#method-gtktreeview--set-hover-selection" title="gtk.TreeView.set_hover_selection"><tt class="methodname">set_hover_selection</tt>()</a>
method for more detail.</p></div><div class="refsect2" lang="en"><a name="method-gtktreeview--set-hover-selection"></a><h3>gtk.TreeView.set_hover_selection</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_hover_selection</span>(<span class="methodparam"><span class="parameter"><b class="parameter"><tt>hover</tt></b></span></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><b class="parameter"><tt>hover</tt></b>:</span></td><td>if <tt class="literal">TRUE</tt> enable hover
selection mode.</td></tr></tbody></table><div class="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 <tt class="methodname"></tt>() method sets the
"hover-selection" property to the value of <i class="parameter"><tt>hover</tt></i>. If
<i class="parameter"><tt>hover</tt></i> is <tt class="literal">TRUE</tt> the hover selection
mode is enables and the selected row follows the pointer. Currently, this
works only for the selection modes <tt class="literal">gtk.SELECTION_SINGLE</tt>
and <tt class="literal">gtk.SELECTION_BROWSE</tt> (see the <a href="gtk-constants.html#gtk-selection-mode-constants">GTK Selection Mode Constants</a>).</p></div><div class="refsect2" lang="en"><a name="method-gtktreeview--get-hover-expand"></a><h3>gtk.TreeView.get_hover_expand</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_hover_expand</span>(<span class="methodparam"></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>:</span></td><td><tt class="literal">TRUE</tt> if hover expand mode is
enabled</td></tr></tbody></table><div class="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 <tt class="methodname">get_hover_expand</tt>() method returns
the value of the "hover-expand" property. If the "hover-expand" property is
<tt class="literal">TRUE</tt> rows expand or collapse if the pointer moves over
them.</p></div><div class="refsect2" lang="en"><a name="method-gtktreeview--set-hover-expand"></a><h3>gtk.TreeView.set_hover_expand</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_hover_expand</span>(<span class="methodparam"><span class="parameter"><b class="parameter"><tt>expand</tt></b></span></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><b class="parameter"><tt>expand</tt></b>:</span></td><td>if <tt class="literal">TRUE</tt> enable hover expand
mode.</td></tr></tbody></table><div class="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 <tt class="methodname">set_hover_expand</tt>() method sets the
"hover-expand" property to the value of <i class="parameter"><tt>expand</tt></i>. If
<i class="parameter"><tt>expand</tt></i> is <tt class="literal">TRUE</tt>, rows expand or
collapse if the pointer moves over them. </p></div><div class="refsect2" lang="en"><a name="method-gtktreeview--set-row-separator-func"></a><h3>gtk.TreeView.set_row_separator_func</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_row_separator_func</span>(<span class="methodparam"><span class="parameter"><b class="parameter"><tt>func</tt></b></span><span class="initializer">=None</span></span>, <span class="methodparam"><span class="parameter"><b class="parameter"><tt>user_data</tt></b></span><span class="initializer">=None</span></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><b class="parameter"><tt>func</tt></b>:</span></td><td>the row separator function or
<tt class="literal">None</tt></td></tr><tr><td><span class="term"><b class="parameter"><tt>user_data</tt></b>:</span></td><td>user data to pass to <i class="parameter"><tt>func</tt></i>, or <tt class="literal">None</tt></td></tr></tbody></table><div class="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 <tt class="methodname">set_row_separator_func</tt>() method
sets the row separator function to the function specified by
<i class="parameter"><tt>func</tt></i>. The row separator function is used to determine
if a row should be displayed as a separator. If
<i class="parameter"><tt>user_data</tt></i> is specified and not
<tt class="literal">None</tt>, it is passed to <i class="parameter"><tt>func</tt></i>. If
<i class="parameter"><tt>func</tt></i> is <tt class="literal">None</tt>, no separators will
be drawn. The signature of <i class="parameter"><tt>func</tt></i> is:</p><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting">
def func(<i class="parameter"><tt>model</tt></i>, <i class="parameter"><tt>iter</tt></i>, <i class="parameter"><tt>data</tt></i>)
</pre></td></tr></table><p>where <i class="parameter"><tt>model</tt></i> is the <a href="class-gtktreemodel.html" title="gtk.TreeModel"><tt class="classname">gtk.TreeModel</tt></a> of
the <a href="class-gtktreeview.html" title="gtk.TreeView"><tt class="classname">gtk.TreeView</tt></a>,
<i class="parameter"><tt>iter</tt></i> is a <a href="class-gtktreeiter.html" title="gtk.TreeIter"><tt class="classname">gtk.TreeIter</tt></a>
pointing to the current candidate row and <i class="parameter"><tt>data</tt></i> is the
context data <i class="parameter"><tt>user_data</tt></i>. <i class="parameter"><tt>func</tt></i>
should return <tt class="literal">TRUE</tt> to indicate that the row is a
separator.</p><p>A common way to implement this is to have a boolean column in
<i class="parameter"><tt>model</tt></i>, whose values <i class="parameter"><tt>func</tt></i>
returns.</p></div></div><div class="refsect1" lang="en"><a name="id3605586"></a><h2>Signals</h2><div class="refsect2" lang="en"><a name="signal-gtktreeview--columns-changed"></a><h3>The "columns-changed" gtk.TreeView Signal</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><i class="parameter"><tt>treeview</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>user_param1</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>...</tt></i></span></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><i class="parameter"><tt>treeview</tt></i>:</span></td><td>the treeview that received the
signal</td></tr><tr><td><span class="term"><i class="parameter"><tt>user_param1</tt></i>:</span></td><td>the first user parameter (if any) specified
with the <a href="class-gobject.html#method-gobject--connect" title="gobject.GObject.connect"><tt class="methodname">connect</tt>()</a>
method</td></tr><tr><td><span class="term"><i class="parameter"><tt>...</tt></i>:</span></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 <i class="parameter"><tt>treeview</tt></i>.</p></div><div class="refsect2" lang="en"><a name="signal-gtktreeview--cursor-changed"></a><h3>The "cursor-changed" gtk.TreeView Signal</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><i class="parameter"><tt>treeview</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>user_param1</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>...</tt></i></span></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><i class="parameter"><tt>treeview</tt></i>:</span></td><td>the treeview that received the
signal</td></tr><tr><td><span class="term"><i class="parameter"><tt>user_param1</tt></i>:</span></td><td>the first user parameter (if any) specified
with the <a href="class-gobject.html#method-gobject--connect" title="gobject.GObject.connect"><tt class="methodname">connect</tt>()</a>
method</td></tr><tr><td><span class="term"><i class="parameter"><tt>...</tt></i>:</span></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" lang="en"><a name="signal-gtktreeview--expand-collapse-cursor-row"></a><h3>The "expand-collapse-cursor-row" gtk.TreeView Signal</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><i class="parameter"><tt>treeview</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>logical</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>expand</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>open_all</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>user_param1</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>...</tt></i></span></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><i class="parameter"><tt>treeview</tt></i>:</span></td><td>the treeview that received the
signal</td></tr><tr><td><span class="term"><i class="parameter"><tt>logical</tt></i>:</span></td><td>if <tt class="literal">TRUE</tt>
</td></tr><tr><td><span class="term"><i class="parameter"><tt>expand</tt></i>:</span></td><td>if <tt class="literal">TRUE</tt> the row should be
expanded</td></tr><tr><td><span class="term"><i class="parameter"><tt>open_all</tt></i>:</span></td><td>if <tt class="literal">TRUE</tt> recursively expand
all children</td></tr><tr><td><span class="term"><i class="parameter"><tt>user_param1</tt></i>:</span></td><td>the first user parameter (if any) specified
with the <a href="class-gobject.html#method-gobject--connect" title="gobject.GObject.connect"><tt class="methodname">connect</tt>()</a>
method</td></tr><tr><td><span class="term"><i class="parameter"><tt>...</tt></i>:</span></td><td>additional user parameters (if
any)</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>:</span></td><td><tt class="literal">TRUE</tt> 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" lang="en"><a name="signal-gtktreeview--move-cursor"></a><h3>The "move-cursor" gtk.TreeView Signal</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><i class="parameter"><tt>treeview</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>step</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>count</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>user_param1</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>...</tt></i></span></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><i class="parameter"><tt>treeview</tt></i>:</span></td><td>the treeview that received the
signal</td></tr><tr><td><span class="term"><i class="parameter"><tt>step</tt></i>:</span></td><td>the movement step size</td></tr><tr><td><span class="term"><i class="parameter"><tt>count</tt></i>:</span></td><td>the number of steps to
take</td></tr><tr><td><span class="term"><i class="parameter"><tt>user_param1</tt></i>:</span></td><td>the first user parameter (if any) specified
with the <a href="class-gobject.html#method-gobject--connect" title="gobject.GObject.connect"><tt class="methodname">connect</tt>()</a>
method</td></tr><tr><td><span class="term"><i class="parameter"><tt>...</tt></i>:</span></td><td>additional user parameters (if
any)</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>:</span></td><td><tt class="literal">TRUE</tt> 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><b class="keycap">Right</b></span>, <span><b class="keycap">Left</b></span>,
<span><b class="keycap">Up</b></span> or <span><b class="keycap">Down</b></span> arrow keys or the
<span><b class="keycap">Page Up</b></span>, <span><b class="keycap">Page Down</b></span>, <span><b class="keycap">Home</b></span>
and <span><b class="keycap">End</b></span> keys.</p></div><div class="refsect2" lang="en"><a name="signal-gtktreeview--row-activated"></a><h3>The "row-activated" gtk.TreeView Signal</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><i class="parameter"><tt>treeview</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>path</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>view_column</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>user_param1</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>...</tt></i></span></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><i class="parameter"><tt>treeview</tt></i>:</span></td><td>the treeview that received the
signal</td></tr><tr><td><span class="term"><i class="parameter"><tt>path</tt></i>:</span></td><td>the path of the activated
row</td></tr><tr><td><span class="term"><i class="parameter"><tt>view_column</tt></i>:</span></td><td>the column in the activated
row</td></tr><tr><td><span class="term"><i class="parameter"><tt>user_param1</tt></i>:</span></td><td>the first user parameter (if any) specified
with the <a href="class-gobject.html#method-gobject--connect" title="gobject.GObject.connect"><tt class="methodname">connect</tt>()</a>
method</td></tr><tr><td><span class="term"><i class="parameter"><tt>...</tt></i>:</span></td><td>additional user parameters (if
any)</td></tr></tbody></table><p>The "row-activated" signal is emitted when the <a href="class-gtktreeview.html#method-gtktreeview--row-activated" title="gtk.TreeView.row_activated"><tt class="methodname">row_activated</tt>()</a>
method is called or the user double clicks a <i class="parameter"><tt>treeview</tt></i>
row. "row-activated" is also emitted when a non-editable row is selected and
one of the keys: <span><b class="keycap">Space</b></span>, <span><b class="keycap">Shift</b></span>+<span><b class="keycap">Space</b></span>,
<span><b class="keycap">Return</b></span> or <span><b class="keycap">Enter</b></span> is pressed.</p></div><div class="refsect2" lang="en"><a name="signal-gtktreeview--row-collapsed"></a><h3>The "row-collapsed" gtk.TreeView Signal</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><i class="parameter"><tt>treeview</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>iter</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>path</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>user_param1</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>...</tt></i></span></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><i class="parameter"><tt>treeview</tt></i>:</span></td><td>the treeview that received the
signal</td></tr><tr><td><span class="term"><i class="parameter"><tt>iter</tt></i>:</span></td><td>a <a href="class-gtktreeiter.html" title="gtk.TreeIter"><tt class="classname">gtk.TreeIter</tt></a>
pointing to the row that collapsed</td></tr><tr><td><span class="term"><i class="parameter"><tt>path</tt></i>:</span></td><td>the path of the row that
collapsed</td></tr><tr><td><span class="term"><i class="parameter"><tt>user_param1</tt></i>:</span></td><td>the first user parameter (if any) specified
with the <a href="class-gobject.html#method-gobject--connect" title="gobject.GObject.connect"><tt class="methodname">connect</tt>()</a>
method</td></tr><tr><td><span class="term"><i class="parameter"><tt>...</tt></i>:</span></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" lang="en"><a name="signal-gtktreeview--row-expanded"></a><h3>The "row-expanded" gtk.TreeView Signal</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><i class="parameter"><tt>treeview</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>iter</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>path</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>user_param1</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>...</tt></i></span></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><i class="parameter"><tt>treeview</tt></i>:</span></td><td>the treeview that received the
signal</td></tr><tr><td><span class="term"><i class="parameter"><tt>iter</tt></i>:</span></td><td>a <a href="class-gtktreeiter.html" title="gtk.TreeIter"><tt class="classname">gtk.TreeIter</tt></a>
pointing to the row that expanded</td></tr><tr><td><span class="term"><i class="parameter"><tt>path</tt></i>:</span></td><td>the path of the row that
expanded</td></tr><tr><td><span class="term"><i class="parameter"><tt>user_param1</tt></i>:</span></td><td>the first user parameter (if any) specified
with the <a href="class-gobject.html#method-gobject--connect" title="gobject.GObject.connect"><tt class="methodname">connect</tt>()</a>
method</td></tr><tr><td><span class="term"><i class="parameter"><tt>...</tt></i>:</span></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" lang="en"><a name="signal-gtktreeview--select-all"></a><h3>The "select-all" gtk.TreeView Signal</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><i class="parameter"><tt>treeview</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>user_param1</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>...</tt></i></span></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><i class="parameter"><tt>treeview</tt></i>:</span></td><td>the treeview that received the
signal</td></tr><tr><td><span class="term"><i class="parameter"><tt>user_param1</tt></i>:</span></td><td>the first user parameter (if any) specified
with the <a href="class-gobject.html#method-gobject--connect" title="gobject.GObject.connect"><tt class="methodname">connect</tt>()</a>
method</td></tr><tr><td><span class="term"><i class="parameter"><tt>...</tt></i>:</span></td><td>additional user parameters (if
any)</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>:</span></td><td><tt class="literal">TRUE</tt> if the signal was
handled.</td></tr></tbody></table><p>The "select-all" signal is emitted when the user presses
<span><b class="keycap">Control</b></span>+<span><b class="keycap">a</b></span> or <span><b class="keycap">Control</b></span>+<span><b class="keycap">/</b></span>.</p></div><div class="refsect2" lang="en"><a name="signal-gtktreeview--select-cursor-parent"></a><h3>The "select-cursor-parent" gtk.TreeView Signal</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><i class="parameter"><tt>treeview</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>user_param1</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>...</tt></i></span></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><i class="parameter"><tt>treeview</tt></i>:</span></td><td>the treeview that received the
signal</td></tr><tr><td><span class="term"><i class="parameter"><tt>user_param1</tt></i>:</span></td><td>the first user parameter (if any) specified
with the <a href="class-gobject.html#method-gobject--connect" title="gobject.GObject.connect"><tt class="methodname">connect</tt>()</a>
method</td></tr><tr><td><span class="term"><i class="parameter"><tt>...</tt></i>:</span></td><td>additional user parameters (if
any)</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>:</span></td><td><tt class="literal">TRUE</tt> if the signal was
handled.</td></tr></tbody></table><p>The "select-cursor-parent" signal is emitted when the user
presses <span><b class="keycap">Backspace</b></span> while
a row has the cursor.</p></div><div class="refsect2" lang="en"><a name="signal-gtktreeview--select-cursor-row"></a><h3>The "select-cursor-row" gtk.TreeView Signal</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><i class="parameter"><tt>treeview</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>start_editing</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>user_param1</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>...</tt></i></span></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><i class="parameter"><tt>treeview</tt></i>:</span></td><td>the treeview that received the
signal</td></tr><tr><td><span class="term"><i class="parameter"><tt>start_editing</tt></i>:</span></td><td>if <tt class="literal">TRUE</tt> the cell editing is
started</td></tr><tr><td><span class="term"><i class="parameter"><tt>user_param1</tt></i>:</span></td><td>the first user parameter (if any) specified
with the <a href="class-gobject.html#method-gobject--connect" title="gobject.GObject.connect"><tt class="methodname">connect</tt>()</a>
method</td></tr><tr><td><span class="term"><i class="parameter"><tt>...</tt></i>:</span></td><td>additional user parameters (if
any)</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>:</span></td><td><tt class="literal">TRUE</tt> 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><b class="keycap">Space</b></span>, <span><b class="keycap">Shift</b></span>+<span><b class="keycap">Space</b></span>,
<span><b class="keycap">Return</b></span> or <span><b class="keycap">Enter</b></span> is pressed.</p></div><div class="refsect2" lang="en"><a name="signal-gtktreeview--set-scroll-adjustments"></a><h3>The "set-scroll-adjustments" gtk.TreeView Signal</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><i class="parameter"><tt>treeview</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>hadjustment</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>vadjustment</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>user_param1</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>...</tt></i></span></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><i class="parameter"><tt>treeview</tt></i>:</span></td><td>the treeview that received the
signal</td></tr><tr><td><span class="term"><i class="parameter"><tt>hadjustment</tt></i>:</span></td><td>a horizontal <a href="class-gtkadjustment.html" title="gtk.Adjustment"><tt class="classname">gtk.Adjustment</tt></a></td></tr><tr><td><span class="term"><i class="parameter"><tt>vadjustment</tt></i>:</span></td><td>a vertical <a href="class-gtkadjustment.html" title="gtk.Adjustment"><tt class="classname">gtk.Adjustment</tt></a></td></tr><tr><td><span class="term"><i class="parameter"><tt>user_param1</tt></i>:</span></td><td>the first user parameter (if any) specified
with the <a href="class-gobject.html#method-gobject--connect" title="gobject.GObject.connect"><tt class="methodname">connect</tt>()</a>
method</td></tr><tr><td><span class="term"><i class="parameter"><tt>...</tt></i>:</span></td><td>additional user parameters (if
any)</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>:</span></td><td><tt class="literal">TRUE</tt> 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
<i class="parameter"><tt>treeview</tt></i>.</p></div><div class="refsect2" lang="en"><a name="signal-gtktreeview--start-interactive-search"></a><h3>The "start-interactive-search" gtk.TreeView Signal</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><i class="parameter"><tt>treeview</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>user_param1</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>...</tt></i></span></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><i class="parameter"><tt>treeview</tt></i>:</span></td><td>the treeview that received the
signal</td></tr><tr><td><span class="term"><i class="parameter"><tt>user_param1</tt></i>:</span></td><td>the first user parameter (if any) specified
with the <a href="class-gobject.html#method-gobject--connect" title="gobject.GObject.connect"><tt class="methodname">connect</tt>()</a>
method</td></tr><tr><td><span class="term"><i class="parameter"><tt>...</tt></i>:</span></td><td>additional user parameters (if
any)</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>:</span></td><td><tt class="literal">TRUE</tt> if the signal was
handled.</td></tr></tbody></table><p>The "start-interactive-search" signal is emitted when the user
presses <span><b class="keycap">Control</b></span>+<span><b class="keycap">f</b></span>.</p></div><div class="refsect2" lang="en"><a name="signal-gtktreeview--test-collapse-row"></a><h3>The "test-collapse-row" gtk.TreeView Signal</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><i class="parameter"><tt>treeview</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>iter</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>path</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>user_param1</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>...</tt></i></span></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><i class="parameter"><tt>treeview</tt></i>:</span></td><td>the treeview that received the
signal</td></tr><tr><td><span class="term"><i class="parameter"><tt>iter</tt></i>:</span></td><td>the <a href="class-gtktreeiter.html" title="gtk.TreeIter"><tt class="classname">gtk.TreeIter</tt></a>
pointing at the row to test.</td></tr><tr><td><span class="term"><i class="parameter"><tt>path</tt></i>:</span></td><td>the path of the row to be
tested</td></tr><tr><td><span class="term"><i class="parameter"><tt>user_param1</tt></i>:</span></td><td>the first user parameter (if any) specified
with the <a href="class-gobject.html#method-gobject--connect" title="gobject.GObject.connect"><tt class="methodname">connect</tt>()</a>
method</td></tr><tr><td><span class="term"><i class="parameter"><tt>...</tt></i>:</span></td><td>additional user parameters (if
any)</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>:</span></td><td><tt class="literal">TRUE</tt> if the row should be
collapsed.</td></tr></tbody></table><p>The "test-collapse-row" signal is emitted when the row pointed
to by <i class="parameter"><tt>iter</tt></i> and <i class="parameter"><tt>path</tt></i> is to be
collapsed.</p></div><div class="refsect2" lang="en"><a name="signal-gtktreeview--test-expand-row"></a><h3>The "test-expand-row" gtk.TreeView Signal</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><i class="parameter"><tt>treeview</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>iter</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>path</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>user_param1</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>...</tt></i></span></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><i class="parameter"><tt>treeview</tt></i>:</span></td><td>the treeview that received the
signal</td></tr><tr><td><span class="term"><i class="parameter"><tt>iter</tt></i>:</span></td><td>the <a href="class-gtktreeiter.html" title="gtk.TreeIter"><tt class="classname">gtk.TreeIter</tt></a>
pointing at the row to test.</td></tr><tr><td><span class="term"><i class="parameter"><tt>path</tt></i>:</span></td><td>the path of the row to
test</td></tr><tr><td><span class="term"><i class="parameter"><tt>user_param1</tt></i>:</span></td><td>the first user parameter (if any) specified
with the <a href="class-gobject.html#method-gobject--connect" title="gobject.GObject.connect"><tt class="methodname">connect</tt>()</a>
method</td></tr><tr><td><span class="term"><i class="parameter"><tt>...</tt></i>:</span></td><td>additional user parameters (if
any)</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>:</span></td><td><tt class="literal">TRUE</tt> if the row should be
expanded.</td></tr></tbody></table><p>The "test-expand-row" signal is emitted when the row pointed to
by <i class="parameter"><tt>iter</tt></i> and <i class="parameter"><tt>path</tt></i> is to be
expanded.</p></div><div class="refsect2" lang="en"><a name="signal-gtktreeview--toggle-cursor-row"></a><h3>The "toggle-cursor-row" gtk.TreeView Signal</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><i class="parameter"><tt>treeview</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>user_param1</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>...</tt></i></span></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><i class="parameter"><tt>treeview</tt></i>:</span></td><td>the treeview that received the
signal</td></tr><tr><td><span class="term"><i class="parameter"><tt>user_param1</tt></i>:</span></td><td>the first user parameter (if any) specified
with the <a href="class-gobject.html#method-gobject--connect" title="gobject.GObject.connect"><tt class="methodname">connect</tt>()</a>
method</td></tr><tr><td><span class="term"><i class="parameter"><tt>...</tt></i>:</span></td><td>additional user parameters (if
any)</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>:</span></td><td><tt class="literal">TRUE</tt> if the signal was
handled.</td></tr></tbody></table><p>The "toggle-cursor-row" signal is emitted when the user presses
<span><b class="keycap">Control</b></span>+<span><b class="keycap">Space</b></span>.</p></div><div class="refsect2" lang="en"><a name="signal-gtktreeview--unselect-all"></a><h3>The "unselect-all" gtk.TreeView Signal</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><i class="parameter"><tt>treeview</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>user_param1</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>...</tt></i></span></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><i class="parameter"><tt>treeview</tt></i>:</span></td><td>the treeview that received the
signal</td></tr><tr><td><span class="term"><i class="parameter"><tt>user_param1</tt></i>:</span></td><td>the first user parameter (if any) specified
with the <a href="class-gobject.html#method-gobject--connect" title="gobject.GObject.connect"><tt class="methodname">connect</tt>()</a>
method</td></tr><tr><td><span class="term"><i class="parameter"><tt>...</tt></i>:</span></td><td>additional user parameters (if
any)</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>:</span></td><td><tt class="literal">TRUE</tt> if the signal was
handled.</td></tr></tbody></table><p>The "unselect-all" signal is emitted when the user presses
<span><b class="keycap">Shift</b></span>+<span><b class="keycap">Control</b></span>+<span><b class="keycap">a</b></span> or <span><b class="keycap">Shift</b></span>+<span><b class="keycap">Control</b></span>+<span><b class="keycap">/</b></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>
|
