GtkTreeView

已弃用:4.10 

描述 [src]

class Gtk.TreeView : Gtk.Widget
  implements Gtk.Accessible, Gtk.Buildable, Gtk.ConstraintTarget, Gtk.Scrollable {
  /* No available fields */
}

用于显示树和列表的小部件

显示任何实现 GtkTreeModel 接口的对象的小部件。

请参阅 树小部件概念性概览 以了解与树小部件相关的所有对象和数据类型以及它们协同工作的方式的概览。

GtkTreeView API 中的坐标系

GtkTreeView API 中显示了几个不同的坐标系。这些是

  • 小部件坐标:相对于小部件(通常为 widget->window)的坐标。

  • Bin 窗口坐标:相对于 GtkTreeView 渲染到的窗口的坐标。

  • 树坐标:相对于 GtkTreeView 可滚动区域的坐标。这些坐标从树的第 0 行 (0, 0) 开始。

可以使用多个函数在不同坐标系统之间进行转换。最常见的转换在小部件和 bin 窗口坐标以及 bin 窗口和树坐标之间进行。对于前者可以使用 gtk_tree_view_convert_widget_to_bin_window_coords()(及反向),对于后者可以使用 gtk_tree_view_convert_bin_window_to_tree_coords()(及反向)。

GtkTreeView作为GtkBuildable

GtkTreeView实现的GtkBuildable接口接受 GtkTreeViewColumn 对象作为 <child> 元素,并在 UI 定义中公开内部 GtkTreeSelection

使用 GtkTreeView 的 UI 定义片段示例

<object class="GtkTreeView" id="treeview">
  <property name="model">liststore1</property>
  <child>
    <object class="GtkTreeViewColumn" id="test-column">
      <property name="title">Test</property>
      <child>
        <object class="GtkCellRendererText" id="test-renderer"/>
        <attributes>
          <attribute name="text">1</attribute>
        </attributes>
      </child>
    </object>
  </child>
  <child internal-child="selection">
    <object class="GtkTreeSelection" id="selection">
      <signal name="changed" handler="on_treeview_selection_changed"/>
    </object>
  </child>
</object>

CSS 节点

treeview.view
├── header
│   ├── button
│   │   ╰── [sort-indicator]
┊   ┊
│   ╰── button
│       ╰── [sort-indicator]
│
├── [rubberband]
╰── [dndtarget]

GtkTreeView 具有名称为 treeview 和样式类 .view 的主 CSS 节点。它具有一个名称为 header 的子节点,该子节点是所有列标题小部件的 CSS 节点的父级。

每个列标题包括一个 `button`,除了其他内容外,它还具有一个名称为 `sort-indicator` 的子元素,在列标题应显示排序指示器时,该子元素带有 `ascending` 或 `descending` 样式类。CSS 预计将使用 `-gtk-icon-source` 属性提供合适的图像。

对于橡皮筋选择,使用名称为 `rubberband` 的子节点。

对于拖放期间的放置目标,使用名称为 `dndtarget` 的子节点。

弃用时间:4.10

使用 GtkListView 表示列表,使用 GtkColumnView 表示表格列表。

层次结构

hierarchy this GtkTreeView implements_0 GtkAccessible this--implements_0 implements_1 GtkBuildable this--implements_1 implements_2 GtkConstraintTarget this--implements_2 implements_3 GtkScrollable this--implements_3 ancestor_0 GtkWidget ancestor_0--this ancestor_1 GInitiallyUnowned ancestor_1--ancestor_0 ancestor_2 GObject ancestor_2--ancestor_1

构造函数

gtk_tree_view_new

创建新的 GtkTreeView 小部件。

已弃用:4.10 

gtk_tree_view_new_with_model

创建新的 GtkTreeView 小部件,该小部件的模型已初始化为 model

已弃用:4.10 

实例方法

gtk_tree_view_append_column

column 追加到列列表中。如果启用 tree_view 的“fixed_height”模式,则 column 必须将其“sizing”属性设置为 GTK_TREE_VIEW_COLUMN_FIXED。

已弃用:4.10 

gtk_tree_view_collapse_all

递归折叠 tree_view 中所有可见且已展开的节点。

已弃用:4.10 

gtk_tree_view_collapse_row

折叠一行(隐藏其子行,如果存在)。

已弃用:4.10 

gtk_tree_view_columns_autosize

将所有列调整为其最佳宽度。仅在树状视图已实现后才能工作。

已弃用:4.10 

gtk_tree_view_convert_bin_window_to_tree_coords

将 bin_window 坐标转换为树的坐标(树的可滚动区域)。

已弃用:4.10 

gtk_tree_view_convert_bin_window_to_widget_coords

将 bin_window 坐标转换为小部件相对坐标。

已弃用:4.10 

gtk_tree_view_convert_tree_to_bin_window_coords

