GtkInscription

since:4.8

说明 [源]

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

GtkInscription 是一个在预定义区域中显示文本的小组件。

你可能希望改为使用 GtkLabel,因为此小组件仅适用于少数用例。设想的主要场景是在 GtkColumnView 等列表中使用。

虽然 GtkLabel 会根据显示的文本调整自身大小,但 GtkInscription 会获得一个大小,并将给定的文本按其可能的方式书写到该空间中。

此小组件的用户应注意规划文本不能完全适合分配空间的常见情况下的行为。

CSS 节点

GtkInscription 有一个名称为 label 的单个 CSS 节点。

自 4.8 起可用

层次

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

构造器

gtk_inscription_new

使用给定的文本创建新的 GtkInscription

since:4.8

实例方法

gtk_inscription_get_attributes

获取碑文属性列表。

since:4.8

gtk_inscription_get_min_chars

获取碑文min-chars

since:4.8

gtk_inscription_get_min_lines

获取碑文min-lines

since:4.8

gtk_inscription_get_nat_chars

获取碑文nat-chars

since:4.8

gtk_inscription_get_nat_lines

获取碑文的nat-lines

since:4.8

gtk_inscription_get_text

获取要显示的文本。

since:4.8

gtk_inscription_get_text_overflow

获取碑文的溢出方法。

since:4.8

gtk_inscription_get_wrap_mode

返回碑文使用的换行模式。

since:4.8

gtk_inscription_get_xalign

获取碑文的 xalign

since:4.8

gtk_inscription_get_yalign

获取碑文的 yalign

since:4.8

gtk_inscription_set_attributes

将属性应用于碑文文本。

since:4.8

gtk_inscription_set_markup

设置要显示的文本和属性的实用程序函数。

since:4.8

gtk_inscription_set_min_chars

设置碑文的 min-chars

since:4.8

gtk_inscription_set_min_lines

设置碑文的 min-lines

since:4.8

gtk_inscription_set_nat_chars

设置碑文的 nat-chars

since:4.8

gtk_inscription_set_nat_lines

设置碑文的 nat-lines

since:4.8

gtk_inscription_set_text

设置要显示的文本。

since:4.8

gtk_inscription_set_text_overflow

设置文本不合适时应执行的操作。

since:4.8

gtk_inscription_set_wrap_mode

控制换行的方式。

since:4.8

gtk_inscription_set_xalign

设置碑文的 xalign

since:4.8

gtk_inscription_set_yalign

设置碑文的 yalign

since:4.8

GtkWidget 继承的方法(162)

请参阅GtkWidget,了解方法的完整列表。

GObject 继承的方法(43)

请参阅GObject,了解方法的完整列表。

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

更新辅助状态数组。

GtkAccessibleText 继承的方法(3)
gtk_accessible_text_update_caret_position

更新插入符号的位置。

since: 4.14

gtk_accessible_text_update_contents

通知辅助技术内容发生变化。

since: 4.14

gtk_accessible_text_update_selection_bound

更新选择范围。

since: 4.14

GtkBuildable 继承的方法(1)
gtk_buildable_get_buildable_id

获取 buildable 对象的 ID

属性

Gtk.Inscription:attributes

应用于铭文文本的样式属性列表。

since:4.8

Gtk.Inscription:markup

实用属性,用于同时设置 GtkInscription:textGtkInscription:attributes 属性,主要用于 GtkBuilder ui 文件,以便轻松提供翻译支持和绑定。

since:4.8

Gtk.Inscription:min-chars

理想情况下铭文可以容纳的字符数。

since:4.8

Gtk.Inscription:min-lines

铭文可以容纳的最小行数。

since:4.8

Gtk.Inscription:nat-chars

铭文可以容纳的理想字符数。

since:4.8

Gtk.Inscription:nat-lines

铭文可以容纳的理想行数。

since:4.8

Gtk.Inscription:text

显示的文本。

since:4.8

Gtk.Inscription:text-overflow

用于文本的溢出方法。

since:4.8

Gtk.Inscription:wrap-mode

控制如何进行换行。

since:4.8

Gtk.Inscription:xalign

在已分配大小中文本的水平对齐方式。

since:4.8

Gtk.Inscription:yalign

在已分配大小中文本的垂直对齐方式。

since:4.8

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

类结构

struct GtkInscriptionClass {
  GtkWidgetClass parent_class;
  
}

无可用描述。

类成员
parent_class: GtkWidgetClass

无可用描述。