类

GtkText

描述 [src]

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

单行文本条目。

GtkText 是单行文本编辑的通用实现，在 GtkEntry、GtkPasswordEntry、GtkSpinButton 和其他小组件中共享。在所有这些中，GtkText 实例用作 GtkEditable 实现的委托。

默认情况下支持大量键绑定。如果输入的文本超出了小组件的分配，小组件将滚动，以便光标位置可见。

使用输入框输入密码和其他敏感信息时，可以使用 gtk_text_set_visibility() 将其置于“密码模式”。在此模式下，输入的文本使用“不可见”字符显示。默认情况下，GTK 会选取当前字体中可用的最佳不可见字符，但可以使用 gtk_text_set_invisible_char() 进行更改。

如果希望在输入框中添加图标或进度显示，请查看 GtkEntry。针对更专业化的用例还有其他选择，例如 GtkSearchEntry。

如果需要多行可编辑文本，请使用 GtkTextView。

快捷方式和手势

GtkText 支持以下键盘快捷方式

Shift+F10 或 Menu 打开上下文菜单。
Ctrl+A 或 Ctrl+/ 选择全部文本。
Ctrl+Shift+A 或 Ctrl+\ 取消选择所有内容。
Ctrl+Z 撤消上一次修改。
Ctrl+Y 或 Ctrl+Shift+Z 重做上一次撤消的修改。
Ctrl+Shift 设置文本方向。左键将其设置为 LTR，右键将其设置为 RTL。

此外，以下信号具有默认键绑定

动作

GtkText 定义一组内置动作

clipboard.copy 将内容复制到剪贴板。
clipboard.cut 将内容复制到剪贴板并将其从小组件中删除。
clipboard.paste 将剪贴板的内容插入到小组件中。
menu.popup 打开上下文菜单。
misc.insert-emoji 打开表情符号选择器。
misc.toggle-visibility 切换 GtkText:visibility 属性。
misc.toggle-direction 切换文本方向。
selection.delete 删除当前选择。
selection.select-all 选择所有小组件内容。
text.redo 重做对内容的最后一次更改。
text.undo 撤消对内容的最后一次更改。

CSS 节点

text[.read-only]
├── placeholder
├── undershoot.left
├── undershoot.right
├── [selection]
├── [cursor-handle[.top]
├── [cursor-handle.bottom]
├── [block-cursor]
├── [cursor-handle[.top/.bottom][.insertion-cursor]]
╰── [window.popup]

GtkText 有一个主节点，名称为 text。根据小组件的属性，.read-only 样式类可能会出现。

当输入框有选择时，将添加一个名称为 selection 的子节点。

当输入框处于覆盖模式时，将添加一个名称为 block-cursor 的子节点，它确定块光标的绘制方式。

上下文菜单的 CSS 节点作为名称为 popup 的子节点添加。

在内容滚动出视野时，undershoot 节点用于绘制下溢指示。根据指示绘制的位置，这些节点会添加 .left 或 .right 样式类。

在使用触摸且显示触摸选择手柄时，它们使用名为 cursor-handle 的 CSS 节点。根据显示在选择中的位置，它们获取 .top 或 .bottom 样式类。如果仅为文本光标提供了一个手柄，则它获取样式类 .insertion-cursor。

辅助功能

GtkText 使用 GTK_ACCESSIBLE_ROLE_NONE 角色，这导致其跳过辅助功能。因为预期将 GtkText 用作将表示为辅助功能的 GtkEditable 实现的委托。

层次结构

祖先

实现

构造函数

gtk_text_new

创建新的 GtkText。

gtk_text_new_with_buffer

创建具有指定缓冲区的新 GtkText。

继承自 GtkWidget（162）的方法

有关方法的完整列表，请参阅 GtkWidget。

继承自 GObject（43）的方法

有关方法的完整列表，请参阅 GObject。

继承自 GtkBuildable（1）的方法

gtk_buildable_get_buildable_id

获取 buildable 对象的 ID。

继承自 GtkEditable（24）的方法

有关方法的完整列表，请参阅 GtkEditable。

继承自 GtkAccessible 的属性 (1)

GtkAccessible:accessible-role

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

继承自 GObject 的信号 (1)

GObject::notify

对对象的某个属性的值通过 g_object_set_property()、g_object_set() 等进行设置后，会在该对象上发出 notify 信号。

描述 [src]

快捷方式和手势

动作

CSS 节点

辅助功能

层次结构

祖先

实现

构造函数

实例方法

继承自 GtkWidget（162）的方法

继承自 GObject（43）的方法

继承自 GtkAccessible（19）的方法

继承自 GtkAccessibleText（3）的方法

继承自 GtkBuildable（1）的方法

继承自 GtkEditable（24）的方法

属性

从 GtkWidget 继承的属性 (34)

继承自 GtkAccessible 的属性 (1)

继承自 GtkEditable 的属性 (8)

信号