将树坐标(树的可滚动区域中的坐标)转换为 bin_window 坐标。

已弃用:4.10 

gtk_tree_view_convert_tree_to_widget_coords

将树坐标(树的可滚动区域中的坐标)转换为小部件坐标。

已弃用:4.10 

gtk_tree_view_convert_widget_to_bin_window_coords

将小组件坐标转换为 bin_window 坐标。

已弃用:4.10 

gtk_tree_view_convert_widget_to_tree_coords

将小组件坐标转换为树坐标(tree 的完整可滚动区域)。

已弃用:4.10 

gtk_tree_view_create_row_drag_icon

创建一个 path 处行内容的 cairo_surface_t 表示形式。此图像用于拖拽图标。

已弃用:4.10 

gtk_tree_view_enable_model_drag_dest

将 tree_view 转变为自动 DND 的一个放置目标。调用此方法将将 GtkTreeView:reorderable 设为 FALSE。

已弃用:4.10 

gtk_tree_view_enable_model_drag_source

将 tree_view 转变为自动 DND 的一个拖拽源。调用此方法将将 GtkTreeView:reorderable 设为 FALSE。

已弃用:4.10 

gtk_tree_view_expand_all

递归展开 tree_view 中的所有节点。

已弃用:4.10 

gtk_tree_view_expand_row

打开此行,以便其子元素可以被看见。

已弃用:4.10 

gtk_tree_view_expand_to_path

展开 path 处的行。这还将根据需要展开 path 的所有父行。

已弃用:4.10 

gtk_tree_view_get_activate_on_single_click

获取 gtk_tree_view_set_activate_on_single_click() 设置的设置。

已弃用:4.10 

gtk_tree_view_get_background_area

填充 bin_window 坐标中 path 指定的行和 column 指定的列单元格的边界矩形。如果 path 为 NULL,或指向树中找不到的节点,则矩形的 y 和 height 区域将填充为 0。如果 column 为 NULL,则 x 和 width 区域将填充为 0。返回的矩形等同于传递给 gtk_cell_renderer_render() 的 background_area。这些背景区域平铺分布以覆盖整个 bin 窗口。与 gtk_tree_view_get_cell_area() 返回的 cell_area 形成对比,后者只返回单元格本身,不包括周围的边框和树展开区域。

已弃用:4.10 

gtk_tree_view_get_cell_area

填充 bin_window 坐标中 path 指定的行和 column 指定的列单元格的边界矩形。如果 path 为 NULL,或指向当前未显示的路径,则矩形的 y 和 height 区域将填充为 0。如果 column 为 NULL,则 x 和 width 区域将填充为 0。所有单元格矩形之和并不能覆盖整个树;例如,行之间有额外的像素。返回的矩形等同于传递给 gtk_cell_renderer_render() 的 cell_area。如果 tree_view 已经实现,此函数才有效。

已弃用:4.10 

gtk_tree_view_get_column

获取#tree_view 中给定位置的 GtkTreeViewColumn。

已弃用:4.10 

gtk_tree_view_get_columns

返回 tree_view 中当前所有 GtkTreeViewColumn 的一个 GList。返回的列表必须用 g_list_free () 来释放。

已弃用:4.10 

gtk_tree_view_get_cursor

用当前路径和焦点列填充 path 和 focus_column。如果当前尚未设置光标,则 path 将为 NULL。如果当前没有列具有焦点,则 focus_column 将为 NULL。

已弃用:4.10 

gtk_tree_view_get_dest_row_at_pos

确定给定位置的目标行。drag_x 和 drag_y 预计以小组件坐标为单位。该函数仅在 tree_view 已实现时才有意义。因此,如果 tree_view 未实现或没有模型,则此函数始终返回 FALSE。

已弃用:4.10 

gtk_tree_view_get_drag_dest_row

获取为反馈高亮显示的那行的信息。

已弃用:4.10 

gtk_tree_view_get_enable_search

返回树是否允许通过输入文本开始交互式搜索。

已弃用:4.10 

gtk_tree_view_get_enable_tree_lines

返回 tree_view 中是否绘制树线。

已弃用:4.10 

gtk_tree_view_get_expander_column

返回当前展开列的列,或者如果没有设置,则返回 NULL。此列在其旁边绘制了展开箭头。

已弃用:4.10 

gtk_tree_view_get_fixed_height_mode

返回为 tree_view 启用了固定高度模式。

已弃用:4.10 

gtk_tree_view_get_grid_lines

返回在 tree_view 中启用了的网格线。

已弃用:4.10 

gtk_tree_view_get_headers_clickable

返回是否所有的头列都可通过单击来访问。

已弃用:4.10 

gtk_tree_view_get_headers_visible

如果 tree_view 上的头都是可见的,则返回 TRUE

已弃用:4.10 

gtk_tree_view_get_hover_expand

