GtkTreeViewColumn

已弃用: 4.10 

描述 [源代码]

final class Gtk.TreeViewColumn : GObject.InitiallyUnowned
  implements Gtk.Buildable, Gtk.CellLayout {
  /* No available fields */
}

GtkTreeView 窗口小部件中可见的列

GtkTreeViewColumn 对象代表着 GtkTreeView 窗口小部件中可见的列。它允许用户设置列头属性,并充当单元格渲染器的存放处,单元格渲染器可以确定列中数据的显示方式。

请参阅 树形窗口小部件概念概述 以了解与树形窗口小部件相关的所有对象和数据类型以及它们如何协同工作的概况,并参阅 GtkTreeView 文档以了解有关树形视图及其标题的 CSS 节点结构的具体信息。

弃用以来:4.10

使用 GtkColumnViewGtkColumnViewColumn 来显示表格形式的列表,而不是使用 GtkTreeView

层次结构

hierarchy this GtkTreeViewColumn implements_0 GtkBuildable this--implements_0 implements_1 GtkCellLayout this--implements_1 ancestor_0 GInitiallyUnowned ancestor_0--this ancestor_1 GObject ancestor_1--ancestor_0

构造函数

gtk_tree_view_column_new

创建一个新的 GtkTreeViewColumn

已弃用: 4.10 

gtk_tree_view_column_new_with_area

使用 area 渲染单元格以创建一个新的 GtkTreeViewColumn

已弃用: 4.10 

gtk_tree_view_column_new_with_attributes

使用多个默认值创建一个新的 GtkTreeViewColumn。这等效于在新建的 GtkTreeViewColumn 上调用 gtk_tree_view_column_set_title()gtk_tree_view_column_pack_start()gtk_tree_view_column_set_attributes()

已弃用: 4.10 

实例方法

gtk_tree_view_column_add_attribute

将属性映射添加到 tree_column 中的列表中。

已弃用: 4.10 

gtk_tree_view_column_cell_get_position

获取列中某个单元格的水平位置和大小。

已弃用: 4.10 

gtk_tree_view_column_cell_get_size

获取渲染列所需的宽度和高度。这主要由 GtkTreeView 使用。

已弃用: 4.10 

gtk_tree_view_column_cell_is_visible

如果 packed 到 tree_column 的任何单元格都可见,则返回 TRUE。要做到这一点,必须首先使用 gtk_tree_view_column_cell_set_cell_data() 初始化单元格。

已弃用: 4.10 

gtk_tree_view_column_cell_set_cell_data

根据 tree_modeliter 设置单元格渲染器。也就是说,对于 tree_column 中的每个属性映射,它会从 iter 上的 set 列获取一个值,并使用该值设置单元格渲染器上的属性。这主要用于 GtkTreeView

已弃用: 4.10 

gtk_tree_view_column_clear

取消设置 tree_column 上所有渲染器上的所有映射。

已弃用: 4.10 

gtk_tree_view_column_clear_attributes

清除先前使用 gtk_tree_view_column_set_attributes() 设置的所有现有属性。

已弃用: 4.10 

gtk_tree_view_column_clicked

在列上发出“clicked”信号。此函数仅在 tree_column 可点击时才有效。

已弃用: 4.10 

gtk_tree_view_column_focus_cell

如果该列包含 2 个或更多可编辑和可激活的单元格,则将当前键盘焦点设置为 cell

已弃用: 4.10 

gtk_tree_view_column_get_alignment

返回 tree_column 的当前 x 对齐方式。该值介于 0.0 到 1.0 之间。

已弃用: 4.10 

gtk_tree_view_column_get_button

返回 treeview 列标题中使用的按钮。

已弃用: 4.10 

gtk_tree_view_column_get_clickable

如果用户可以单击列标题,则返回 TRUE

已弃用: 4.10 

gtk_tree_view_column_get_expand

如果列展开以填充可用空间,则返回 TRUE

已弃用: 4.10 

gtk_tree_view_column_get_fixed_width

获取列的固定宽度。这可能不是列的实际显示宽度;为此,请使用 gtk_tree_view_column_get_width()。

已弃用: 4.10 

gtk_tree_view_column_get_max_width

返回 tree_column 的最大宽度(以像素为单位),如果没有设置最大宽度,则返回 -1。

已弃用: 4.10 

gtk_tree_view_column_get_min_width

返回 tree_column 的最小宽度(以像素为单位),如果没有设置最小宽度,则返回 -1。

已弃用: 4.10 

gtk_tree_view_column_get_reorderable

如果 tree_column 可以由用户重新排序,则返回 TRUE

已弃用: 4.10 

gtk_tree_view_column_get_resizable

如果 tree_column 可以由最终用户调整大小,则返回 TRUE

已弃用: 4.10 

gtk_tree_view_column_get_sizing

返回 tree_column 的当前类型。

已弃用: 4.10 

gtk_tree_view_column_get_sort_column_id

获取逻辑 sort_column_id,当选中此列进行排序时,模型将对其进行排序。

已弃用: 4.10 

gtk_tree_view_column_get_sort_indicator

获取 gtk_tree_view_column_set_sort_indicator() 设置的值。

已弃用: 4.10 

gtk_tree_view_column_get_sort_order

获取 gtk_tree_view_column_set_sort_order() 设置的值。

已弃用: 4.10 

gtk_tree_view_column_get_spacing

返回 tree_column 的间距。

已弃用: 4.10 

gtk_tree_view_column_get_title

返回该 widget 的标题。

已弃用: 4.10 

gtk_tree_view_column_get_tree_view

返回已插入了 tree_columnGtkTreeView。如果目前 column 尚未插入任何树视图,则返回 NULL

已弃用: 4.10 

gtk_tree_view_column_get_visible

如果 tree_column 可见,则返回 TRUE

已弃用: 4.10 

gtk_tree_view_column_get_widget

返回列标题中按钮中的 GtkWidget

已弃用: 4.10 

gtk_tree_view_column_get_width

返回 tree_column 的当前大小(以像素为单位)。

已弃用: 4.10 

gtk_tree_view_column_get_x_offset

返回 tree_column 的当前 X 偏移量(以像素为单位)。

已弃用: 4.10 

gtk_tree_view_column_pack_end

cell 添加到列尾。如果 expandFALSE,则 cell 分配的空间不超过其所需空间。任何未使用空间都将在 expandTRUE 的单元格之间平均分配。

已弃用: 4.10 

gtk_tree_view_column_pack_start

cell 打包到列首。如果 expandFALSE,则 cell 分配的空间不超过其所需空间。任何未使用空间都将在 expandTRUE 的单元格之间平均分配。

已弃用: 4.10 

gtk_tree_view_column_queue_resize

标记该列和添加到此列中的单元格呈现器重新协商其大小。

已弃用: 4.10 

gtk_tree_view_column_set_alignment

设置列标题或自定义小工具内的对齐方式。对齐方式决定其在按钮内的位置 - 左边为 0.0、中间为 0.5、右边为 1.0。

已弃用: 4.10 

gtk_tree_view_column_set_attributes

将 list 中的属性设置为 tree_column 的属性。

已弃用: 4.10 

gtk_tree_view_column_set_cell_data_func

设置要用于 column 的 GtkTreeCellDataFunc。

已弃用: 4.10 

gtk_tree_view_column_set_clickable

如果 clickable 为 TRUE,则设置标题为活动状态。当标题处于活动状态时,它可以获取键盘焦点,还可以单击。

已弃用: 4.10 

gtk_tree_view_column_set_expand

将列设置为占用可用的额外空间。所有已将 expand 设置为 TRUE 的列将平均共享此空间。如果没有任何列设置此选项,则最后一列将获取所有额外空间。默认情况下,每个列都是使用 FALSE 创建的。

已弃用: 4.10 

gtk_tree_view_column_set_fixed_width

如果 fixed_width 不为 -1,则设置树列 tree_column 的固定宽度;否则取消设置。fixed_width 的有效值会被限制在列的最小宽度和最大宽度之间;然而,“fixed-width”属性中存储的值不会被限制。如果列大小调整为 GTK_TREE_VIEW_COLUMN_GROW_ONLY 或 GTK_TREE_VIEW_COLUMN_AUTOSIZE,则设置固定宽度将覆盖自动计算的宽度。注意,固定宽度只是对 GTK 的提示;实际分配给列的宽度可能大于或小于所请求的宽度。

已弃用: 4.10 

gtk_tree_view_column_set_max_width

设置树列 tree_column 的最大宽度。如果 max_width 为 -1,则取消设置最大宽度。注意,如果该列是视图中的最后一列,则该列实际上可能比最大宽度更宽。在这种情况下,该列会扩展以填充任何额外空间。

已弃用: 4.10 

gtk_tree_view_column_set_min_width

设置树列 tree_column 的最小宽度。如果 min_width 为 -1,则取消设置最小宽度。

已弃用: 4.10 

gtk_tree_view_column_set_reorderable

如果 reorderable 为 TRUE,则终端用户可通过拖动标题对列重新排序。

已弃用: 4.10 

gtk_tree_view_column_set_resizable

如果 resizable 为 TRUE,则用户可以通过抓住列按钮的外边缘明确调整列的大小。

已弃用: 4.10 

gtk_tree_view_column_set_sizing

将 tree_column 的增长行为设置为 type。

