GtkFrame

说明 [src]

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

GtkFrame 是一个围绕其子项添加装饰相框和可选 标签的小控件。

An example GtkFrame

如果存在,该标签将绘制在相框顶部边缘的内部。标签的水平位置可以通过 gtk_frame_set_label_align() 来控制。

GtkFrame 剪切其子项。您可以用它向小控件添加圆角,但请注意它也会切掉 阴影。

GtkFrame 作为 GtkBuildable

GtkFramebuffer 实现的 GtkBuildable 接口通过将一个子项置于标签位置(通过将某个 <child> 元素的 “type” 属性指定为 “label”)来实现。可以通过不指定 <child> type 属性来指定常规内容子项。

具有 GtkFrame 的 UI 定义片段示例

<object class="GtkFrame">
  <child type="label">
    <object class="GtkLabel" id="frame_label"/>
  </child>
  <child>
    <object class="GtkEntry" id="frame_content"/>
  </child>
</object>

CSS 节点

frame
├── <label widget>
╰── <child>

GtkFrame 拥有一个名为 “frame” 的主要 CSS 节点,用于绘制可见边框。您可以使用在此 节点上的 “border-style” 这样的 CSS 属性来设置边框的外观。

无障碍

GtkFrame 使用 GTK_ACCESSIBLE_ROLE_GROUP 角色。

层次结构

hierarchy this GtkFrame 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_frame_new

创建新的 GtkFrame,带有可选标签 label

实例方法

gtk_frame_get_child

获取 frame 的子控件。

gtk_frame_get_label

返回相框的标签 文本。

gtk_frame_get_label_align

检索相框 标签的 X 对齐方式。

gtk_frame_get_label_widget

检索该 相框的标签小控件。

gtk_frame_set_child

设置 frame 的子控件。

gtk_frame_set_label

创建一个带有 label 的新 GtkLabel 并将其设为相框的标签 小控件。

gtk_frame_set_label_align

设置相框小控件 标签的 X 对齐方式。

gtk_frame_set_label_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.Frame:child

子 窗口小部件。

Gtk.Frame:label

框架 标签的文本。

Gtk.Frame:label-widget

替换常规框架 标签显示的窗口小部件。

Gtk.Frame:label-xalign

 标签的水平对齐方式。

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)继承的属性
GtkAccessible:accessible-role

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

信号

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

`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()` 等函数设置时,将在该对象上发出 notify 信号。

类结构

struct GtkFrameClass {
  GtkWidgetClass parent_class;
  void (* compute_child_allocation) (
    GtkFrame* frame,
    GtkAllocation* allocation
  );
  
}

没有可用的描述。

类成员
parent_class: GtkWidgetClass

父类。

compute_child_allocation: void (* compute_child_allocation) ( GtkFrame* frame, GtkAllocation* allocation )

没有可用的描述。

虚拟方法

Gtk.FrameClass.compute_child_allocation
没有可用的描述。