返回是否为 tree_view 启用了悬停扩展模式。

已弃用:4.10 

gtk_tree_view_get_hover_selection

返回是否为 tree_view 启用了悬停选择模式。

已弃用:4.10 

gtk_tree_view_get_level_indentation

返回 tree_view 中子级别的额外缩进(以像素为单位)。

已弃用:4.10 

gtk_tree_view_get_model

返回 GtkTreeView 所基于的模型。如果未设置模型,则返回 NULL

已弃用:4.10 

gtk_tree_view_get_n_columns

查询给定 tree_view 中的列数。

已弃用:4.10 

gtk_tree_view_get_path_at_pos

查找以 bin_window 坐标为相对坐标的点 (x, y) 处的路径。即,xy 是相对于事件坐标的。必须使用 gtk_tree_view_convert_widget_to_bin_window_coords() 将控件相对坐标转换为窗口相对坐标。这主要用于弹出菜单等内容。如果 pathNULL,则将其填充为该点处的 GtkTreePath。应使用 gtk_tree_path_free() 释放此路径。如果 columnNULL,则将其填充为该点处的列。cell_xcell_y 返回相对于单元格背景(即传递给 gtk_cell_renderer_render() 的 background_area)的坐标。此函数只有在 tree_view 处于实现状态时才有意义。因此,如果 tree_view 未处于实现状态或没有模型,此函数始终返回 FALSE

已弃用:4.10 

gtk_tree_view_get_reorderable

检索用户是否可以通过拖放重新排列树。请参见 gtk_tree_view_set_reorderable()。

已弃用:4.10 

gtk_tree_view_get_row_separator_func

返回当前行分隔符函数。

已弃用:4.10 

gtk_tree_view_get_rubber_banding

返回是否为 tree_view 启用了橡皮筋。如果选择模式为 GTK_SELECTION_MULTIPLE,则橡皮筋将允许用户通过鼠标拖拽来选择多行。

已弃用:4.10 

gtk_tree_view_get_search_column

获取交互式搜索代码搜索的列。

已弃用:4.10 

gtk_tree_view_get_search_entry

返回当前用作 tree_view 交互式搜索输入的 GtkEntry。如果正在使用内置输入,则返回 NULL

已弃用:4.10 

gtk_tree_view_get_search_equal_func

返回当前正在使用的比较函数。

已弃用:4.10 

gtk_tree_view_get_selection

获取与 tree_view 关联的 GtkTreeSelection

已弃用:4.10 

gtk_tree_view_get_show_expanders

返回是否在 tree_view 中绘制展开器。

已弃用:4.10 

gtk_tree_view_get_tooltip_column

返回用于在 tree_view 的行上显示工具提示的 tree_view 模型的列。

已弃用:4.10 

gtk_tree_view_get_tooltip_context

此函数应在 GtkTreeView 的 ::query-tooltip 信号处理程序中使用。在信号处理程序中接收到的 xykeyboard_tip 值应原样传递给此函数,不要修改。

已弃用:4.10 

gtk_tree_view_get_visible_range

start_pathend_path 设置为第一个和最后一个可见路径。请注意,两者之间可能存在不可见路径。

已弃用:4.10 

gtk_tree_view_get_visible_rect

使用树坐标填充 visible_rect 作为缓冲区的当前可见区域。使用 gtk_tree_view_convert_tree_to_bin_window_coords() 转换为 bin_window 坐标。树坐标从树的第 0 行的 0,0 开始,并覆盖树的整个可滚动区域。

已弃用:4.10 

gtk_tree_view_insert_column

column 插入 tree_view 中的 position 处。如果 position 为 -1,则将 column 插入到末尾。如果 tree_view 启用了“fixed_height”模式,则必须将 column 的“sizing”属性设置为 GTK_TREE_VIEW_COLUMN_FIXED。

已弃用:4.10 

gtk_tree_view_insert_column_with_attributes

创建新的 GtkTreeViewColumn,并将它插入到 tree_view 中的 position 位置。如果 position 是 -1,那么新创建的列将被插入到末尾。该列将使用给出的属性进行初始化。如果启用了 tree_view 的 “fixed_height” 模式,那么新列的 sizing 属性将被设置为 GTK_TREE_VIEW_COLUMN_FIXED。

已弃用:4.10 

gtk_tree_view_insert_column_with_data_func

使用给定的单元格渲染器和 GtkTreeCellDataFunc 来设置单元格渲染器属性的便利函数,以插入新列到 GtkTreeView 中(通常使用来自模型的数据)。另请参见 gtk_tree_view_column_set_cell_data_func()、gtk_tree_view_column_pack_start()。如果启用了 tree_view 的 “fixed_height” 模式,那么新列的 “sizing” 属性将被设置为 GTK_TREE_VIEW_COLUMN_FIXED。

已弃用:4.10 

gtk_tree_view_is_blank_at_pos

确定 tree_view 中的点 (x, y) 是否为空白,即没有在该位置绘制单元格内容或展开箭头。如果是,则可以将该位置视为背景。你可能希望对点击背景进行特殊操作,例如清除当前所选内容、显示自定义上下文菜单或开始橡皮筋绑定。

已弃用:4.10 

gtk_tree_view_is_rubber_banding_active

返回当前是否正在 tree_view 中执行橡皮筋绑定操作。

已弃用:4.10 

gtk_tree_view_map_expanded_rows

在所有已展开的行上调用 func

已弃用:4.10 

gtk_tree_view_move_column_after

column 移到 base_column 的后面。如果 base_columnNULL,那么 column 将被置于第一位置。

已弃用:4.10 

gtk_tree_view_remove_column

tree_view 中移除 column

已弃用:4.10 

gtk_tree_view_row_activated

激活由 pathcolumn 确定的单元格。

已弃用:4.10 

gtk_tree_view_row_expanded

如果 tree_viewpath 指向的节点已展开,则返回 TRUE

已弃用:4.10 

gtk_tree_view_scroll_to_cell

tree_view 的对齐方式移动到由 columnpath 指定的位置。如果 columnNULL,则不会发生水平滚动。同样,如果 pathNULL,则不会发生垂直滚动。至少需要一个 columnpathNULLrow_align 确定行的放置位置,col_align 确定 column 的放置位置。预计两者都介于 0.0 和 1.0 之间。0.0 表示左/顶部对齐,1.0 表示右/底部对齐,0.5 表示居中。

已弃用:4.10 

gtk_tree_view_scroll_to_point

滚动树视图,使可见区域的左上角为 tree_xtree_y,其中 tree_xtree_y 以树坐标指定。在调用此函数之前,必须实现 tree_view。如果没有实现,那么你可能需要使用 gtk_tree_view_scroll_to_cell()。

已弃用:4.10 

gtk_tree_view_set_activate_on_single_click

导致 GtkTreeView::row-activated 信号在单击而不是双击时发出。

已弃用:4.10 

gtk_tree_view_set_column_drag_function

设置用户函数来确定拖动时某一列是否可以放下。此函数在列拖动的开始时按顺序对每对列执行调用,以确定可以在哪里放置某一列。传递至 func 的参数包括:tree_view、正在拖动的 GtkTreeViewColumn、决定放置位置的两个 GtkTreeViewColumnuser_data。如果用于放置位置的 GtkTreeViewColumn 参数中任一为 NULL,则它们指示边缘。如果 func 设置为 NULL,则 tree_view 将恢复允许所有列在任何位置都可放置的默认行为。

已弃用:4.10 

gtk_tree_view_set_cursor

将当前键盘焦点设置为 path,并将其选择。当您希望将用户的注意力集中到特定行时,此设置很有用。如果 focus_column 不是 NULL,则会将焦点赋予由它指定的列。此外,如果指定了 focus_column,并且 start_editingTRUE,则应在指定单元格中开始编辑。通常,此函数后面会跟 gtk_widget_grab_focustree_view)以赋予小工具键盘焦点。请注意,仅在已实现小工具时才能进行编辑。

已弃用:4.10 

gtk_tree_view_set_cursor_on_cell

将当前键盘焦点设置为 path,并将其选择。当您希望将用户的注意力集中到特定行时,此设置很有用。如果 focus_column 不是 NULL,则会将焦点赋予由它指定的列。如果 focus_columnfocus_cell 都不是 NULL,并且 focus_column 包含 2 个或更多可编辑或可激活的单元格,则会焦点赋予 focus_cell 指定的单元格。此外,如果指定了 focus_column,并且 start_editingTRUE,则应在指定单元格中开始编辑。通常,此函数后面会跟 gtk_widget_grab_focustree_view)以赋予小工具键盘焦点。请注意,仅在已实现小工具时才能进行编辑。

已弃用:4.10 

gtk_tree_view_set_drag_dest_row

设置突出显示以进行反馈的行。如果 pathNULL,则会移除现有突出显示。

已弃用:4.10 

gtk_tree_view_set_enable_search

如果设置了 enable_search,则用户可以输入文本以通过交互方式在树中进行搜索(有时也称为“提前键入查找”)。

已弃用:4.10 

gtk_tree_view_set_enable_tree_lines

设置是否绘制连接 tree_view 中扩展器的线条。对于列表而言,这不具有任何可见效果。

已弃用:4.10 

gtk_tree_view_set_expander_column

设置绘制扩展器箭头的列。它必须在 tree_view 中。如果 columnNULL,则扩展器箭头始终位于第一个可见列中。

已弃用:4.10 

gtk_tree_view_set_fixed_height_mode

