gtk2/docs/reference/gtk/tmpl/gtktreeviewcolumn.sgml
Owen Taylor 85c05a86c0 === Released 2.3.1 ===
Mon Dec  8 10:54:44 2003  Owen Taylor  <otaylor@redhat.com>

        * === Released 2.3.1 ===

        * NEWS: Updates for 2.3.1

        * configure.in: Version 2.3.1, interface age 0, binary age 301.

        * gtk/gtkmenuitem.c (gtk_menu_item_can_activate_accel):
        Rename from gtk_menu_item_real_can_activate_accel() to
        match GTK+ convention, improve comment.

        * gtk/gtkwidget.c: Document gtk_widget_can_activate_accel(),
        can ::can-activate-accel signal.

        * gtk/gtkwidget.c (closure_accel_activate): Fix spelling
        in comment.

        * gtk/gtkmenu.c (gtk_menu_real_can_activate_accel): Clean
        up comment.

        * gtk/gtkcellview{,menuitem}.[ch]: Move GET_PRIVATE() macros
        into the .c file.

Mon Dec  8 12:09:21 2003  Owen Taylor  <otaylor@redhat.com>

        * gtk/gtkicontheme.c (find_builtin_icon): Fix a
        missing 'else'. (#128816, Jorn Baayen)
2003-12-08 22:55:03 +00:00

595 lines
8.5 KiB
Plaintext

<!-- ##### SECTION Title ##### -->
GtkTreeViewColumn
<!-- ##### SECTION Short_Description ##### -->
A visible column in a #GtkTreeView widget
<!-- ##### SECTION Long_Description ##### -->
<para>
The GtkTreeViewColumn object is a visible column in a #GtkTreeView
widget. It determines the geometry, type
</para>
<!-- ##### SECTION See_Also ##### -->
<para>
#GtkTreeView, #GtkTreeSelection, #GtkTreeDnd, #GtkTreeMode, #GtkTreeSortable, #GtkTreeModelSort, #GtkListStore, #GtkTreeStore, #GtkCellRenderer, #GtkCellEditable, #GtkCellRendererPixbuf, #GtkCellRendererText, #GtkCellRendererToggle
</para>
<!-- ##### ENUM GtkTreeViewColumnSizing ##### -->
<para>
The sizing method the column uses to determine its width. Please note
that @GTK_TREE_VIEW_COLUMN_AUTOSIZE are inefficient for large views, and
can make columns appear choppy.
</para>
@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.
<!-- ##### USER_FUNCTION GtkTreeCellDataFunc ##### -->
<para>
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()
</para>
@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
<!-- ##### STRUCT GtkTreeViewColumn ##### -->
<para>
</para>
<!-- ##### SIGNAL GtkTreeViewColumn::clicked ##### -->
<para>
</para>
@treeviewcolumn: the object which received the signal.
<!-- ##### ARG GtkTreeViewColumn:alignment ##### -->
<para>
</para>
<!-- ##### ARG GtkTreeViewColumn:clickable ##### -->
<para>
</para>
<!-- ##### ARG GtkTreeViewColumn:expand ##### -->
<para>
</para>
<!-- ##### ARG GtkTreeViewColumn:fixed-width ##### -->
<para>
</para>
<!-- ##### ARG GtkTreeViewColumn:max-width ##### -->
<para>
</para>
<!-- ##### ARG GtkTreeViewColumn:min-width ##### -->
<para>
</para>
<!-- ##### ARG GtkTreeViewColumn:reorderable ##### -->
<para>
</para>
<!-- ##### ARG GtkTreeViewColumn:resizable ##### -->
<para>
</para>
<!-- ##### ARG GtkTreeViewColumn:sizing ##### -->
<para>
</para>
<!-- ##### ARG GtkTreeViewColumn:sort-indicator ##### -->
<para>
</para>
<!-- ##### ARG GtkTreeViewColumn:sort-order ##### -->
<para>
</para>
<!-- ##### ARG GtkTreeViewColumn:title ##### -->
<para>
</para>
<!-- ##### ARG GtkTreeViewColumn:visible ##### -->
<para>
</para>
<!-- ##### ARG GtkTreeViewColumn:widget ##### -->
<para>
</para>
<!-- ##### ARG GtkTreeViewColumn:width ##### -->
<para>
</para>
<!-- ##### FUNCTION gtk_tree_view_column_new ##### -->
<para>
</para>
@Returns:
<!-- ##### FUNCTION gtk_tree_view_column_new_with_attributes ##### -->
<para>
</para>
@title:
@cell:
@Varargs:
@Returns:
<!-- ##### 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:
<!-- ##### FUNCTION gtk_tree_view_column_add_attribute ##### -->
<para>
</para>
@tree_column:
@cell_renderer:
@attribute:
@column:
<!-- ##### FUNCTION gtk_tree_view_column_set_attributes ##### -->
<para>
</para>
@tree_column:
@cell_renderer:
@Varargs:
<!-- ##### 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:
<!-- ##### FUNCTION gtk_tree_view_column_set_visible ##### -->
<para>
</para>
@tree_column:
@visible:
<!-- ##### FUNCTION gtk_tree_view_column_get_visible ##### -->
<para>
</para>
@tree_column:
@Returns:
<!-- ##### FUNCTION gtk_tree_view_column_set_resizable ##### -->
<para>
</para>
@tree_column:
@resizable:
<!-- ##### FUNCTION gtk_tree_view_column_get_resizable ##### -->
<para>
</para>
@tree_column:
@Returns:
<!-- ##### FUNCTION gtk_tree_view_column_set_sizing ##### -->
<para>
</para>
@tree_column:
@type:
<!-- ##### FUNCTION gtk_tree_view_column_get_sizing ##### -->
<para>
</para>
@tree_column:
@Returns:
<!-- ##### FUNCTION gtk_tree_view_column_get_width ##### -->
<para>
</para>
@tree_column:
@Returns:
<!-- ##### 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:
<!-- ##### 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:
<!-- ##### FUNCTION gtk_tree_view_column_clicked ##### -->
<para>
</para>
@tree_column:
<!-- ##### FUNCTION gtk_tree_view_column_set_title ##### -->
<para>
</para>
@tree_column:
@title:
<!-- ##### FUNCTION gtk_tree_view_column_get_title ##### -->
<para>
</para>
@tree_column:
@Returns:
<!-- ##### FUNCTION gtk_tree_view_column_set_expand ##### -->
<para>
</para>
@tree_column:
@expand:
<!-- ##### FUNCTION gtk_tree_view_column_get_expand ##### -->
<para>
</para>
@tree_column:
@Returns:
<!-- ##### FUNCTION gtk_tree_view_column_set_clickable ##### -->
<para>
</para>
@tree_column:
@clickable:
<!-- # Unused Parameters # -->
@active:
<!-- ##### FUNCTION gtk_tree_view_column_get_clickable ##### -->
<para>
</para>
@tree_column:
@Returns:
<!-- ##### FUNCTION gtk_tree_view_column_set_widget ##### -->
<para>
</para>
@tree_column:
@widget:
<!-- ##### FUNCTION gtk_tree_view_column_get_widget ##### -->
<para>
</para>
@tree_column:
@Returns:
<!-- ##### FUNCTION gtk_tree_view_column_set_alignment ##### -->
<para>
</para>
@tree_column:
@xalign:
<!-- ##### FUNCTION gtk_tree_view_column_get_alignment ##### -->
<para>
</para>
@tree_column:
@Returns:
<!-- ##### 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_get_position ##### -->
<para>
</para>
@tree_column:
@cell_renderer:
@start_pos:
@width:
@Returns:
<!-- ##### FUNCTION gtk_tree_view_column_cell_is_visible ##### -->
<para>
</para>
@tree_column:
@Returns:
<!-- ##### FUNCTION gtk_tree_view_column_focus_cell ##### -->
<para>
</para>
@tree_column:
@cell: