类
GtkIconView
已弃用：4.10
说明 [src]
final class Gtk.IconView : Gtk.Widget
implements Gtk.Accessible, Gtk.Buildable, Gtk.CellLayout, Gtk.ConstraintTarget, Gtk.Scrollable {
/* No available fields */
}GtkIconView 是一个小工具，以图标网格的形式显示数据。
GtkIconView 为 GtkTreeModel 提供了一个替换视图。它以网格形式显示模型中的图标和标签。类似于 GtkTreeView，它允许选择一个或多个条目（视选择模式而定，参见 gtk_icon_view_set_selection_mode()）。除了可以通过箭头键选择，GtkIconView 还支持用鼠标拖拽进行范围选择。
请注意，如果树模型由实际的树存储库（与平面列表相反，其中与图标的映射是明显的）提供支持，则 GtkIconView 将仅显示树的第一层，并忽略该树的分支。
CSS 节点
iconview.view
╰── [rubberband]
GtkIconView 有一个名为 iconview 的 CSS 节点以及样式类 .view。对于范围选择，使用了带有名称 rubberband 的子节点。
已弃用：4.10
请改用 GtkGridView。
实例方法
gtk_icon_view_enable_model_drag_dest
将 `icon_view` 变成自动 DND 的目标位置。调用该方法可将 `GtkIconView`：reorderable 设置为 `FALSE`。
已弃用：4.10
gtk_icon_view_enable_model_drag_source
将 `icon_view` 变成自动 DND 的拖动源。调用该方法可将 `GtkIconView`：reorderable 设置为 `FALSE`。
已弃用：4.10
gtk_icon_view_get_activate_on_single_click
获取 gtk_icon_view_set_activate_on_single_click() 设置的设置。
已弃用：4.10
gtk_icon_view_get_cell_rect
用小组件坐标填充由 `path` 和 `cell` 指定的单元格的边界矩形。如果 `cell` 为 `NULL`，则使用主单元格区域。
已弃用：4.10
gtk_icon_view_get_cursor
用当前光标路径和单元格填充 `path` 和 `cell`。如果光标当前未设置，则 `path` 将变为 `NULL`。如果当前没有任何单元格具有焦点，则 `cell` 将变为 `NULL`。
已弃用：4.10
gtk_icon_view_get_selected_items
创建所有选定项目的路径列表。此外，如果你打算在此函数调用后修改模型，则可能需要将返回的列表转换为 `GtkTreeRowReferences` 列表。为此，可以使用 gtk_tree_row_reference_new()。
已弃用：4.10
gtk_icon_view_get_tooltip_context
此函数应在 GtkIconView 的 GtkWidget::query-tooltip 信号处理程序中使用。应当将信号处理程序中接收到的 x、y 和 keyboard_tip 值传递给此函数，而不用修改。
已弃用：4.10
gtk_icon_view_scroll_to_path
将 icon_view 的对齐方式移动到由 path 指定的位置。row_align 确定放置行的位置，col_align 确定放置 column 的位置。二者都应介于 0.0 和 1.0 之间。0.0 表示左对齐/顶部对齐，1.0 表示右对齐/底部对齐，0.5 表示居中。
已弃用：4.10
gtk_icon_view_set_cursor
将当前键盘焦点设置为 path，并选择它。当您希望将用户的注意力集中在某个特定项目上时，这很有用。如果 cell 不为 NULL，则焦点会赋予由其指定的单元格。此外，如果 start_editing 为 TRUE，则应该在指定的单元格中开始编辑。
已弃用：4.10
gtk_icon_view_set_item_width
设置 ::item-width 属性，该属性指定用于每个项目的宽度。如果将其设置为 -1，则图标视图将自动确定合适的项目大小。
已弃用：4.10
gtk_icon_view_set_markup_column
将 icon_view 的标记信息的列设置为 column。标记列必须为 G_TYPE_STRING 类型。如果标记列设置为某项，则它将覆盖由 gtk_icon_view_set_text_column() 设置的文本列。
已弃用：4.10
gtk_icon_view_set_model
为 GtkIconView 设置模型。如果 icon_view 已经设置了模型，则它将在设置新模型之前移除该模型。如果 model 为 NULL，则它将取消设置旧模型。
已弃用：4.10
gtk_icon_view_set_pixbuf_column
将 icon_view 中显示像素缓冲区的列设置为 column。像素缓冲区列中必须是 TYPE_PIXBUF 类型的 GDK。
已弃用：4.10
gtk_icon_view_set_reorderable
这个函数是一个便捷函数，它允许你重新排列支持 GtkTreeDragSourceIface 和 GtkTreeDragDestIface 的模式。GtkTreeStore 和 GtkListStore 都支持这些模式。如果 reorderable 为 TRUE，则用户可以通过拖放行来重新排列模式。开发人员可以通过连接到该模式的 row_inserted 和 row_deleted 信号来侦听这些改变。通过将该图标视图设置为一个拖动源和目标来实现重新排列。因此，对于任何其他目的，都不可以在可重新排列的视图中使用拖放。
已弃用：4.10
gtk_icon_view_set_text_column
将 icon_view 中显示文本的列设置为 column。文本列中必须是 G_TYPE_STRING 类型的 TYPE。
已弃用：4.10
gtk_icon_view_set_tooltip_cell
将 tooltip 的提示区域设置为在 path 所指向的条目中 cell 所占用的区域。另请参阅 gtk_tooltip_set_tip_area()。
已弃用：4.10
gtk_icon_view_set_tooltip_column
如果你仅计划在完整条目中显示简单的（纯文本）工具提示，则可以使用该函数让 GtkIconView 自动为你处理这些信息。column 应设置为在 icon_view 的模型中包含工具提示文本的列，或者设置为 -1 以禁用此功能。
已弃用：4.10
gtk_icon_view_set_tooltip_item
将 tooltip 的提示区域设置为 path 处的条目覆盖的区域。另请参阅 gtk_icon_view_set_tooltip_column() 以了解一个更简单的备用方法。另请参阅 gtk_tooltip_set_tip_area()。
已弃用：4.10
gtk_icon_view_unset_model_drag_dest
撤消 gtk_icon_view_enable_model_drag_dest() 的效果。调用这个方法将 GtkIconView:reorderable 设置为 FALSE。
已弃用：4.10
gtk_icon_view_unset_model_drag_source
撤消 gtk_icon_view_enable_model_drag_source() 的效果。调用这个方法将 GtkIconView:reorderable 设置为 FALSE。
已弃用：4.10
从 GtkAccessible 继承的方法 (19)
gtk_accessible_announce
请求用户的屏幕阅读器播报给定的消息。
since: 4.14
gtk_accessible_get_accessible_parent
检索一个可访问对象的父可访问对象。
since: 4.10
gtk_accessible_get_accessible_role
检索一个可访问对象的父可访问角色。
gtk_accessible_get_at_context
检索给定可访问对象的实现。
since: 4.10
gtk_accessible_get_bounds
查询这些可访问对象的坐标和尺寸。
since: 4.10
gtk_accessible_get_first_accessible_child
检索可访问对象的第一个可访问子项。
since: 4.10
gtk_accessible_get_next_accessible_sibling
检索可访问对象的下一个可访问同级项。
since: 4.10
gtk_accessible_get_platform_state
查询平台状态，例如焦点。
since: 4.10
gtk_accessible_reset_property
将可访问属性重置为其默认值。
gtk_accessible_reset_relation
将可访问关系重置为其默认值。
gtk_accessible_reset_state
将可访问状态重置为其默认值。
gtk_accessible_set_accessible_parent
设置可访问对象的父级和同级项。
since: 4.10
gtk_accessible_update_next_accessible_sibling
更新下一个可访问同级项。
since: 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)
继承自 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，如果在 GtkCellArea 上调用则可能是 cell_layout，或者如果 cell_layout 不使用 GtkCellArea，则可能是 NULL。
已弃用：4.10
gtk_cell_layout_get_cells
返回已添加到 cell_layout 的单元格渲染器。
已弃用：4.10
gtk_cell_layout_pack_end
将 cell 添加到 cell_layout 的末尾。如果 expand 为 FALSE，则为 cell 分配的空间不超过其需要。任何未使用的空间将在 expand 为 TRUE 的单元格之间平均分配。
已弃用：4.10
gtk_cell_layout_pack_start
将 cell 封装到 cell_layout 的开头。如果 expand 为 FALSE，则为 cell 分配的空间不超过其需要。任何未使用的空间将在 expand 为 TRUE 的单元格之间平均分配。
已弃用：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
继承自 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.IconView:activate-on-single-click
activate-on-single-click 属性指定在单击一次之后是否将发出 “item-activated” 信号。
Gtk.IconView:markup-column
::markup-column 属性包含包含要显示的标记信息的模型列的编号。标记列的类型必须为 G_TYPE_STRING。如果此属性和 :text-column 属性都设置为列号，则会覆盖文本列。如果两者都设置为 -1，则不显示文本。
Gtk.IconView:pixbuf-column
::pixbuf-column 属性包含包含所显示的 pixbuf 的模型列的编号。pixbuf 列的类型必须为 GDK_TYPE_PIXBUF。将此属性设置为 -1 将关闭 pixbuf 的显示。
Gtk.IconView:selection-mode
::selection-mode 属性指定图标视图的选择模式。如果模式为 GTK_SELECTION_MULTIPLE，则启用橡皮筋选择，对于其他模式，则只能进行键盘选择。
Gtk.IconView:text-column
::text-column 属性包含包含要显示的文本的模型列的编号。文本列的类型必须为 G_TYPE_STRING。如果此属性和 :markup-column 属性都设置为 -1，则不显示文本。
从 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
在 widget 上启用或禁用 GtkWidget::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）继承的属性
从 GtkScrollable（4）继承的属性
GtkScrollable:hadjustment
可滚动控件的水平 GtkAdjustment。
GtkScrollable:hscroll-policy
确定何时开始水平滚动。
GtkScrollable:vadjustment
可滚动控件的垂直 GtkAdjustment。
GtkScrollable:vscroll-policy
确定何时开始垂直滚动。
信号
Gtk.IconView::item-activated
当调用方法 gtk_icon_view_item_activated()，当用户双击具有“activate-on-single-click”属性设置的项目，或当用户单击具有“activate-on-single-click”属性设置的项目时发出 ::item-activated 信号。 TRUE。当选择不可编辑项目并按下以下键之一时也会发出：空格、回车或输入。
从 GtkWidget（13）继承的信号
GtkWidget::destroy
发出信号，指示控件引用的所有持有人都应该释放他们持有的引用。
GtkWidget::direction-changed
控件的文本方向更改时发出。
GtkWidget::hide
小部件隐藏时触发。
GtkWidget::keynav-failed
键盘导航失败时触发。
GtkWidget::map
小部件将要映射时触发。
GtkWidget::mnemonic-activate
通过助记符激活小部件时触发。
GtkWidget::move-focus
焦点移动时触发。
GtkWidget::query-tooltip
小部件的工具提示即将显示时触发。
GtkWidget::realize
小部件与一个 GdkSurface 关联时触发。
GtkWidget::show
小部件显示时触发。
GtkWidget::state-flags-changed
小部件状态变化时触发。
GtkWidget::unmap
小部件将要取消映射时触发。
GtkWidget::unrealize
与小部件关联的 GdkSurface 销毁时触发。
GObject 继承的信号 (1)
GObject::notify
当对象的其中一个属性通过 g_object_set_property()、g_object_set() 等设置值时，将在对象上触发 notify 信号。