2000-10-30 23:21:38 +00:00
|
|
|
<!-- ##### SECTION Title ##### -->
|
|
|
|
GtkTreeViewColumn
|
|
|
|
|
|
|
|
<!-- ##### SECTION Short_Description ##### -->
|
2002-03-03 06:37:43 +00:00
|
|
|
A visible column in a #GtkTreeView widget
|
2000-10-30 23:21:38 +00:00
|
|
|
|
|
|
|
<!-- ##### SECTION Long_Description ##### -->
|
|
|
|
<para>
|
2002-03-03 06:37:43 +00:00
|
|
|
The GtkTreeViewColumn object is a visible column in a #GtkTreeView
|
|
|
|
widget. It determines the geometry, type
|
2000-10-30 23:21:38 +00:00
|
|
|
</para>
|
|
|
|
|
|
|
|
<!-- ##### SECTION See_Also ##### -->
|
|
|
|
<para>
|
2002-03-03 06:37:43 +00:00
|
|
|
#GtkTreeView, #GtkTreeSelection, #GtkTreeDnd, #GtkTreeMode, #GtkTreeSortable, #GtkTreeModelSort, #GtkListStore, #GtkTreeStore, #GtkCellRenderer, #GtkCellEditable, #GtkCellRendererPixbuf, #GtkCellRendererText, #GtkCellRendererToggle
|
2000-10-30 23:21:38 +00:00
|
|
|
|
|
|
|
</para>
|
|
|
|
|
2001-01-09 16:41:17 +00:00
|
|
|
<!-- ##### ENUM GtkTreeViewColumnSizing ##### -->
|
2000-10-30 23:21:38 +00:00
|
|
|
<para>
|
2002-03-03 06:37:43 +00:00
|
|
|
The sizing method the column uses to determine it's width. Please note
|
|
|
|
that @GTK_TREE_VIEW_COLUMN_AUTOSIZE are inefficient for large views, and
|
|
|
|
can make columns appear choppy.
|
2000-10-30 23:21:38 +00:00
|
|
|
</para>
|
|
|
|
|
2002-03-03 06:37:43 +00:00
|
|
|
@GTK_TREE_VIEW_COLUMN_GROW_ONLY: Columns only get bigger in reaction to changes in the model
|
|
|
|
@GTK_TREE_VIEW_COLUMN_AUTOSIZE: Columns resize to be the optimal size everytime the model changes.
|
|
|
|
@GTK_TREE_VIEW_COLUMN_FIXED: Columns are a fixed numbers of pixels wide.
|
2000-10-30 23:21:38 +00:00
|
|
|
|
2001-10-03 04:44:13 +00:00
|
|
|
<!-- ##### USER_FUNCTION GtkTreeCellDataFunc ##### -->
|
|
|
|
<para>
|
2002-03-03 06:37:43 +00:00
|
|
|
A function to set the properties of a cell instead of just using the
|
|
|
|
straight mapping between the cell and the model. This is useful for
|
|
|
|
customizing the cell renderer. For example, a function might get an
|
|
|
|
integer from the @tree_model, and render it to the "text" attribute of
|
|
|
|
"cell" by converting it to its written equivilent. This is set by
|
|
|
|
calling gtk_tree_view_column_set_cell_data_func()
|
2001-10-03 04:44:13 +00:00
|
|
|
</para>
|
|
|
|
|
2002-03-03 06:37:43 +00:00
|
|
|
@tree_column: A #GtkTreeColumn
|
|
|
|
@cell: The #GtkCellRenderer that is being rendered by @tree_column
|
|
|
|
@tree_model: The #GtkTreeModel being rendered
|
|
|
|
@iter: A #GtkTreeIter of the current row rendered
|
|
|
|
@data: user data
|
2001-10-03 04:44:13 +00:00
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### STRUCT GtkTreeViewColumn ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
|
2000-10-30 23:21:38 +00:00
|
|
|
<!-- ##### FUNCTION gtk_tree_view_column_new ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_tree_view_column_new_with_attributes ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@title:
|
|
|
|
@cell:
|
|
|
|
@Varargs:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
2001-10-03 04:44:13 +00:00
|
|
|
<!-- ##### FUNCTION gtk_tree_view_column_pack_start ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@tree_column:
|
|
|
|
@cell:
|
|
|
|
@expand:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_tree_view_column_pack_end ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@tree_column:
|
|
|
|
@cell:
|
|
|
|
@expand:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_tree_view_column_clear ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@tree_column:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_tree_view_column_get_cell_renderers ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@tree_column:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
2000-10-30 23:21:38 +00:00
|
|
|
<!-- ##### FUNCTION gtk_tree_view_column_add_attribute ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@tree_column:
|
2001-06-28 05:24:00 +00:00
|
|
|
@cell_renderer:
|
2000-10-30 23:21:38 +00:00
|
|
|
@attribute:
|
|
|
|
@column:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_tree_view_column_set_attributes ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@tree_column:
|
2001-06-28 05:24:00 +00:00
|
|
|
@cell_renderer:
|
2000-10-30 23:21:38 +00:00
|
|
|
@Varargs:
|
|
|
|
|
|
|
|
|
2001-10-03 04:44:13 +00:00
|
|
|
<!-- ##### FUNCTION gtk_tree_view_column_set_cell_data_func ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@tree_column:
|
|
|
|
@cell_renderer:
|
|
|
|
@func:
|
|
|
|
@func_data:
|
|
|
|
@destroy:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_tree_view_column_clear_attributes ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@tree_column:
|
|
|
|
@cell_renderer:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_tree_view_column_set_spacing ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@tree_column:
|
|
|
|
@spacing:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_tree_view_column_get_spacing ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@tree_column:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
2000-10-30 23:21:38 +00:00
|
|
|
<!-- ##### FUNCTION gtk_tree_view_column_set_visible ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@tree_column:
|
|
|
|
@visible:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_tree_view_column_get_visible ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@tree_column:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
2001-11-21 21:43:47 +00:00
|
|
|
<!-- ##### FUNCTION gtk_tree_view_column_set_resizable ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@tree_column:
|
|
|
|
@resizable:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_tree_view_column_get_resizable ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@tree_column:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
2001-01-09 16:41:17 +00:00
|
|
|
<!-- ##### FUNCTION gtk_tree_view_column_set_sizing ##### -->
|
2000-10-30 23:21:38 +00:00
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@tree_column:
|
|
|
|
@type:
|
|
|
|
|
|
|
|
|
2001-02-03 01:09:41 +00:00
|
|
|
<!-- ##### FUNCTION gtk_tree_view_column_get_sizing ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@tree_column:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_tree_view_column_get_width ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@tree_column:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
2001-10-03 04:44:13 +00:00
|
|
|
<!-- ##### FUNCTION gtk_tree_view_column_get_fixed_width ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@tree_column:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_tree_view_column_set_fixed_width ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@tree_column:
|
|
|
|
@fixed_width:
|
|
|
|
|
|
|
|
|
2000-10-30 23:21:38 +00:00
|
|
|
<!-- ##### FUNCTION gtk_tree_view_column_set_min_width ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@tree_column:
|
|
|
|
@min_width:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_tree_view_column_get_min_width ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@tree_column:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_tree_view_column_set_max_width ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@tree_column:
|
|
|
|
@max_width:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_tree_view_column_get_max_width ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@tree_column:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
2001-10-03 04:44:13 +00:00
|
|
|
<!-- ##### FUNCTION gtk_tree_view_column_clicked ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@tree_column:
|
|
|
|
|
|
|
|
|
2000-10-30 23:21:38 +00:00
|
|
|
<!-- ##### FUNCTION gtk_tree_view_column_set_title ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@tree_column:
|
|
|
|
@title:
|
|
|
|
|
|
|
|
|
2001-03-03 23:29:50 +00:00
|
|
|
<!-- ##### FUNCTION gtk_tree_view_column_get_title ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@tree_column:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
2001-02-03 01:09:41 +00:00
|
|
|
<!-- ##### FUNCTION gtk_tree_view_column_set_clickable ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@tree_column:
|
2001-05-18 18:28:52 +00:00
|
|
|
@clickable:
|
|
|
|
<!-- # Unused Parameters # -->
|
2001-02-03 01:09:41 +00:00
|
|
|
@active:
|
|
|
|
|
|
|
|
|
2001-10-03 04:44:13 +00:00
|
|
|
<!-- ##### FUNCTION gtk_tree_view_column_get_clickable ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@tree_column:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
2000-10-30 23:21:38 +00:00
|
|
|
<!-- ##### FUNCTION gtk_tree_view_column_set_widget ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@tree_column:
|
|
|
|
@widget:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_tree_view_column_get_widget ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@tree_column:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
2001-03-23 22:21:06 +00:00
|
|
|
<!-- ##### FUNCTION gtk_tree_view_column_set_alignment ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@tree_column:
|
|
|
|
@xalign:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_tree_view_column_get_alignment ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@tree_column:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
2001-10-03 04:44:13 +00:00
|
|
|
<!-- ##### FUNCTION gtk_tree_view_column_set_reorderable ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@tree_column:
|
|
|
|
@reorderable:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_tree_view_column_get_reorderable ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@tree_column:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_tree_view_column_set_sort_column_id ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@tree_column:
|
|
|
|
@sort_column_id:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_tree_view_column_get_sort_column_id ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@tree_column:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_tree_view_column_set_sort_indicator ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@tree_column:
|
|
|
|
@setting:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_tree_view_column_get_sort_indicator ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@tree_column:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_tree_view_column_set_sort_order ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@tree_column:
|
|
|
|
@order:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_tree_view_column_get_sort_order ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@tree_column:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_tree_view_column_cell_set_cell_data ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@tree_column:
|
|
|
|
@tree_model:
|
|
|
|
@iter:
|
|
|
|
@is_expander:
|
|
|
|
@is_expanded:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_tree_view_column_cell_get_size ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@tree_column:
|
|
|
|
@cell_area:
|
|
|
|
@x_offset:
|
|
|
|
@y_offset:
|
|
|
|
@width:
|
|
|
|
@height:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_tree_view_column_cell_is_visible ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@tree_column:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
Documentation fixes.
Sun Oct 13 18:50:14 2002 Soeren Sandmann <sandmann@daimi.au.dk>
* gtkmenu.c, gtkmenu.sgml, gtkitemfactory.c, gdkwindow.c,
gtkwindow.c, gtkpaned.sgml, gtkdialog.c, gtkbox.h, gtkbutton.sgml,
gtktreemodel.sgml,gtktable.sgml, gtktable.c:
Documentation fixes.
#85719, #90759, #95169, Owen Taylor;
#89221, Yao Zhang, Matthias Clasen;
#95592, Joost Faassen;
#92637, Vitaly Tishkov;
#94616, Ben Martin;
#94772, sbaillie@bigpond.net.au;
2002-10-13 17:17:14 +00:00
|
|
|
<!-- ##### FUNCTION gtk_tree_view_column_focus_cell ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@tree_column:
|
|
|
|
@cell:
|
|
|
|
|
|
|
|
|
2001-09-27 00:09:41 +00:00
|
|
|
<!-- ##### SIGNAL GtkTreeViewColumn::clicked ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@treeviewcolumn: the object which received the signal.
|
|
|
|
|
2002-11-02 18:18:50 +00:00
|
|
|
<!-- ##### ARG GtkTreeViewColumn:alignment ##### -->
|
2001-09-27 00:09:41 +00:00
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
2002-11-02 18:18:50 +00:00
|
|
|
<!-- ##### ARG GtkTreeViewColumn:clickable ##### -->
|
2001-11-20 13:55:08 +00:00
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
2002-11-02 18:18:50 +00:00
|
|
|
<!-- ##### ARG GtkTreeViewColumn:fixed-width ##### -->
|
2001-09-27 00:09:41 +00:00
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
2002-11-02 18:18:50 +00:00
|
|
|
<!-- ##### ARG GtkTreeViewColumn:max-width ##### -->
|
2001-09-27 00:09:41 +00:00
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
2002-11-02 18:18:50 +00:00
|
|
|
<!-- ##### ARG GtkTreeViewColumn:min-width ##### -->
|
2001-09-27 00:09:41 +00:00
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
2002-11-02 18:18:50 +00:00
|
|
|
<!-- ##### ARG GtkTreeViewColumn:reorderable ##### -->
|
2001-09-27 00:09:41 +00:00
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
2002-11-02 18:18:50 +00:00
|
|
|
<!-- ##### ARG GtkTreeViewColumn:resizable ##### -->
|
2001-09-27 00:09:41 +00:00
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
2002-11-02 18:18:50 +00:00
|
|
|
<!-- ##### ARG GtkTreeViewColumn:sizing ##### -->
|
2001-09-27 00:09:41 +00:00
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
2002-11-02 18:18:50 +00:00
|
|
|
<!-- ##### ARG GtkTreeViewColumn:sort-indicator ##### -->
|
2001-09-27 00:09:41 +00:00
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
2002-11-02 18:18:50 +00:00
|
|
|
<!-- ##### ARG GtkTreeViewColumn:sort-order ##### -->
|
2001-09-27 00:09:41 +00:00
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
2002-11-02 18:18:50 +00:00
|
|
|
<!-- ##### ARG GtkTreeViewColumn:title ##### -->
|
2001-09-27 00:09:41 +00:00
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
2002-11-02 18:18:50 +00:00
|
|
|
<!-- ##### ARG GtkTreeViewColumn:visible ##### -->
|
2001-09-27 00:09:41 +00:00
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
2002-11-02 18:18:50 +00:00
|
|
|
<!-- ##### ARG GtkTreeViewColumn:widget ##### -->
|
2001-09-27 00:09:41 +00:00
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
2002-11-02 18:18:50 +00:00
|
|
|
<!-- ##### ARG GtkTreeViewColumn:width ##### -->
|
2001-09-27 00:09:41 +00:00
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|