启用或禁用 tree_view 的固定高度模式。固定高度模式通过假定所有行的行高均相等来加快 GtkTreeView 的速度。仅当所有行的高度均相等并且所有列的类型均为 GTK_TREE_VIEW_COLUMN_FIXED 时才启用此选项。

已弃用:4.10 

gtk_tree_view_set_grid_lines

设置在 tree_view 中绘制的网格线。

已弃用:4.10 

gtk_tree_view_set_headers_clickable

允许单击列标题按钮。

已弃用:4.10 

gtk_tree_view_set_headers_visible

设置页眉的可见性状态。

已弃用:4.10 

gtk_tree_view_set_hover_expand

启用或禁用 tree_view 的悬停展开模式。悬停展开功能可以让行在指针移动到其上面时展开或折叠。

已弃用:4.10 

gtk_tree_view_set_hover_selection

启用或禁用 tree_view 的悬停选择模式。悬停选择功能让选定行跟随指针。目前,此功能仅适用于选择模式 GTK_SELECTION_SINGLEGTK_SELECTION_BROWSE

已弃用:4.10 

gtk_tree_view_set_level_indentation

设置在 tree_view 中子级别在默认缩进之外使用的额外缩进量。该值应以像素为单位指定,值为 0 会禁用此功能,而在此情况下,将仅使用默认缩进。对于列表而言,这不具有任何可见效果。

已弃用:4.10 

gtk_tree_view_set_model

GtkTreeView 设置模型。如果 tree_view 已设置模型,它将在设置新模型前将旧模型移除。如果 modelNULL,它将取消设置旧模型。

已弃用:4.10 

gtk_tree_view_set_reorderable

此函数为一个实用函数,允许你重新排序支持 GtkTreeDragSourceIfaceGtkTreeDragDestIface 的模型。GtkTreeStoreGtkListStore 均支持这些。如果 reorderableTRUE,那么用户可以通过拖放行来重新排序模型。开发者可以通过连接到模型的 GtkTreeModel::row-insertedGtkTreeModel::row-deleted 信号来监听这些更改。重新排序是通过将树视图设置成一个拖放源和目的地来实现的。因此,不能出于其他任何目的在可重新排序的视图中使用拖放。

已弃用:4.10 

gtk_tree_view_set_row_separator_func

设置行分隔符函数,该函数用于确定行是否应该被绘制成分隔符。如果行分隔符函数为 NULL,则不绘制分隔符。这是默认值。

已弃用:4.10 

gtk_tree_view_set_rubber_banding

tree_view 中启用或禁用橡皮筋效果。如果选择模式为 GTK_SELECTION_MULTIPLE,橡皮筋效果将允许用户通过拖动鼠标来选择多行。

已弃用:4.10 

gtk_tree_view_set_search_column

设置 column 为当前模型中交互式搜索代码应在其内搜索的列。

已弃用:4.10 

gtk_tree_view_set_search_entry

设置交互式搜索代码将为这个 tree_view 使用的输入框。当你希望在我们的界面中始終在固定位置提供一个搜索输入框时,这很有用。为 entry 传递 NULL 将使交互式搜索代码再次使用内置弹出输入框。

已弃用:4.10 

gtk_tree_view_set_search_equal_func

设置交互式搜索功能的比较函数;注意,有点像 strcmp() 为相等返回 0,GtkTreeViewSearchEqualFunc 在匹配时返回 FALSE

已弃用:4.10 

gtk_tree_view_set_show_expanders

设置在 tree_view 中绘制和启用展开器以及缩进子行。如果禁用,那么树中将没有展开器可见,并且默认情况下将无法展开和收起行。还需要注意的是,如果隐藏了展开器,那么将禁用默认缩进。在这种情况下,你可以使用 gtk_tree_view_set_level_indentation() 来设置自定义缩进。对于列表,这不会产生任何可见效果。

已弃用:4.10 

gtk_tree_view_set_tooltip_cell

tooltip 提示区域设置成与 pathcolumncell 公有的区域。例如,如果 pathNULL,并且设置了 column,那么提示区域将被设置为 column 覆盖的全部区域。另请参阅 gtk_tooltip_set_tip_area()。

已弃用:4.10 

gtk_tree_view_set_tooltip_column

如果你计划仅在整行上使用简单的(纯文本)工具提示,你可以使用此函数让 GtkTreeView 自动为你处理这些。column 应设置为 tree_view 中的包含工具提示文本,或者 -1(表示禁用此功能)的模型中的列。

已弃用:4.10 

gtk_tree_view_set_tooltip_row

tooltip 提示区域设置成指定 path 的行所覆盖的区域。另请参阅 gtk_tree_view_set_tooltip_column() 以了解更简单的替代方案。另请参阅 gtk_tooltip_set_tip_area()。

已弃用:4.10 

gtk_tree_view_unset_rows_drag_dest

撤消 gtk_tree_view_enable_model_drag_dest() 的效果。调用此方法将 GtkTreeView:reorderable 设置为 FALSE

