类
GtkBox
描述 [src]
class Gtk.Box : Gtk.Widget
implements Gtk.Accessible, Gtk.Buildable, Gtk.ConstraintTarget, Gtk.Orientable {
/* No available fields */
}
将子部件排列成一行或一列。
是行还是列取决于其 GtkOrientable:orientation
属性的值。在另一个维度中,所有子元素都被分配相同的大小。子元素上的 GtkWidget:halign
和 GtkWidget: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
角色。
实例方法
从 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) 继承的方法
从 GtkOrientable (2) 继承的方法
属性
从 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)继承的属性
从 GtkOrientable(1)继承的属性
信号
从 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
当widget
与GdkSurface
关联时发出。
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() 等等设置时,会发出此通知信号。