GtkBox

描述 [src]

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

将子部件排列成一行或一列。

An example GtkBox

是行还是列取决于其 GtkOrientable:orientation 属性的值。在另一个维度中,所有子元素都被分配相同的大小。子元素上的 GtkWidget:halignGtkWidget:valign 属性可以用来影响它们的分配。

反复调用 gtk_box_append() 从头到尾将部件打包到 GtkBox 中。使用 gtk_box_remove()GtkBox 中移除部件。gtk_box_insert_child_after() 可用于在特定位置添加子元素。

使用 gtk_box_set_homogeneous() 来指定 GtkBox 的所有子元素是否强制获得相同数量的空间。

使用 gtk_box_set_spacing() 来确定在 GtkBox 中所有子元素之间放置的最小空间。请注意,在子元素之间添加了间距。

使用 gtk_box_reorder_child_after() 将子元素移动到框中的其他位置。

CSS 节点

GtkBox 使用单个具有名称为 box 的 CSS 节点。

辅助功能

GTK 4.10 之前,GtkBox 使用 GTK_ACCESSIBLE_ROLE_GROUP 角色。

GTK 4.12 开始,GtkBox 使用 GTK_ACCESSIBLE_ROLE_GENERIC 角色。

层次结构

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

构造函数

gtk_box_new

创建新的框。

实例方法

gtk_box_append

在最后添加子元素。

gtk_box_get_baseline_child

获取通过 gtk_box_set_baseline_child() 设置的值。

since: 4.12

gtk_box_get_baseline_position

获取通过 gtk_box_set_baseline_position() 设置的值。

gtk_box_get_homogeneous

返回容器是否为同质的。

gtk_box_get_spacing

获取通过 gtk_box_set_spacing() 设置的值。

gtk_box_insert_child_after

将子项插入到特定位置。

gtk_box_prepend

在开始位置添加子项。

gtk_box_remove

从容器中移除子项小部件。

gtk_box_reorder_child_after

将子项移动到其他位置。

gtk_box_set_baseline_child

设置容器的基线子项。

since: 4.12

gtk_box_set_baseline_position

设置容器的基线位置。

gtk_box_set_homogeneous

设置容器中是否为所有子项赋予相等的空间。

gtk_box_set_spacing

设置子项之间放置的像素数。

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

GtkOrientable (2) 继承的方法
gtk_orientable_get_orientation

检索 orientable 的方向。

gtk_orientable_set_orientation

设置 orientable 的方向。

属性

Gtk.Box:baseline-child

确定基线的子项位置。

since: 4.12

Gtk.Box:baseline-position

当有额外空间时如何定位基线对齐的小部件。

Gtk.Box:homogeneous

子项是否应全部具有相同大小。

Gtk.Box:spacing

子项之间的空间量。

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 实现的可访问角色。

GtkOrientable(1)继承的属性
GtkOrientable:orientation

可定向的方向。

信号

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

信号指示 Widget 的所有持有者应该释放他们持有的引用。

GtkWidget::direction-changed

当 Widget 的文本方向发生改变时触发。

GtkWidget::hide

widget 被隐藏时触发。

GtkWidget::keynav-failed

如果键盘导航失败触发。

GtkWidget::map

widget 将被绘制时触发。

GtkWidget::mnemonic-activate

当 Widget 通过助记符激活时触发。

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() 等等设置时,会发出此通知信号。

类结构

struct GtkBoxClass {
  GtkWidgetClass parent_class;
  
}

无可用描述。

类成员
parent_class: GtkWidgetClass

父 类。