已弃用:4.10 

gtk_tree_view_unset_rows_drag_source

撤消 gtk_tree_view_enable_model_drag_source() 的效果。调用此方法将 GtkTreeView:reorderable 设置为 FALSE

已弃用:4.10 

GtkWidget 继承的方法 (162)

有关方法的完整列表,请参见 GtkWidget

GObject 继承的方法 (43)

有关方法的完整列表,请参见 GObject

GtkAccessible 继承的方法 (19)
gtk_accessible_announce

请求用户的屏幕阅读器播报给定的消息。

自:4.14

gtk_accessible_get_accessible_parent

为一个可访问对象检索可访问父对象。

自:4.10

gtk_accessible_get_accessible_role

检索可访问对象的可访问角色。

gtk_accessible_get_at_context

为给定的可访问对象检索实现。

自:4.10

gtk_accessible_get_bounds

查询此可访问对象的坐标和大小。

自:4.10

gtk_accessible_get_first_accessible_child

检索可访问对象的第一个可访问子对象。

自:4.10

gtk_accessible_get_next_accessible_sibling

检索可访问对象的下一个可访问同级对象。

自:4.10

gtk_accessible_get_platform_state

查询平台状态,例如焦点。

自:4.10

gtk_accessible_reset_property

将可访问属性重置为其默认值。

gtk_accessible_reset_relation

将可访问关系重置为其默认值。

gtk_accessible_reset_state

将可访问状态重置为其默认值。

gtk_accessible_set_accessible_parent

设置可访问对象的父对象和同级对象。

自:4.10

gtk_accessible_update_next_accessible_sibling

更新下一个可访问同级对象。

自:4.10

gtk_accessible_update_property

更新可访问属性的列表。

gtk_accessible_update_property_value

更新可访问属性的数组。

gtk_accessible_update_relation

更新可访问关系的列表。

gtk_accessible_update_relation_value

更新可访问关系的数组。

gtk_accessible_update_state

更新可访问状态的列表。

gtk_accessible_update_state_value

更新可访问状态的数组。

GtkBuildable 继承的方法 (1)
gtk_buildable_get_buildable_id

获取buildable对象的ID

GtkScrollable 继承的方法 (9)
gtk_scrollable_get_border

返回可滚动对象外侧的非滚动边框大小。

gtk_scrollable_get_hadjustment

检索用于水平滚动的GtkAdjustment

gtk_scrollable_get_hscroll_policy

获取水平GtkScrollablePolicy

gtk_scrollable_get_vadjustment

检索用于垂直滚动的GtkAdjustment

gtk_scrollable_get_vscroll_policy

获取垂直GtkScrollablePolicy

gtk_scrollable_set_hadjustment

设置GtkScrollable的水平调整。

gtk_scrollable_set_hscroll_policy

设置GtkScrollablePolicy

gtk_scrollable_set_vadjustment

设置GtkScrollable的垂直调整。

gtk_scrollable_set_vscroll_policy

设置GtkScrollablePolicy

属性

Gtk.TreeView:activate-on-single-click

activate-on-single-click 属性指定单击后是否会发出“row-activated”信号。

Gtk.TreeView:enable-grid-lines
无可用描述。

Gtk.TreeView:enable-search
无可用描述。

Gtk.TreeView:enable-tree-lines
无可用描述。

Gtk.TreeView:expander-column
无可用描述。

Gtk.TreeView:fixed-height-mode

将 ::fixed-height-mode 属性设置为 TRUE 会加快 GtkTreeView 的速度,因为这假设所有行的行高相同。仅当所有行的行高都相同的时候才启用此选项。更多有关 此选项的信息,请参见 gtk_tree_view_set_fixed_height_mode()

Gtk.TreeView:headers-clickable
无可用描述。

Gtk.TreeView:headers-visible
无可用描述。

Gtk.TreeView:hover-expand

启用或禁用 tree_view 的悬停展开模式。悬停展开功能可以让行在指针移动到其上面时展开或折叠。

Gtk.TreeView:hover-selection

启用或禁用 tree_view 的悬停选择模式。悬停选择功能让选定行跟随指针。目前,此功能仅适用于选择模式 GTK_SELECTION_SINGLEGTK_SELECTION_BROWSE

Gtk.TreeView:level-indentation

每一级的额外缩进。

Gtk.TreeView:model
无可用描述。

Gtk.TreeView:reorderable
无可用描述。

Gtk.TreeView:rubber-banding
无可用描述。

Gtk.TreeView:search-column
无可用描述。

Gtk.TreeView:show-expanders

如果该视图有展开器,则为 TRUE

Gtk.TreeView:tooltip-column
无可用描述。

GtkWidget (34) 继承的属性
Gtk.Widget:can-focus

小组件或其任何后代是否可以接受输入焦点。

