]> Pileus Git - ~andy/gtk/blob - docs/reference/gtk/tmpl/gtktreeview.sgml
7422057efecdf915c4b5cce7b756728a91801555
[~andy/gtk] / docs / reference / gtk / tmpl / gtktreeview.sgml
1 <!-- ##### SECTION Title ##### -->
2 GtkTreeView
3
4 <!-- ##### SECTION Short_Description ##### -->
5 A widget for displaying both trees and lists
6
7 <!-- ##### SECTION Long_Description ##### -->
8 <para>
9 Widget that displays any object that implements the <link
10 linkend="GtkTreeModel">GtkTreeModel</link> interface.
11 </para>
12
13 <para>
14 Please refer to the <link linkend="TreeWidget">tree widget conceptual 
15 overview</link> for an overview of all the objects and data types related 
16 to the tree widget and how they work together.
17 </para>
18
19 <para>
20 Several different coordinate systems are exposed in the GtkTreeView API.
21 These are:
22
23 <inlinegraphic fileref="tree-view-coordinates.png" format="PNG"></inlinegraphic>
24
25   <simplelist>
26     <member>Widget coordinates -- coordinates relative to the widget 
27     (usually <literal>widget-&gt;window</literal>.</member>
28     <member>Bin window coordinates -- coordinates relative to the window 
29     that GtkTreeView renders to.</member>
30     <member>Tree coordinates -- coordinates relative to the entire scrollable 
31     area of GtkTreeView.  These coordinates start at (0, 0) for row 0 of the 
32     tree.</member>
33   </simplelist>
34 </para>
35
36 <para>
37 Several functions are available for converting between the different
38 coordinate systems.  The most common translations are between widget and bin 
39 window coordinates and between bin window and tree coordinates.  For the 
40 former you can use gtk_tree_view_convert_widget_to_bin_window_coords()
41 (and vice versa), for the latter gtk_tree_view_convert_bin_window_to_tree_coords() 
42 (and vice versa).
43 </para>
44
45 <refsect2 id="GtkTreeView-BUILDER-UI">
46 <title>GtkTreeView as GtkBuildable</title>
47 <para>
48 The GtkTreeView implementation of the GtkBuildable interface accepts
49 GtkTreeViewColumn objects as &lt;child&gt; elements in UI definitions.
50 </para>
51 <example>
52 <title>A UI definition fragment with GtkTreeView</title>
53 <programlisting><![CDATA[
54 <object class="GtkTreeView" id="treeview">
55   <property name="model">liststore1</property>
56   <child>
57     <object class="GtkTreeViewColumn" id="test-column">
58       <property name="title">Test</property>
59       <child>
60         <object class="GtkCellRendererText" id="test-renderer"/>
61         <attributes>
62           <attribute name="text">1</attribute>
63         </attributes>
64       </child>
65     </object>
66   </child>
67 </object>
68 ]]></programlisting>
69 </example>
70 </refsect2>
71
72 <!-- ##### SECTION See_Also ##### -->
73 <para>
74 #GtkTreeViewColumn, #GtkTreeSelection, #GtkTreeDnd, #GtkTreeMode, #GtkTreeSortable, #GtkTreeModelSort, #GtkListStore, #GtkTreeStore, #GtkCellRenderer, #GtkCellEditable, #GtkCellRendererPixbuf, #GtkCellRendererText, #GtkCellRendererToggle
75 </para>
76
77 <!-- ##### SECTION Stability_Level ##### -->
78
79
80 <!-- ##### STRUCT GtkTreeView ##### -->
81 <para>
82
83 </para>
84
85
86 <!-- ##### SIGNAL GtkTreeView::columns-changed ##### -->
87 <para>
88
89 </para>
90
91 @tree_view: the object which received the signal.
92
93 <!-- ##### SIGNAL GtkTreeView::cursor-changed ##### -->
94 <para>
95
96 </para>
97
98 @tree_view: the object which received the signal.
99
100 <!-- ##### SIGNAL GtkTreeView::expand-collapse-cursor-row ##### -->
101 <para>
102
103 </para>
104
105 @tree_view: the object which received the signal.
106 @arg1: 
107 @arg2: 
108 @arg3: 
109 @Returns: 
110
111 <!-- ##### SIGNAL GtkTreeView::move-cursor ##### -->
112 <para>
113
114 </para>
115
116 @tree_view: the object which received the signal.
117 @arg1: 
118 @arg2: 
119 @Returns: 
120
121 <!-- ##### SIGNAL GtkTreeView::row-activated ##### -->
122 <para>
123
124 </para>
125
126 @tree_view: the object which received the signal.
127 @arg1: 
128 @arg2: 
129
130 <!-- ##### SIGNAL GtkTreeView::row-collapsed ##### -->
131 <para>
132
133 </para>
134
135 @tree_view: the object which received the signal.
136 @arg1: 
137 @arg2: 
138
139 <!-- ##### SIGNAL GtkTreeView::row-expanded ##### -->
140 <para>
141
142 </para>
143
144 @tree_view: the object which received the signal.
145 @arg1: 
146 @arg2: 
147
148 <!-- ##### SIGNAL GtkTreeView::select-all ##### -->
149 <para>
150
151 </para>
152
153 @tree_view: the object which received the signal.
154 @Returns: 
155
156 <!-- ##### SIGNAL GtkTreeView::select-cursor-parent ##### -->
157 <para>
158
159 </para>
160
161 @tree_view: the object which received the signal.
162 @Returns: 
163
164 <!-- ##### SIGNAL GtkTreeView::select-cursor-row ##### -->
165 <para>
166
167 </para>
168
169 @tree_view: the object which received the signal.
170 @arg1: 
171 @Returns: 
172
173 <!-- ##### SIGNAL GtkTreeView::set-scroll-adjustments ##### -->
174 <para>
175
176 </para>
177
178 @tree_view: the object which received the signal.
179 @arg1: 
180 @arg2: 
181
182 <!-- ##### SIGNAL GtkTreeView::start-interactive-search ##### -->
183 <para>
184
185 </para>
186
187 @tree_view: the object which received the signal.
188 @Returns: 
189
190 <!-- ##### SIGNAL GtkTreeView::test-collapse-row ##### -->
191 <para>
192
193 </para>
194
195 @tree_view: the object which received the signal.
196 @arg1: 
197 @arg2: 
198 @Returns: 
199
200 <!-- ##### SIGNAL GtkTreeView::test-expand-row ##### -->
201 <para>
202
203 </para>
204
205 @tree_view: the object which received the signal.
206 @arg1: 
207 @arg2: 
208 @Returns: 
209
210 <!-- ##### SIGNAL GtkTreeView::toggle-cursor-row ##### -->
211 <para>
212
213 </para>
214
215 @tree_view: the object which received the signal.
216 @Returns: 
217
218 <!-- ##### SIGNAL GtkTreeView::unselect-all ##### -->
219 <para>
220
221 </para>
222
223 @tree_view: the object which received the signal.
224 @Returns: 
225
226 <!-- ##### ARG GtkTreeView:enable-grid-lines ##### -->
227 <para>
228
229 </para>
230
231 <!-- ##### ARG GtkTreeView:enable-search ##### -->
232 <para>
233
234 </para>
235
236 <!-- ##### ARG GtkTreeView:enable-tree-lines ##### -->
237 <para>
238
239 </para>
240
241 <!-- ##### ARG GtkTreeView:expander-column ##### -->
242 <para>
243
244 </para>
245
246 <!-- ##### ARG GtkTreeView:fixed-height-mode ##### -->
247 <para>
248
249 </para>
250
251 <!-- ##### ARG GtkTreeView:hadjustment ##### -->
252 <para>
253
254 </para>
255
256 <!-- ##### ARG GtkTreeView:headers-clickable ##### -->
257 <para>
258
259 </para>
260
261 <!-- ##### ARG GtkTreeView:headers-visible ##### -->
262 <para>
263
264 </para>
265
266 <!-- ##### ARG GtkTreeView:hover-expand ##### -->
267 <para>
268
269 </para>
270
271 <!-- ##### ARG GtkTreeView:hover-selection ##### -->
272 <para>
273
274 </para>
275
276 <!-- ##### ARG GtkTreeView:level-indentation ##### -->
277 <para>
278
279 </para>
280
281 <!-- ##### ARG GtkTreeView:model ##### -->
282 <para>
283
284 </para>
285
286 <!-- ##### ARG GtkTreeView:reorderable ##### -->
287 <para>
288
289 </para>
290
291 <!-- ##### ARG GtkTreeView:rubber-banding ##### -->
292 <para>
293
294 </para>
295
296 <!-- ##### ARG GtkTreeView:rules-hint ##### -->
297 <para>
298
299 </para>
300
301 <!-- ##### ARG GtkTreeView:search-column ##### -->
302 <para>
303
304 </para>
305
306 <!-- ##### ARG GtkTreeView:show-expanders ##### -->
307 <para>
308
309 </para>
310
311 <!-- ##### ARG GtkTreeView:tooltip-column ##### -->
312 <para>
313
314 </para>
315
316 <!-- ##### ARG GtkTreeView:vadjustment ##### -->
317 <para>
318
319 </para>
320
321 <!-- ##### ARG GtkTreeView:allow-rules ##### -->
322 <para>
323
324 </para>
325
326 <!-- ##### ARG GtkTreeView:even-row-color ##### -->
327 <para>
328
329 </para>
330
331 <!-- ##### ARG GtkTreeView:expander-size ##### -->
332 <para>
333
334 </para>
335
336 <!-- ##### ARG GtkTreeView:grid-line-pattern ##### -->
337 <para>
338
339 </para>
340
341 <!-- ##### ARG GtkTreeView:grid-line-width ##### -->
342 <para>
343
344 </para>
345
346 <!-- ##### ARG GtkTreeView:horizontal-separator ##### -->
347 <para>
348
349 </para>
350
351 <!-- ##### ARG GtkTreeView:indent-expanders ##### -->
352 <para>
353
354 </para>
355
356 <!-- ##### ARG GtkTreeView:odd-row-color ##### -->
357 <para>
358
359 </para>
360
361 <!-- ##### ARG GtkTreeView:row-ending-details ##### -->
362 <para>
363
364 </para>
365
366 <!-- ##### ARG GtkTreeView:tree-line-pattern ##### -->
367 <para>
368
369 </para>
370
371 <!-- ##### ARG GtkTreeView:tree-line-width ##### -->
372 <para>
373
374 </para>
375
376 <!-- ##### ARG GtkTreeView:vertical-separator ##### -->
377 <para>
378
379 </para>
380
381 <!-- ##### ENUM GtkTreeViewDropPosition ##### -->
382 <para>
383 An enum for determining where a dropped row goes.
384 </para>
385
386 @GTK_TREE_VIEW_DROP_BEFORE: dropped row is inserted before
387 @GTK_TREE_VIEW_DROP_AFTER: dropped row is inserted after
388 @GTK_TREE_VIEW_DROP_INTO_OR_BEFORE: dropped row becomes a child or is inserted before
389 @GTK_TREE_VIEW_DROP_INTO_OR_AFTER: dropped row becomes a child or is inserted after
390
391 <!-- ##### STRUCT GtkTreeViewPrivate ##### -->
392 <para>
393 A private struct for internal use only.  The definition of this
394 structure is not publically available.
395 </para>
396
397
398 <!-- ##### USER_FUNCTION GtkTreeViewColumnDropFunc ##### -->
399 <para>
400 Function type for determining whether @column can be dropped in a
401 particular spot (as determined by @prev_column and @next_column).  In
402 left to right locales, @prev_column is on the left of the potential drop
403 spot, and @next_column is on the right.  In right to left mode, this is
404 reversed.  This function should return %TRUE if the spot is a valid drop
405 spot.  Please note that returning %TRUE does not actually indicate that
406 the column drop was made, but is meant only to indicate a possible drop
407 spot to the user.
408 </para>
409
410 @tree_view: A #GtkTreeView
411 @column: The #GtkTreeViewColumn being dragged
412 @prev_column: A #GtkTreeViewColumn on one side of @column
413 @next_column: A #GtkTreeViewColumn on the other side of @column
414 @data: user data
415 @Returns: %TRUE, if #column can be dropped in this spot
416
417
418 <!-- ##### USER_FUNCTION GtkTreeViewMappingFunc ##### -->
419 <para>
420 Function used for #gtk_tree_view_map_expanded_rows.
421 </para>
422
423 @tree_view: A #GtkTreeView
424 @path: The path that's expanded
425 @user_data: user data
426
427
428 <!-- ##### USER_FUNCTION GtkTreeViewSearchEqualFunc ##### -->
429 <para>
430 A function used for checking whether a row in @model matches
431 a search key string entered by the user. Note the return value
432 is reversed from what you would normally expect, though it
433 has some similarity to strcmp() returning 0 for equal strings.
434 </para>
435
436 @model: the #GtkTreeModel being searched
437 @column: the search column set by gtk_tree_view_set_search_column()
438 @key: the key string to compare with
439 @iter: a #GtkTreeIter pointing the row of @model that should be compared
440   with @key.
441 @search_data: user data from gtk_tree_view_set_search_equal_func()
442 @Returns: %FALSE if the row matches, %TRUE otherwise.
443
444
445 <!-- ##### FUNCTION gtk_tree_view_new ##### -->
446 <para>
447
448 </para>
449
450 @Returns: 
451
452
453 <!-- ##### FUNCTION gtk_tree_view_get_level_indentation ##### -->
454 <para>
455
456 </para>
457
458 @tree_view: 
459 @Returns: 
460
461
462 <!-- ##### FUNCTION gtk_tree_view_get_show_expanders ##### -->
463 <para>
464
465 </para>
466
467 @tree_view: 
468 @Returns: 
469
470
471 <!-- ##### FUNCTION gtk_tree_view_set_level_indentation ##### -->
472 <para>
473
474 </para>
475
476 @tree_view: 
477 @indentation: 
478
479
480 <!-- ##### FUNCTION gtk_tree_view_set_show_expanders ##### -->
481 <para>
482
483 </para>
484
485 @tree_view: 
486 @enabled: 
487
488
489 <!-- ##### FUNCTION gtk_tree_view_new_with_model ##### -->
490 <para>
491
492 </para>
493
494 @model: 
495 @Returns: 
496
497
498 <!-- ##### FUNCTION gtk_tree_view_get_model ##### -->
499 <para>
500
501 </para>
502
503 @tree_view: 
504 @Returns: 
505
506
507 <!-- ##### FUNCTION gtk_tree_view_set_model ##### -->
508 <para>
509
510 </para>
511
512 @tree_view: 
513 @model: 
514
515
516 <!-- ##### FUNCTION gtk_tree_view_get_selection ##### -->
517 <para>
518
519 </para>
520
521 @tree_view: 
522 @Returns: 
523
524
525 <!-- ##### FUNCTION gtk_tree_view_get_hadjustment ##### -->
526 <para>
527
528 </para>
529
530 @tree_view: 
531 @Returns: 
532
533
534 <!-- ##### FUNCTION gtk_tree_view_set_hadjustment ##### -->
535 <para>
536
537 </para>
538
539 @tree_view: 
540 @adjustment: 
541
542
543 <!-- ##### FUNCTION gtk_tree_view_get_vadjustment ##### -->
544 <para>
545
546 </para>
547
548 @tree_view: 
549 @Returns: 
550
551
552 <!-- ##### FUNCTION gtk_tree_view_set_vadjustment ##### -->
553 <para>
554
555 </para>
556
557 @tree_view: 
558 @adjustment: 
559
560
561 <!-- ##### FUNCTION gtk_tree_view_get_headers_visible ##### -->
562 <para>
563
564 </para>
565
566 @tree_view: 
567 @Returns: 
568
569
570 <!-- ##### FUNCTION gtk_tree_view_set_headers_visible ##### -->
571 <para>
572
573 </para>
574
575 @tree_view: 
576 @headers_visible: 
577
578
579 <!-- ##### FUNCTION gtk_tree_view_columns_autosize ##### -->
580 <para>
581
582 </para>
583
584 @tree_view: 
585
586
587 <!-- ##### FUNCTION gtk_tree_view_get_headers_clickable ##### -->
588 <para>
589
590 </para>
591
592 @tree_view: 
593 @Returns: 
594
595
596 <!-- ##### FUNCTION gtk_tree_view_set_headers_clickable ##### -->
597 <para>
598
599 </para>
600
601 @tree_view: 
602 @setting: 
603
604
605 <!-- ##### FUNCTION gtk_tree_view_set_rules_hint ##### -->
606 <para>
607
608 </para>
609
610 @tree_view: 
611 @setting: 
612
613
614 <!-- ##### FUNCTION gtk_tree_view_get_rules_hint ##### -->
615 <para>
616
617 </para>
618
619 @tree_view: 
620 @Returns: 
621
622
623 <!-- ##### FUNCTION gtk_tree_view_append_column ##### -->
624 <para>
625
626 </para>
627
628 @tree_view: 
629 @column: 
630 @Returns: 
631
632
633 <!-- ##### FUNCTION gtk_tree_view_remove_column ##### -->
634 <para>
635
636 </para>
637
638 @tree_view: 
639 @column: 
640 @Returns: 
641
642
643 <!-- ##### FUNCTION gtk_tree_view_insert_column ##### -->
644 <para>
645
646 </para>
647
648 @tree_view: 
649 @column: 
650 @position: 
651 @Returns: 
652
653
654 <!-- ##### FUNCTION gtk_tree_view_insert_column_with_attributes ##### -->
655 <para>
656
657 </para>
658
659 @tree_view: 
660 @position: 
661 @title: 
662 @cell: 
663 @Varargs: 
664 @Returns: 
665
666
667 <!-- ##### FUNCTION gtk_tree_view_insert_column_with_data_func ##### -->
668 <para>
669
670 </para>
671
672 @tree_view: 
673 @position: 
674 @title: 
675 @cell: 
676 @func: 
677 @data: 
678 @dnotify: 
679 @Returns: 
680
681
682 <!-- ##### FUNCTION gtk_tree_view_get_column ##### -->
683 <para>
684
685 </para>
686
687 @tree_view: 
688 @n: 
689 @Returns: 
690
691
692 <!-- ##### FUNCTION gtk_tree_view_get_columns ##### -->
693 <para>
694
695 </para>
696
697 @tree_view: 
698 @Returns: 
699
700
701 <!-- ##### FUNCTION gtk_tree_view_move_column_after ##### -->
702 <para>
703
704 </para>
705
706 @tree_view: 
707 @column: 
708 @base_column: 
709
710
711 <!-- ##### FUNCTION gtk_tree_view_set_expander_column ##### -->
712 <para>
713
714 </para>
715
716 @tree_view: 
717 @column: 
718
719
720 <!-- ##### FUNCTION gtk_tree_view_get_expander_column ##### -->
721 <para>
722
723 </para>
724
725 @tree_view: 
726 @Returns: 
727
728
729 <!-- ##### FUNCTION gtk_tree_view_set_column_drag_function ##### -->
730 <para>
731
732 </para>
733
734 @tree_view: 
735 @func: 
736 @user_data: 
737 @destroy: 
738
739
740 <!-- ##### FUNCTION gtk_tree_view_scroll_to_point ##### -->
741 <para>
742
743 </para>
744
745 @tree_view: 
746 @tree_x: 
747 @tree_y: 
748
749
750 <!-- ##### FUNCTION gtk_tree_view_scroll_to_cell ##### -->
751 <para>
752
753 </para>
754
755 @tree_view: 
756 @path: 
757 @column: 
758 @use_align: 
759 @row_align: 
760 @col_align: 
761
762
763 <!-- ##### FUNCTION gtk_tree_view_set_cursor ##### -->
764 <para>
765
766 </para>
767
768 @tree_view: 
769 @path: 
770 @focus_column: 
771 @start_editing: 
772
773
774 <!-- ##### FUNCTION gtk_tree_view_set_cursor_on_cell ##### -->
775 <para>
776
777 </para>
778
779 @tree_view: 
780 @path: 
781 @focus_column: 
782 @focus_cell: 
783 @start_editing: 
784
785
786 <!-- ##### FUNCTION gtk_tree_view_get_cursor ##### -->
787 <para>
788
789 </para>
790
791 @tree_view: 
792 @path: 
793 @focus_column: 
794
795
796 <!-- ##### FUNCTION gtk_tree_view_row_activated ##### -->
797 <para>
798
799 </para>
800
801 @tree_view: 
802 @path: 
803 @column: 
804
805
806 <!-- ##### FUNCTION gtk_tree_view_expand_all ##### -->
807 <para>
808
809 </para>
810
811 @tree_view: 
812
813
814 <!-- ##### FUNCTION gtk_tree_view_collapse_all ##### -->
815 <para>
816
817 </para>
818
819 @tree_view: 
820
821
822 <!-- ##### FUNCTION gtk_tree_view_expand_to_path ##### -->
823 <para>
824
825 </para>
826
827 @tree_view: 
828 @path: 
829
830
831 <!-- ##### FUNCTION gtk_tree_view_expand_row ##### -->
832 <para>
833
834 </para>
835
836 @tree_view: 
837 @path: 
838 @open_all: 
839 @Returns: 
840
841
842 <!-- ##### FUNCTION gtk_tree_view_collapse_row ##### -->
843 <para>
844
845 </para>
846
847 @tree_view: 
848 @path: 
849 @Returns: 
850
851
852 <!-- ##### FUNCTION gtk_tree_view_map_expanded_rows ##### -->
853 <para>
854
855 </para>
856
857 @tree_view: 
858 @func: 
859 @data: 
860
861
862 <!-- ##### FUNCTION gtk_tree_view_row_expanded ##### -->
863 <para>
864
865 </para>
866
867 @tree_view: 
868 @path: 
869 @Returns: 
870
871
872 <!-- ##### FUNCTION gtk_tree_view_set_reorderable ##### -->
873 <para>
874
875 </para>
876
877 @tree_view: 
878 @reorderable: 
879
880
881 <!-- ##### FUNCTION gtk_tree_view_get_reorderable ##### -->
882 <para>
883
884 </para>
885
886 @tree_view: 
887 @Returns: 
888
889
890 <!-- ##### FUNCTION gtk_tree_view_get_path_at_pos ##### -->
891 <para>
892
893 </para>
894
895 @tree_view: 
896 @x: 
897 @y: 
898 @path: 
899 @column: 
900 @cell_x: 
901 @cell_y: 
902 @Returns: 
903
904
905 <!-- ##### FUNCTION gtk_tree_view_get_cell_area ##### -->
906 <para>
907
908 </para>
909
910 @tree_view: 
911 @path: 
912 @column: 
913 @rect: 
914
915
916 <!-- ##### FUNCTION gtk_tree_view_get_background_area ##### -->
917 <para>
918
919 </para>
920
921 @tree_view: 
922 @path: 
923 @column: 
924 @rect: 
925
926
927 <!-- ##### FUNCTION gtk_tree_view_get_visible_rect ##### -->
928 <para>
929
930 </para>
931
932 @tree_view: 
933 @visible_rect: 
934
935
936 <!-- ##### FUNCTION gtk_tree_view_get_visible_range ##### -->
937 <para>
938
939 </para>
940
941 @tree_view: 
942 @start_path: 
943 @end_path: 
944 @Returns: 
945
946
947 <!-- ##### FUNCTION gtk_tree_view_get_bin_window ##### -->
948 <para>
949
950 </para>
951
952 @tree_view: 
953 @Returns: 
954
955
956 <!-- ##### FUNCTION gtk_tree_view_widget_to_tree_coords ##### -->
957 <para>
958
959 </para>
960
961 @tree_view: 
962 @wx: 
963 @wy: 
964 @tx: 
965 @ty: 
966
967
968 <!-- ##### FUNCTION gtk_tree_view_tree_to_widget_coords ##### -->
969 <para>
970
971 </para>
972
973 @tree_view: 
974 @tx: 
975 @ty: 
976 @wx: 
977 @wy: 
978
979
980 <!-- ##### FUNCTION gtk_tree_view_convert_bin_window_to_tree_coords ##### -->
981 <para>
982
983 </para>
984
985 @tree_view: 
986 @bx: 
987 @by: 
988 @tx: 
989 @ty: 
990
991
992 <!-- ##### FUNCTION gtk_tree_view_convert_bin_window_to_widget_coords ##### -->
993 <para>
994
995 </para>
996
997 @tree_view: 
998 @bx: 
999 @by: 
1000 @wx: 
1001 @wy: 
1002
1003
1004 <!-- ##### FUNCTION gtk_tree_view_convert_tree_to_bin_window_coords ##### -->
1005 <para>
1006
1007 </para>
1008
1009 @tree_view: 
1010 @tx: 
1011 @ty: 
1012 @bx: 
1013 @by: 
1014
1015
1016 <!-- ##### FUNCTION gtk_tree_view_convert_tree_to_widget_coords ##### -->
1017 <para>
1018
1019 </para>
1020
1021 @tree_view: 
1022 @tx: 
1023 @ty: 
1024 @wx: 
1025 @wy: 
1026
1027
1028 <!-- ##### FUNCTION gtk_tree_view_convert_widget_to_bin_window_coords ##### -->
1029 <para>
1030
1031 </para>
1032
1033 @tree_view: 
1034 @wx: 
1035 @wy: 
1036 @bx: 
1037 @by: 
1038
1039
1040 <!-- ##### FUNCTION gtk_tree_view_convert_widget_to_tree_coords ##### -->
1041 <para>
1042
1043 </para>
1044
1045 @tree_view: 
1046 @wx: 
1047 @wy: 
1048 @tx: 
1049 @ty: 
1050
1051
1052 <!-- ##### FUNCTION gtk_tree_view_enable_model_drag_dest ##### -->
1053 <para>
1054
1055 </para>
1056
1057 @tree_view: 
1058 @targets: 
1059 @n_targets: 
1060 @actions: 
1061
1062
1063 <!-- ##### FUNCTION gtk_tree_view_enable_model_drag_source ##### -->
1064 <para>
1065
1066 </para>
1067
1068 @tree_view: 
1069 @start_button_mask: 
1070 @targets: 
1071 @n_targets: 
1072 @actions: 
1073
1074
1075 <!-- ##### FUNCTION gtk_tree_view_unset_rows_drag_source ##### -->
1076 <para>
1077
1078 </para>
1079
1080 @tree_view: 
1081
1082
1083 <!-- ##### FUNCTION gtk_tree_view_unset_rows_drag_dest ##### -->
1084 <para>
1085
1086 </para>
1087
1088 @tree_view: 
1089
1090
1091 <!-- ##### FUNCTION gtk_tree_view_set_drag_dest_row ##### -->
1092 <para>
1093
1094 </para>
1095
1096 @tree_view: 
1097 @path: 
1098 @pos: 
1099
1100
1101 <!-- ##### FUNCTION gtk_tree_view_get_drag_dest_row ##### -->
1102 <para>
1103
1104 </para>
1105
1106 @tree_view: 
1107 @path: 
1108 @pos: 
1109
1110
1111 <!-- ##### FUNCTION gtk_tree_view_get_dest_row_at_pos ##### -->
1112 <para>
1113
1114 </para>
1115
1116 @tree_view: 
1117 @drag_x: 
1118 @drag_y: 
1119 @path: 
1120 @pos: 
1121 @Returns: 
1122
1123
1124 <!-- ##### FUNCTION gtk_tree_view_create_row_drag_icon ##### -->
1125 <para>
1126
1127 </para>
1128
1129 @tree_view: 
1130 @path: 
1131 @Returns: 
1132
1133
1134 <!-- ##### FUNCTION gtk_tree_view_set_enable_search ##### -->
1135 <para>
1136
1137 </para>
1138
1139 @tree_view: 
1140 @enable_search: 
1141
1142
1143 <!-- ##### FUNCTION gtk_tree_view_get_enable_search ##### -->
1144 <para>
1145
1146 </para>
1147
1148 @tree_view: 
1149 @Returns: 
1150
1151
1152 <!-- ##### FUNCTION gtk_tree_view_get_search_column ##### -->
1153 <para>
1154
1155 </para>
1156
1157 @tree_view: 
1158 @Returns: 
1159
1160
1161 <!-- ##### FUNCTION gtk_tree_view_set_search_column ##### -->
1162 <para>
1163
1164 </para>
1165
1166 @tree_view: 
1167 @column: 
1168
1169
1170 <!-- ##### FUNCTION gtk_tree_view_get_search_equal_func ##### -->
1171 <para>
1172
1173 </para>
1174
1175 @tree_view: 
1176 @Returns: 
1177
1178
1179 <!-- ##### FUNCTION gtk_tree_view_set_search_equal_func ##### -->
1180 <para>
1181
1182 </para>
1183
1184 @tree_view: 
1185 @search_equal_func: 
1186 @search_user_data: 
1187 @search_destroy: 
1188
1189
1190 <!-- ##### FUNCTION gtk_tree_view_get_search_entry ##### -->
1191 <para>
1192
1193 </para>
1194
1195 @tree_view: 
1196 @Returns: 
1197
1198
1199 <!-- ##### FUNCTION gtk_tree_view_set_search_entry ##### -->
1200 <para>
1201
1202 </para>
1203
1204 @tree_view: 
1205 @entry: 
1206
1207
1208 <!-- ##### USER_FUNCTION GtkTreeViewSearchPositionFunc ##### -->
1209 <para>
1210
1211 </para>
1212
1213 @tree_view: 
1214 @search_dialog: 
1215 @user_data: 
1216
1217
1218 <!-- ##### FUNCTION gtk_tree_view_get_search_position_func ##### -->
1219 <para>
1220
1221 </para>
1222
1223 @tree_view: 
1224 @Returns: 
1225
1226
1227 <!-- ##### FUNCTION gtk_tree_view_set_search_position_func ##### -->
1228 <para>
1229
1230 </para>
1231
1232 @tree_view: 
1233 @func: 
1234 @data: 
1235 @destroy: 
1236
1237
1238 <!-- ##### FUNCTION gtk_tree_view_get_fixed_height_mode ##### -->
1239 <para>
1240
1241 </para>
1242
1243 @tree_view: 
1244 @Returns: 
1245
1246
1247 <!-- ##### FUNCTION gtk_tree_view_set_fixed_height_mode ##### -->
1248 <para>
1249
1250 </para>
1251
1252 @tree_view: 
1253 @enable: 
1254
1255
1256 <!-- ##### FUNCTION gtk_tree_view_get_hover_selection ##### -->
1257 <para>
1258
1259 </para>
1260
1261 @tree_view: 
1262 @Returns: 
1263
1264
1265 <!-- ##### FUNCTION gtk_tree_view_set_hover_selection ##### -->
1266 <para>
1267
1268 </para>
1269
1270 @tree_view: 
1271 @hover: 
1272
1273
1274 <!-- ##### FUNCTION gtk_tree_view_get_hover_expand ##### -->
1275 <para>
1276
1277 </para>
1278
1279 @tree_view: 
1280 @Returns: 
1281
1282
1283 <!-- ##### FUNCTION gtk_tree_view_set_hover_expand ##### -->
1284 <para>
1285
1286 </para>
1287
1288 @tree_view: 
1289 @expand: 
1290
1291
1292 <!-- ##### USER_FUNCTION GtkTreeDestroyCountFunc ##### -->
1293 <para>
1294
1295 </para>
1296
1297 @tree_view: 
1298 @path: 
1299 @children: 
1300 @user_data: 
1301
1302
1303 <!-- ##### FUNCTION gtk_tree_view_set_destroy_count_func ##### -->
1304 <para>
1305
1306 </para>
1307
1308 @tree_view: 
1309 @func: 
1310 @data: 
1311 @destroy: 
1312
1313
1314 <!-- ##### USER_FUNCTION GtkTreeViewRowSeparatorFunc ##### -->
1315 <para>
1316 Function type for determining whether the row pointed to by @iter should
1317 be rendered as a separator. A common way to implement this is to have a
1318 boolean column in the model, whose values the #GtkTreeViewRowSeparatorFunc
1319 returns.
1320 </para>
1321
1322 @model: the #GtkTreeModel
1323 @iter: a #GtkTreeIter pointing at a row in @model
1324 @data: user data
1325 @Returns: %TRUE if the row is a separator
1326
1327
1328 <!-- ##### FUNCTION gtk_tree_view_get_row_separator_func ##### -->
1329 <para>
1330
1331 </para>
1332
1333 @tree_view: 
1334 @Returns: 
1335
1336
1337 <!-- ##### FUNCTION gtk_tree_view_set_row_separator_func ##### -->
1338 <para>
1339
1340 </para>
1341
1342 @tree_view: 
1343 @func: 
1344 @data: 
1345 @destroy: 
1346
1347
1348 <!-- ##### FUNCTION gtk_tree_view_get_rubber_banding ##### -->
1349 <para>
1350
1351 </para>
1352
1353 @tree_view: 
1354 @Returns: 
1355
1356
1357 <!-- ##### FUNCTION gtk_tree_view_set_rubber_banding ##### -->
1358 <para>
1359
1360 </para>
1361
1362 @tree_view: 
1363 @enable: 
1364
1365
1366 <!-- ##### FUNCTION gtk_tree_view_is_rubber_banding_active ##### -->
1367 <para>
1368
1369 </para>
1370
1371 @tree_view: 
1372 @Returns: 
1373
1374
1375 <!-- ##### FUNCTION gtk_tree_view_get_enable_tree_lines ##### -->
1376 <para>
1377
1378 </para>
1379
1380 @tree_view: 
1381 @Returns: 
1382
1383
1384 <!-- ##### FUNCTION gtk_tree_view_set_enable_tree_lines ##### -->
1385 <para>
1386
1387 </para>
1388
1389 @tree_view: 
1390 @enabled: 
1391
1392
1393 <!-- ##### ENUM GtkTreeViewGridLines ##### -->
1394 <para>
1395 Used to indicate which grid lines to draw in a tree view.
1396 </para>
1397
1398 @GTK_TREE_VIEW_GRID_LINES_NONE: No grid lines.
1399 @GTK_TREE_VIEW_GRID_LINES_HORIZONTAL: Horizontal grid lines.
1400 @GTK_TREE_VIEW_GRID_LINES_VERTICAL: Vertical grid lines.
1401 @GTK_TREE_VIEW_GRID_LINES_BOTH: Horizontal and vertical grid lines.
1402
1403 <!-- ##### FUNCTION gtk_tree_view_get_grid_lines ##### -->
1404 <para>
1405
1406 </para>
1407
1408 @tree_view: 
1409 @Returns: 
1410
1411
1412 <!-- ##### FUNCTION gtk_tree_view_set_grid_lines ##### -->
1413 <para>
1414
1415 </para>
1416
1417 @tree_view: 
1418 @grid_lines: 
1419
1420
1421 <!-- ##### FUNCTION gtk_tree_view_set_tooltip_row ##### -->
1422 <para>
1423
1424 </para>
1425
1426 @tree_view: 
1427 @tooltip: 
1428 @path: 
1429
1430
1431 <!-- ##### FUNCTION gtk_tree_view_set_tooltip_cell ##### -->
1432 <para>
1433
1434 </para>
1435
1436 @tree_view: 
1437 @tooltip: 
1438 @path: 
1439 @column: 
1440 @cell: 
1441
1442
1443 <!-- ##### FUNCTION gtk_tree_view_get_tooltip_context ##### -->
1444 <para>
1445
1446 </para>
1447
1448 @tree_view: 
1449 @x: 
1450 @y: 
1451 @keyboard_tip: 
1452 @model: 
1453 @path: 
1454 @iter: 
1455 @Returns: 
1456
1457
1458 <!-- ##### FUNCTION gtk_tree_view_get_tooltip_column ##### -->
1459 <para>
1460
1461 </para>
1462
1463 @tree_view: 
1464 @Returns: 
1465
1466
1467 <!-- ##### FUNCTION gtk_tree_view_set_tooltip_column ##### -->
1468 <para>
1469
1470 </para>
1471
1472 @tree_view: 
1473 @column: 
1474
1475