.\" -*- mode: troff; coding: utf-8 -*- .\" Automatically generated by Pod::Man 5.01 (Pod::Simple 3.43) .\" .\" Standard preamble: .\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>. .ie n \{\ . ds C` "" . ds C' "" 'br\} .el\{\ . ds C` . ds C' 'br\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" If the F register is >0, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .\" .\" Avoid warning from groff about undefined register 'F'. .de IX .. .nr rF 0 .if \n(.g .if rF .nr rF 1 .if (\n(rF:(\n(.g==0)) \{\ . if \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . if !\nF==2 \{\ . nr % 0 . nr F 2 . \} . \} .\} .rr rF .\" ======================================================================== .\" .IX Title "Gtk2::TreeViewColumn 3" .TH Gtk2::TreeViewColumn 3 2023-07-25 "perl v5.38.0" "User Contributed Perl Documentation" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .SH NAME Gtk2::TreeViewColumn \- wrapper for GtkTreeViewColumn .SH HIERARCHY .IX Header "HIERARCHY" .Vb 4 \& Glib::Object \& +\-\-\-\-Glib::InitiallyUnowned \& +\-\-\-\-Gtk2::Object \& +\-\-\-\-Gtk2::TreeViewColumn .Ve .SH INTERFACES .IX Header "INTERFACES" .Vb 2 \& Gtk2::CellLayout \& Gtk2::Buildable .Ve .SH METHODS .IX Header "METHODS" .SS "treeviewcolumn = Gtk2::TreeViewColumn\->\fBnew\fP" .IX Subsection "treeviewcolumn = Gtk2::TreeViewColumn->new" .ie n .SS "treeviewcolumn = Gtk2::TreeViewColumn\->\fBnew_with_attributes\fP ($title, $cell, $attr1, $col1, ...)" .el .SS "treeviewcolumn = Gtk2::TreeViewColumn\->\fBnew_with_attributes\fP ($title, \f(CW$cell\fP, \f(CW$attr1\fP, \f(CW$col1\fP, ...)" .IX Subsection "treeviewcolumn = Gtk2::TreeViewColumn->new_with_attributes ($title, $cell, $attr1, $col1, ...)" .IP \(bu 4 \&\f(CW$title\fR (string) .IP \(bu 4 \&\f(CW$cell\fR (Gtk2::CellRenderer) .IP \(bu 4 \&... (list) pairs of attributes and columns .IP \(bu 4 \&\f(CW$col1\fR (integer) the first column .IP \(bu 4 \&\f(CW$attr1\fR (string) the first attribute .ie n .SS "$tree_column\->\fBadd_attribute\fP ($cell_renderer, $attribute, $column)" .el .SS "\f(CW$tree_column\fP\->\fBadd_attribute\fP ($cell_renderer, \f(CW$attribute\fP, \f(CW$column\fP)" .IX Subsection "$tree_column->add_attribute ($cell_renderer, $attribute, $column)" .IP \(bu 4 \&\f(CW$cell_renderer\fR (Gtk2::CellRenderer) .IP \(bu 4 \&\f(CW$attribute\fR (string) .IP \(bu 4 \&\f(CW$column\fR (integer) .ie n .SS "double = $tree_column\->\fBget_alignment\fP" .el .SS "double = \f(CW$tree_column\fP\->\fBget_alignment\fP" .IX Subsection "double = $tree_column->get_alignment" .ie n .SS "$tree_column\->\fBset_alignment\fP ($xalign)" .el .SS "\f(CW$tree_column\fP\->\fBset_alignment\fP ($xalign)" .IX Subsection "$tree_column->set_alignment ($xalign)" .IP \(bu 4 \&\f(CW$xalign\fR (double) .ie n .SS "$tree_column\->\fBset_attributes\fP ($cell_renderer, ..., $col1, $attr1)" .el .SS "\f(CW$tree_column\fP\->\fBset_attributes\fP ($cell_renderer, ..., \f(CW$col1\fP, \f(CW$attr1\fP)" .IX Subsection "$tree_column->set_attributes ($cell_renderer, ..., $col1, $attr1)" .IP \(bu 4 \&\f(CW$cell_renderer\fR (Gtk2::CellRenderer) .IP \(bu 4 \&... (list) pairs of attributes and columns .IP \(bu 4 \&\f(CW$col1\fR (integer) the first column .IP \(bu 4 \&\f(CW$attr1\fR (string) the first attribute .ie n .SS "$tree_column\->\fBset_cell_data_func\fP ($cell_renderer, $func, $data=undef)" .el .SS "\f(CW$tree_column\fP\->\fBset_cell_data_func\fP ($cell_renderer, \f(CW$func\fP, \f(CW$data\fP=undef)" .IX Subsection "$tree_column->set_cell_data_func ($cell_renderer, $func, $data=undef)" .IP \(bu 4 \&\f(CW$cell_renderer\fR (Gtk2::CellRenderer) .IP \(bu 4 \&\f(CW$func\fR (subroutine) .IP \(bu 4 \&\f(CW$data\fR (scalar) .PP Install \fR\f(CI$func\fR\fI\fR as the callback to be used whenever \fI\fR\f(CI$column\fR\fI\fR needs to set up \&\fI\fR\f(CI$cell\fR\fI\fR to render a cell. \fI\fR\f(CI$func\fR\fI\fR should look like this: .PP .Vb 3 \& sub cell_data_func { \& my ($column, $cell, $model, $iter, $func_data) = @_; \& } .Ve .PP and should set whatever properties of \fR\f(CI$cell\fR\fI\fR are required for it to draw the data properly. No return value is expected. .ie n .SS "(start_pos, width) = $tree_column\->\fBcell_get_position\fP ($cell_renderer)" .el .SS "(start_pos, width) = \f(CW$tree_column\fP\->\fBcell_get_position\fP ($cell_renderer)" .IX Subsection "(start_pos, width) = $tree_column->cell_get_position ($cell_renderer)" .IP \(bu 4 \&\f(CW$cell_renderer\fR (Gtk2::CellRenderer) .PP Since: gtk+ 2.2 .ie n .SS "list = $tree_column\->\fBcell_get_size\fP" .el .SS "list = \f(CW$tree_column\fP\->\fBcell_get_size\fP" .IX Subsection "list = $tree_column->cell_get_size" .ie n .SS "boolean = $tree_column\->\fBcell_is_visible\fP" .el .SS "boolean = \f(CW$tree_column\fP\->\fBcell_is_visible\fP" .IX Subsection "boolean = $tree_column->cell_is_visible" .ie n .SS "list = $tree_column\->\fBget_cell_renderers\fP" .el .SS "list = \f(CW$tree_column\fP\->\fBget_cell_renderers\fP" .IX Subsection "list = $tree_column->get_cell_renderers" Returns a list of Gtk2::CellRenderer's. .ie n .SS "$tree_column\->\fBcell_set_cell_data\fP ($tree_model, $iter, $is_expander, $is_expanded)" .el .SS "\f(CW$tree_column\fP\->\fBcell_set_cell_data\fP ($tree_model, \f(CW$iter\fP, \f(CW$is_expander\fP, \f(CW$is_expanded\fP)" .IX Subsection "$tree_column->cell_set_cell_data ($tree_model, $iter, $is_expander, $is_expanded)" .IP \(bu 4 \&\f(CW$tree_model\fR (Gtk2::TreeModel) .IP \(bu 4 \&\f(CW$iter\fR (Gtk2::TreeIter) .IP \(bu 4 \&\f(CW$is_expander\fR (boolean) .IP \(bu 4 \&\f(CW$is_expanded\fR (boolean) .ie n .SS $tree_column\->\fBclear\fP .el .SS \f(CW$tree_column\fP\->\fBclear\fP .IX Subsection "$tree_column->clear" .ie n .SS "$tree_column\->\fBclear_attributes\fP ($cell_renderer)" .el .SS "\f(CW$tree_column\fP\->\fBclear_attributes\fP ($cell_renderer)" .IX Subsection "$tree_column->clear_attributes ($cell_renderer)" .IP \(bu 4 \&\f(CW$cell_renderer\fR (Gtk2::CellRenderer) .ie n .SS "boolean = $tree_column\->\fBget_clickable\fP" .el .SS "boolean = \f(CW$tree_column\fP\->\fBget_clickable\fP" .IX Subsection "boolean = $tree_column->get_clickable" .ie n .SS "$tree_column\->\fBset_clickable\fP ($clickable)" .el .SS "\f(CW$tree_column\fP\->\fBset_clickable\fP ($clickable)" .IX Subsection "$tree_column->set_clickable ($clickable)" .IP \(bu 4 \&\f(CW$clickable\fR (boolean) .ie n .SS $tree_column\->\fBclicked\fP .el .SS \f(CW$tree_column\fP\->\fBclicked\fP .IX Subsection "$tree_column->clicked" .ie n .SS "boolean = $tree_column\->\fBget_expand\fP" .el .SS "boolean = \f(CW$tree_column\fP\->\fBget_expand\fP" .IX Subsection "boolean = $tree_column->get_expand" Since: gtk+ 2.4 .ie n .SS "$tree_column\->\fBset_expand\fP ($expand)" .el .SS "\f(CW$tree_column\fP\->\fBset_expand\fP ($expand)" .IX Subsection "$tree_column->set_expand ($expand)" .IP \(bu 4 \&\f(CW$expand\fR (boolean) .PP Since: gtk+ 2.4 .ie n .SS "integer = $tree_column\->\fBget_fixed_width\fP" .el .SS "integer = \f(CW$tree_column\fP\->\fBget_fixed_width\fP" .IX Subsection "integer = $tree_column->get_fixed_width" .ie n .SS "$tree_column\->\fBset_fixed_width\fP ($fixed_width)" .el .SS "\f(CW$tree_column\fP\->\fBset_fixed_width\fP ($fixed_width)" .IX Subsection "$tree_column->set_fixed_width ($fixed_width)" .IP \(bu 4 \&\f(CW$fixed_width\fR (integer) .ie n .SS "$tree_column\->\fBfocus_cell\fP ($cell)" .el .SS "\f(CW$tree_column\fP\->\fBfocus_cell\fP ($cell)" .IX Subsection "$tree_column->focus_cell ($cell)" .IP \(bu 4 \&\f(CW$cell\fR (Gtk2::CellRenderer) .PP Since: gtk+ 2.2 .ie n .SS "integer = $tree_column\->\fBget_max_width\fP" .el .SS "integer = \f(CW$tree_column\fP\->\fBget_max_width\fP" .IX Subsection "integer = $tree_column->get_max_width" .ie n .SS "$tree_column\->\fBset_max_width\fP ($max_width)" .el .SS "\f(CW$tree_column\fP\->\fBset_max_width\fP ($max_width)" .IX Subsection "$tree_column->set_max_width ($max_width)" .IP \(bu 4 \&\f(CW$max_width\fR (integer) .ie n .SS "integer = $tree_column\->\fBget_min_width\fP" .el .SS "integer = \f(CW$tree_column\fP\->\fBget_min_width\fP" .IX Subsection "integer = $tree_column->get_min_width" .ie n .SS "$tree_column\->\fBset_min_width\fP ($min_width)" .el .SS "\f(CW$tree_column\fP\->\fBset_min_width\fP ($min_width)" .IX Subsection "$tree_column->set_min_width ($min_width)" .IP \(bu 4 \&\f(CW$min_width\fR (integer) .ie n .SS "$tree_column\->\fBpack_end\fP ($cell, $expand)" .el .SS "\f(CW$tree_column\fP\->\fBpack_end\fP ($cell, \f(CW$expand\fP)" .IX Subsection "$tree_column->pack_end ($cell, $expand)" .IP \(bu 4 \&\f(CW$cell\fR (Gtk2::CellRenderer) .IP \(bu 4 \&\f(CW$expand\fR (boolean) .ie n .SS "$tree_column\->\fBpack_start\fP ($cell, $expand)" .el .SS "\f(CW$tree_column\fP\->\fBpack_start\fP ($cell, \f(CW$expand\fP)" .IX Subsection "$tree_column->pack_start ($cell, $expand)" .IP \(bu 4 \&\f(CW$cell\fR (Gtk2::CellRenderer) .IP \(bu 4 \&\f(CW$expand\fR (boolean) .ie n .SS $tree_column\->\fBqueue_resize\fP .el .SS \f(CW$tree_column\fP\->\fBqueue_resize\fP .IX Subsection "$tree_column->queue_resize" Since: gtk+ 2.8 .ie n .SS "boolean = $tree_column\->\fBget_reorderable\fP" .el .SS "boolean = \f(CW$tree_column\fP\->\fBget_reorderable\fP" .IX Subsection "boolean = $tree_column->get_reorderable" .ie n .SS "$tree_column\->\fBset_reorderable\fP ($reorderable)" .el .SS "\f(CW$tree_column\fP\->\fBset_reorderable\fP ($reorderable)" .IX Subsection "$tree_column->set_reorderable ($reorderable)" .IP \(bu 4 \&\f(CW$reorderable\fR (boolean) .ie n .SS "boolean = $tree_column\->\fBget_resizable\fP" .el .SS "boolean = \f(CW$tree_column\fP\->\fBget_resizable\fP" .IX Subsection "boolean = $tree_column->get_resizable" .ie n .SS "$tree_column\->\fBset_resizable\fP ($resizable)" .el .SS "\f(CW$tree_column\fP\->\fBset_resizable\fP ($resizable)" .IX Subsection "$tree_column->set_resizable ($resizable)" .IP \(bu 4 \&\f(CW$resizable\fR (boolean) .ie n .SS "treeviewcolumnsizing = $tree_column\->\fBget_sizing\fP" .el .SS "treeviewcolumnsizing = \f(CW$tree_column\fP\->\fBget_sizing\fP" .IX Subsection "treeviewcolumnsizing = $tree_column->get_sizing" .ie n .SS "$tree_column\->\fBset_sizing\fP ($type)" .el .SS "\f(CW$tree_column\fP\->\fBset_sizing\fP ($type)" .IX Subsection "$tree_column->set_sizing ($type)" .IP \(bu 4 \&\f(CW$type\fR (Gtk2::TreeViewColumnSizing) .ie n .SS "integer = $tree_column\->\fBget_sort_column_id\fP" .el .SS "integer = \f(CW$tree_column\fP\->\fBget_sort_column_id\fP" .IX Subsection "integer = $tree_column->get_sort_column_id" .ie n .SS "$tree_column\->\fBset_sort_column_id\fP ($sort_column_id)" .el .SS "\f(CW$tree_column\fP\->\fBset_sort_column_id\fP ($sort_column_id)" .IX Subsection "$tree_column->set_sort_column_id ($sort_column_id)" .IP \(bu 4 \&\f(CW$sort_column_id\fR (integer) .ie n .SS "boolean = $tree_column\->\fBget_sort_indicator\fP" .el .SS "boolean = \f(CW$tree_column\fP\->\fBget_sort_indicator\fP" .IX Subsection "boolean = $tree_column->get_sort_indicator" .ie n .SS "$tree_column\->\fBset_sort_indicator\fP ($setting)" .el .SS "\f(CW$tree_column\fP\->\fBset_sort_indicator\fP ($setting)" .IX Subsection "$tree_column->set_sort_indicator ($setting)" .IP \(bu 4 \&\f(CW$setting\fR (boolean) .ie n .SS "sorttype = $tree_column\->\fBget_sort_order\fP" .el .SS "sorttype = \f(CW$tree_column\fP\->\fBget_sort_order\fP" .IX Subsection "sorttype = $tree_column->get_sort_order" .ie n .SS "$tree_column\->\fBset_sort_order\fP ($order)" .el .SS "\f(CW$tree_column\fP\->\fBset_sort_order\fP ($order)" .IX Subsection "$tree_column->set_sort_order ($order)" .IP \(bu 4 \&\f(CW$order\fR (Gtk2::SortType) .ie n .SS "integer = $tree_column\->\fBget_spacing\fP" .el .SS "integer = \f(CW$tree_column\fP\->\fBget_spacing\fP" .IX Subsection "integer = $tree_column->get_spacing" .ie n .SS "$tree_column\->\fBset_spacing\fP ($spacing)" .el .SS "\f(CW$tree_column\fP\->\fBset_spacing\fP ($spacing)" .IX Subsection "$tree_column->set_spacing ($spacing)" .IP \(bu 4 \&\f(CW$spacing\fR (integer) .ie n .SS "string = $tree_column\->\fBget_title\fP" .el .SS "string = \f(CW$tree_column\fP\->\fBget_title\fP" .IX Subsection "string = $tree_column->get_title" .ie n .SS "$tree_column\->\fBset_title\fP ($title)" .el .SS "\f(CW$tree_column\fP\->\fBset_title\fP ($title)" .IX Subsection "$tree_column->set_title ($title)" .IP \(bu 4 \&\f(CW$title\fR (string) .ie n .SS "widget or undef = $tree_column\->\fBget_tree_view\fP" .el .SS "widget or undef = \f(CW$tree_column\fP\->\fBget_tree_view\fP" .IX Subsection "widget or undef = $tree_column->get_tree_view" Since: gtk+ 2.12 .ie n .SS "boolean = $tree_column\->\fBget_visible\fP" .el .SS "boolean = \f(CW$tree_column\fP\->\fBget_visible\fP" .IX Subsection "boolean = $tree_column->get_visible" .ie n .SS "$tree_column\->\fBset_visible\fP ($visible)" .el .SS "\f(CW$tree_column\fP\->\fBset_visible\fP ($visible)" .IX Subsection "$tree_column->set_visible ($visible)" .IP \(bu 4 \&\f(CW$visible\fR (boolean) .ie n .SS "widget or undef = $tree_column\->\fBget_widget\fP" .el .SS "widget or undef = \f(CW$tree_column\fP\->\fBget_widget\fP" .IX Subsection "widget or undef = $tree_column->get_widget" .ie n .SS "$tree_column\->\fBset_widget\fP ($widget)" .el .SS "\f(CW$tree_column\fP\->\fBset_widget\fP ($widget)" .IX Subsection "$tree_column->set_widget ($widget)" .IP \(bu 4 \&\f(CW$widget\fR (Gtk2::Widget or undef) .ie n .SS "integer = $tree_column\->\fBget_width\fP" .el .SS "integer = \f(CW$tree_column\fP\->\fBget_width\fP" .IX Subsection "integer = $tree_column->get_width" .SH PROPERTIES .IX Header "PROPERTIES" .IP "'alignment' (float : default 0 : readable / writable / private / static-nick / static-blurb)" 4 .IX Item "'alignment' (float : default 0 : readable / writable / private / static-nick / static-blurb)" X Alignment of the column header text or widget .IP "'clickable' (boolean : default false : readable / writable / private / static-nick / static-blurb)" 4 .IX Item "'clickable' (boolean : default false : readable / writable / private / static-nick / static-blurb)" Whether the header can be clicked .IP "'expand' (boolean : default false : readable / writable / private / static-nick / static-blurb)" 4 .IX Item "'expand' (boolean : default false : readable / writable / private / static-nick / static-blurb)" Column gets share of extra width allocated to the widget .IP "'fixed\-width' (integer : default 1 : readable / writable / private / static-nick / static-blurb)" 4 .IX Item "'fixed-width' (integer : default 1 : readable / writable / private / static-nick / static-blurb)" Current fixed width of the column .IP "'max\-width' (integer : default \-1 : readable / writable / private / static-nick / static-blurb)" 4 .IX Item "'max-width' (integer : default -1 : readable / writable / private / static-nick / static-blurb)" Maximum allowed width of the column .IP "'min\-width' (integer : default \-1 : readable / writable / private / static-nick / static-blurb)" 4 .IX Item "'min-width' (integer : default -1 : readable / writable / private / static-nick / static-blurb)" Minimum allowed width of the column .IP "'reorderable' (boolean : default false : readable / writable / private / static-nick / static-blurb)" 4 .IX Item "'reorderable' (boolean : default false : readable / writable / private / static-nick / static-blurb)" Whether the column can be reordered around the headers .IP "'resizable' (boolean : default false : readable / writable / private / static-nick / static-blurb)" 4 .IX Item "'resizable' (boolean : default false : readable / writable / private / static-nick / static-blurb)" Column is user-resizable .IP "'sizing' (Gtk2::TreeViewColumnSizing : default ""grow-only"" : readable / writable / private / static-nick / static-blurb)" 4 .IX Item "'sizing' (Gtk2::TreeViewColumnSizing : default ""grow-only"" : readable / writable / private / static-nick / static-blurb)" Resize mode of the column .IP "'sort\-column\-id' (integer : default \-1 : readable / writable / private / static-nick / static-blurb)" 4 .IX Item "'sort-column-id' (integer : default -1 : readable / writable / private / static-nick / static-blurb)" Logical sort column ID this column sorts on when selected for sorting .IP "'sort\-indicator' (boolean : default false : readable / writable / private / static-nick / static-blurb)" 4 .IX Item "'sort-indicator' (boolean : default false : readable / writable / private / static-nick / static-blurb)" Whether to show a sort indicator .IP "'sort\-order' (Gtk2::SortType : default ""ascending"" : readable / writable / private / static-nick / static-blurb)" 4 .IX Item "'sort-order' (Gtk2::SortType : default ""ascending"" : readable / writable / private / static-nick / static-blurb)" Sort direction the sort indicator should indicate .IP "'spacing' (integer : default 0 : readable / writable / private / static-nick / static-blurb)" 4 .IX Item "'spacing' (integer : default 0 : readable / writable / private / static-nick / static-blurb)" Space which is inserted between cells .IP "'title' (string : default """" : readable / writable / private / static-nick / static-blurb)" 4 .IX Item "'title' (string : default """" : readable / writable / private / static-nick / static-blurb)" Title to appear in column header .IP "'visible' (boolean : default true : readable / writable / private / static-nick / static-blurb)" 4 .IX Item "'visible' (boolean : default true : readable / writable / private / static-nick / static-blurb)" Whether to display the column .IP "'widget' (Gtk2::Widget : default undef : readable / writable / private / static-nick / static-blurb)" 4 .IX Item "'widget' (Gtk2::Widget : default undef : readable / writable / private / static-nick / static-blurb)" Widget to put in column header button instead of column title .IP "'width' (integer : default 0 : readable / private / static-nick / static-blurb)" 4 .IX Item "'width' (integer : default 0 : readable / private / static-nick / static-blurb)" Current width of the column .SH SIGNALS .IX Header "SIGNALS" .IP "\fBclicked\fR (Gtk2::TreeViewColumn)" 4 .IX Item "clicked (Gtk2::TreeViewColumn)" .SH "ENUMS AND FLAGS" .IX Header "ENUMS AND FLAGS" .SS "enum Gtk2::SortType" .IX Subsection "enum Gtk2::SortType" .PD 0 .IP \(bu 4 .PD \&'ascending' / 'GTK_SORT_ASCENDING' .IP \(bu 4 \&'descending' / 'GTK_SORT_DESCENDING' .SS "enum Gtk2::TreeViewColumnSizing" .IX Subsection "enum Gtk2::TreeViewColumnSizing" .IP \(bu 4 \&'grow\-only' / 'GTK_TREE_VIEW_COLUMN_GROW_ONLY' .IP \(bu 4 \&'autosize' / 'GTK_TREE_VIEW_COLUMN_AUTOSIZE' .IP \(bu 4 \&'fixed' / 'GTK_TREE_VIEW_COLUMN_FIXED' .SH "SEE ALSO" .IX Header "SEE ALSO" Gtk2, Glib::Object, Glib::InitiallyUnowned, Gtk2::Object .SH COPYRIGHT .IX Header "COPYRIGHT" Copyright (C) 2003\-2011 by the gtk2\-perl team. .PP This software is licensed under the LGPL. See Gtk2 for a full notice.