Gtk.Widget:can-target

小组件是否可以接收指针事件。

Gtk.Widget:css-classes

应用于此小组件的 CSS 类别列表。

Gtk.Widget:css-name

CSS 树中此小组件的名称。

Gtk.Widget:cursor

widget 用于的光标。

Gtk.Widget:focus-on-click

用鼠标单击小组件时,小组件是否应获取焦点。

Gtk.Widget:focusable

此小组件本身是否将接受输入焦点。

Gtk.Widget:halign

如果小组件获得额外的空间,则如何分配水平空间。

Gtk.Widget:has-default

小组件是否是默认小组件。

Gtk.Widget:has-focus

小组件是否具有输入焦点。

Gtk.Widget:has-tooltip

启用或禁用 widgetGtkWidget::query-tooltip 信号的发射。

Gtk.Widget:height-request

针对小组件的高度请求进行重写。

Gtk.Widget:hexpand

是否水平扩展。

Gtk.Widget:hexpand-set

是否使用 hexpand 属性。

Gtk.Widget:layout-manager

要用于计算小组件的首选大小以及分配其子组件的 GtkLayoutManager 实例。

Gtk.Widget:margin-bottom

小组件底部边距。

Gtk.Widget:margin-end

水平方向上小组件结尾处边距。

Gtk.Widget:margin-start

水平方向上小组件开始处边距。

Gtk.Widget:margin-top

小组件顶部边距。

Gtk.Widget:name

小组件的名称。

Gtk.Widget:opacity

小组件的请求的不透明度。

Gtk.Widget:overflow

如何处理小组件内容区域外部的内容。

Gtk.Widget:parent

此小组件的父小组件。

Gtk.Widget:receives-default

在获取焦点时,小组件是否将收到默认操作。

Gtk.Widget:root

包含此小组件的小组件树的 GtkRoot 小组件。

Gtk.Widget:scale-factor

小组件的比例因子。

Gtk.Widget:sensitive

小组件是否响应输入。

Gtk.Widget:tooltip-markup

将工具提示的文本设置为给定的字符串,该字符串用 Pango 标记标记。

Gtk.Widget:tooltip-text

将工具提示的文本设置为给定的字符串。

Gtk.Widget:valign

如果小组件获得额外的空间,则如何分配垂直空间。

Gtk.Widget:vexpand

是否垂直扩展。

Gtk.Widget:vexpand-set

是否使用 vexpand 属性。

Gtk.Widget:visible

小组件是否可见。

Gtk.Widget:width-request

针对小组件的宽度请求进行重写。

GtkAccessible (1) 继承的属性
GtkAccessible:accessible-role

给定 GtkAccessible 实现的可访问角色。

GtkScrollable (4) 继承的属性
GtkScrollable:hadjustment

可滚动小组件的水平 GtkAdjustment

GtkScrollable:hscroll-policy

确定何时应开始水平滚动。

GtkScrollable:vadjustment

可滚动小组件的垂直 GtkAdjustment

GtkScrollable:vscroll-policy

确定何时应开始垂直滚动。

信号

Gtk.TreeView::columns-changed

树视图的列数已更改。

Gtk.TreeView::cursor-changed

光标(焦点单元格)的位置已更改。

Gtk.TreeView::move-cursor

GtkTreeView::move-cursor 信号是 [键绑定信号]GtkSignalAction,在用户按下任一光标键时触发。

Gtk.TreeView::row-activated

调用 gtk_tree_view_row_activated() 方法时触发“row-activated”信号。

Gtk.TreeView::row-collapsed

给定行已折叠(隐藏子节点)。

Gtk.TreeView::row-expanded

给定行已展开(显示子节点)。

Gtk.TreeView::select-all
无可用描述。

Gtk.TreeView::select-cursor-row
无可用描述。

Gtk.TreeView::test-collapse-row

给定行即将折叠(隐藏其子节点)。如果您需要控制各个行的可折叠性,请使用此信号。

Gtk.TreeView::test-expand-row

给定行即将展开(显示其子节点)。如果您需要控制各个行的可展开性,请使用此信号。

Gtk.TreeView::toggle-cursor-row
无可用描述。

Gtk.TreeView::unselect-all
无可用描述。

GtkWidget 继承的信号 (13)
GtkWidget::destroy

所有小部件引用持有者都会释放其持有的引用并触发信号。

GtkWidget::direction-changed

小部件文本方向发生更改时触发。

GtkWidget::hide

widget 隐藏时触发。

GtkWidget::keynav-failed

键盘导航失败时触发。

GtkWidget::map

widget 即将映射时触发。

GtkWidget::mnemonic-activate

通过助记符激活小部件时触发。

GtkWidget::move-focus

移动焦点时触发。

GtkWidget::query-tooltip

小部件的工具提示即将显示时触发。

GtkWidget::realize