已弃用: 4.10 

gtk_tree_view_column_set_sort_column_id

为此列选择排序时,设置此列按其排序的逻辑 sort_column_id。这样做将使列标题可单击。

已弃用: 4.10 

gtk_tree_view_column_set_sort_indicator

使用 setting 为 TRUE 调用此函数,以便在标题按钮中显示箭头,指示对该列进行了排序。调用 gtk_tree_view_column_set_sort_order() 以更改箭头的方向。

已弃用: 4.10 

gtk_tree_view_column_set_sort_order

更改排序指示符的外观。

已弃用: 4.10 

gtk_tree_view_column_set_spacing

设置 tree_column 的间距字段,它是打包到其中的单元格呈现器之间放置的像素数。

已弃用: 4.10 

gtk_tree_view_column_set_title

设置 tree_column 的标题。如果已设置自定义小工具,则会忽略此值。

已弃用: 4.10 

gtk_tree_view_column_set_visible

设置 tree_column 的可见性。

已弃用: 4.10 

gtk_tree_view_column_set_widget

将标题设置为 widget。如果部件是 NULL,则使用一个设置了 tree_column 标题的 GtkLabel 设置标题按钮。

已弃用: 4.10 

GObject 继承的方法 (43)

请参阅 GObject 以获取完整的方法列表。

GtkBuildable 继承的方法 (1)
gtk_buildable_get_buildable_id

获取 buildable 对象的 ID

GtkCellLayout 继承的方法 (10)
gtk_cell_layout_add_attribute

cell_layout 中的列表添加属性映射。

已弃用: 4.10 

gtk_cell_layout_clear

取消设置 cell_layout 上所有渲染器上的所有映射,并从 cell_layout 中移除所有渲染器。

已弃用: 4.10 

gtk_cell_layout_clear_attributes

清除以前使用 gtk_cell_layout_set_attributes() 设置的所有现有属性。

已弃用: 4.10 

gtk_cell_layout_get_area

如果在 GtkCellArea 上调用,返回可能为 cell_layout 的底层 GtkCellArea,或者如果没有 GtkCellAreacell_layout 使用,则可能为 NULL

已弃用: 4.10 

gtk_cell_layout_get_cells

返回已添加到 cell_layout 的单元格渲染器。

已弃用: 4.10 

gtk_cell_layout_pack_end

cell 添加到 cell_layout 的末尾。如果 expandFALSE,则为 cell 分配的空间不超过其需要。所有未使用空间都将平均分配给 expandTRUE 的单元格。

已弃用: 4.10 

gtk_cell_layout_pack_start

cell 打包到 cell_layout 的开头。如果 expandFALSE,则为 cell 分配的空间不超过其需要。所有未使用空间都将平均分配给 expandTRUE 的单元格。

已弃用: 4.10 

gtk_cell_layout_reorder

position 处重新插入 cell

已弃用: 4.10 

gtk_cell_layout_set_attributes

将参数列表中的属性设置为 cell_layout 的属性。

已弃用: 4.10 

gtk_cell_layout_set_cell_data_func

cell_layout 设置要使用的 GtkCellLayoutDataFunc。

已弃用: 4.10 

属性

Gtk.TreeViewColumn:alignment
无可用说明。

Gtk.TreeViewColumn:cell-area

用于为该列布局单元格渲染器的 GtkCellArea

Gtk.TreeViewColumn:clickable
无可用说明。

Gtk.TreeViewColumn:expand
无可用说明。

Gtk.TreeViewColumn:fixed-width
无可用说明。

Gtk.TreeViewColumn:max-width
无可用说明。

Gtk.TreeViewColumn:min-width
无可用说明。

Gtk.TreeViewColumn:reorderable
无可用说明。

Gtk.TreeViewColumn:resizable
无可用说明。

Gtk.TreeViewColumn:sizing
无可用说明。

Gtk.TreeViewColumn:sort-column-id

选择的排序列 ID 进行排序时的逻辑排序列 ID。设置排序列 ID 使列标题可单击。设置为 -1 以使列无法排序。

Gtk.TreeViewColumn:sort-order
无可用说明。

Gtk.TreeViewColumn:spacing
无可用说明。

Gtk.TreeViewColumn:title
无可用说明。

Gtk.TreeViewColumn:visible
无可用说明。

Gtk.TreeViewColumn:widget
无可用说明。

Gtk.TreeViewColumn:width
无可用说明。

Gtk.TreeViewColumn:x-offset
无可用说明。

信号

Gtk.TreeViewColumn::clicked

在单击列标题时发出。

GObject 继承的信号 (1)
GObject::notify

当某个属性值通过 g_object_set_property()、g_object_set() 等设置时,会在对象上发出 notify 信号。