Gtk叠加

描述 [src]

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

GtkOverlay 是一个容器,它包含一个主子组件,它可以在上面放置“叠加”小组件。

An example GtkOverlay

每个叠加小组件的位置由其 GtkWidget:halignGtkWidget:valign 属性确定。例如,对齐方式都设置为 GTK_ALIGN_START 的小组件将放置在 GtkOverlay 容器的左上角,而将 halign 设置为 GTK_ALIGN_CENTER 且 valign 设置为 GTK_ALIGN_END 的叠加将放置在 GtkOverlay 的底部边缘,水平居中。可以通过将子组件的边距属性设置为非零值来调整位置。

可以通过连接 GtkOverlay::get-child-position 信号来实现叠加的更复杂放置。

叠加的最小和自然大小与其主子组件的大小相同。在测量这些首选大小时不考虑叠加子组件的大小。

作为 GtkBuildable 的 GtkOverlay

GtkOverlay 作为 GtkBuildable 的实现方法支持通过指定一个 <child> 元素的“类型”属性为“叠加”来将子组件放置为叠加。

CSS 节点

GtkOverlay 有一个名称为“叠加”的 CSS 节点。对其位置在边缘上的叠加子组件设置样式 class“左”、“右”、“上”和/或“下”,具体取决于它们的位置。

层次

hierarchy this GtkOverlay implements_0 GtkAccessible this--implements_0 implements_1 GtkBuildable this--implements_1 implements_2 GtkConstraintTarget this--implements_2 ancestor_0 GtkWidget ancestor_0--this ancestor_1 GInitiallyUnowned ancestor_1--ancestor_0 ancestor_2 GObject ancestor_2--ancestor_1

构造函数

gtk_overlay_new

创建一个新的 GtkOverlay

实例方法

gtk_overlay_add_overlay

widget 添加到 overlay

gtk_overlay_get_child

获取 overlay 的子组件小组件。

gtk_overlay_get_clip_overlay

获取是否应在父组件中剪辑 widget

gtk_overlay_get_measure_overlay

获取是否在测量 overlay 是将 widget 的大小包含在内。

gtk_overlay_remove_overlay

移除一个使用 gtk_overlay_add_overlay() 添加的叠加。

gtk_overlay_set_child

设置 overlay 的子组件小组件。

gtk_overlay_set_clip_overlay

设置是否应在父组件中剪辑 widget

gtk_overlay_set_measure_overlay

设置是否在 overlay 的测量尺寸中包含 widget

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

属性

Gtk.Overlay:child

主子对象 widget。

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

重写 widget 的高度请求。

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

信号

Gtk.Overlay::get-child-position

发出以确定任一叠加子小控件的位置和大小。

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

Widget 状态发生改变时发出。

GtkWidget::unmap

widget将要取消映射时发出。

GtkWidget::unrealize

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

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

当属性通过 g_object_set_property()、g_object_set() 等其中一种方式设置值时,在对象上发出通知信号。