widgetGdkSurface 关联时触发。

GtkWidget::show

widget 显示时触发。

GtkWidget::state-flags-changed

小部件状态发生更改时触发。

GtkWidget::unmap

widget 即将取消映射时触发。

GtkWidget::unrealize

widget 关联的 GdkSurface 被销毁时触发。

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

通过 g_object_set_property()、g_object_set() 等方法设置对象的某个属性的值时触发 notify 信号。

类结构

struct GtkTreeViewClass {
  GtkWidgetClass parent_class;
  void (* row_activated) (
    GtkTreeView* tree_view,
    GtkTreePath* path,
    GtkTreeViewColumn* column
  );
  gboolean (* test_expand_row) (
    GtkTreeView* tree_view,
    GtkTreeIter* iter,
    GtkTreePath* path
  );
  gboolean (* test_collapse_row) (
    GtkTreeView* tree_view,
    GtkTreeIter* iter,
    GtkTreePath* path
  );
  void (* row_expanded) (
    GtkTreeView* tree_view,
    GtkTreeIter* iter,
    GtkTreePath* path
  );
  void (* row_collapsed) (
    GtkTreeView* tree_view,
    GtkTreeIter* iter,
    GtkTreePath* path
  );
  void (* columns_changed) (
    GtkTreeView* tree_view
  );
  void (* cursor_changed) (
    GtkTreeView* tree_view
  );
  gboolean (* move_cursor) (
    GtkTreeView* tree_view,
    GtkMovementStep step,
    int count,
    gboolean extend,
    gboolean modify
  );
  gboolean (* select_all) (
    GtkTreeView* tree_view
  );
  gboolean (* unselect_all) (
    GtkTreeView* tree_view
  );
  gboolean (* select_cursor_row) (
    GtkTreeView* tree_view,
    gboolean start_editing
  );
  gboolean (* toggle_cursor_row) (
    GtkTreeView* tree_view
  );
  gboolean (* expand_collapse_cursor_row) (
    GtkTreeView* tree_view,
    gboolean logical,
    gboolean expand,
    gboolean open_all
  );
  gboolean (* select_cursor_parent) (
    GtkTreeView* tree_view
  );
  gboolean (* start_interactive_search) (
    GtkTreeView* tree_view
  );
  
}

无可用描述。

类成员
parent_class: GtkWidgetClass

无可用描述。

row_activated: void (* row_activated) ( GtkTreeView* tree_view, GtkTreePath* path, GtkTreeViewColumn* column )

无可用描述。

test_expand_row: gboolean (* test_expand_row) ( GtkTreeView* tree_view, GtkTreeIter* iter, GtkTreePath* path )

无可用描述。

test_collapse_row: gboolean (* test_collapse_row) ( GtkTreeView* tree_view, GtkTreeIter* iter, GtkTreePath* path )

无可用描述。

row_expanded: void (* row_expanded) ( GtkTreeView* tree_view, GtkTreeIter* iter, GtkTreePath* path )

无可用描述。

row_collapsed: void (* row_collapsed) ( GtkTreeView* tree_view, GtkTreeIter* iter, GtkTreePath* path )

无可用描述。

columns_changed: void (* columns_changed) ( GtkTreeView* tree_view )

无可用描述。

cursor_changed: void (* cursor_changed) ( GtkTreeView* tree_view )

无可用描述。

move_cursor: gboolean (* move_cursor) ( GtkTreeView* tree_view, GtkMovementStep step, int count, gboolean extend, gboolean modify )

无可用描述。

select_all: gboolean (* select_all) ( GtkTreeView* tree_view )

无可用描述。

unselect_all: gboolean (* unselect_all) ( GtkTreeView* tree_view )

无可用描述。

select_cursor_row: gboolean (* select_cursor_row) ( GtkTreeView* tree_view, gboolean start_editing )

无可用描述。

toggle_cursor_row: gboolean (* toggle_cursor_row) ( GtkTreeView* tree_view )

无可用描述。

expand_collapse_cursor_row: gboolean (* expand_collapse_cursor_row) ( GtkTreeView* tree_view, gboolean logical, gboolean expand, gboolean open_all )

无可用描述。

select_cursor_parent: gboolean (* select_cursor_parent) ( GtkTreeView* tree_view )

无可用描述。

start_interactive_search: gboolean (* start_interactive_search) ( GtkTreeView* tree_view )

无可用描述。

虚拟方法

Gtk.TreeViewClass.move_cursor
无可用描述。

Gtk.TreeViewClass.row_activated

激活由 pathcolumn 确定的单元格。

已弃用:4.10 

Gtk.TreeViewClass.row_collapsed
无可用描述。

Gtk.TreeViewClass.row_expanded
无可用描述。

Gtk.TreeViewClass.select_all
无可用描述。

Gtk.TreeViewClass.unselect_all
无可用描述。