GtkEditableLabel

说明 [src]

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

GtkEditableLabel 是一种标签,允许用户通过切换到“编辑模式”编辑文本。

An example GtkEditableLabel

GtkEditableLabel 并没有自己的 API,但它实现了 GtkEditable 接口。

激活编辑模式的默认绑定是单击或按下 Enter 键。离开编辑模式的默认绑定是 Enter 键(保存结果)或 Escape 键(取消编辑)。

快捷键和手势

GtkEditableLabel 支持以下键盘快捷键

  • Enter 开始编辑。
  • Escape 停止编辑。

动作

GtkEditableLabel 定义了一组内置的 动作

  • editing.starts 将小组件切换到编辑模式。
  • editing.stop 将小组件从编辑模式切换出去。

CSS 节点

editablelabel[.editing]
╰── stack
    ├── label
    ╰── text

GtkEditableLabel 具有一个主节点,名称为 editablelabel。当条目处于编辑模式时,它会获取 .editing 样式类。

有关在各种情况下添加到文本节点的所有子节点,请参见 GtkText

分层

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

构造函数

gtk_editable_label_new

创建一个新的 GtkEditableLabel 小组件。

实例方法

gtk_editable_label_get_editing

返回标签当前是否处于“编辑模式”。

gtk_editable_label_start_editing

将标签切换为“编辑模式”。

gtk_editable_label_stop_editing

将标签从“编辑模式”切换出去。

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

GtkEditable 继承的方法 (24)

请参阅 GtkEditable 以获取完整的方法列表。

属性

Gtk.EditableLabel:editing

小部件处于编辑模式时,此属性为 TRUE

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

启用或禁用 widgetGtkWidget::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 实现的可访问角色。

继承自 GtkEditable 的属性 (8)
GtkEditable:cursor-position

插入符的当前位置(以字符为单位)。

GtkEditable:editable

条目内容能否编辑。

GtkEditable:enable-undo

是否为可编辑内容启用撤消/重做。

GtkEditable:max-width-chars

条目的期望最大宽度(以字符为单位)。

GtkEditable:selection-bound

从光标到选择另一端的相对位置(以字符为单位)。

GtkEditable:text

条目的内容。

GtkEditable:width-chars

在条目中留出多少字符。

GtkEditable:xalign

水平对齐,从 0(左)到 1(右)。

信号

继承自 GtkWidget 的信号 (13)
GtkWidget::destroy

所有 widget 引用持有者应该释放他们持有的引用的信号。

GtkWidget::direction-changed

在 widget 的文本方向发生改变时触发。

GtkWidget::hide

widget 隐藏时触发。

GtkWidget::keynav-failed

如果键盘导航失败,触发。

GtkWidget::map

widget 将要被 map 时触发。

GtkWidget::mnemonic-activate

在通过助记符激活一个 widget 时触发。

GtkWidget::move-focus

在焦点被移动时触发。

GtkWidget::query-tooltip

在 widget 的工具提示即将显示时触发。

GtkWidget::realize

widget 与一个 GdkSurface 关联时触发。

GtkWidget::show

widget 显示时触发。

GtkWidget::state-flags-changed

在 widget 状态发生改变时触发。

GtkWidget::unmap

widget 将要被 unmap 时触发。

GtkWidget::unrealize

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

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

当一个对象通过 g_object_set_property()、g_object_set() 等途径设置其某个属性的值时,会触发 notify 信号。

继承自 GtkEditable 的信号 (3)
GtkEditable::changed

在针对内容的单个用户可见操作结束时触发。

GtkEditable::delete-text

当用户从 widget 中删除文本时触发。

GtkEditable::insert-text

当用户向 widget 中插入文本时触发。

类结构

struct GtkEditableLabelClass {
  GtkWidgetClass parent_class;
  
}

无可用描述。

类成员
parent_class: GtkWidgetClass

无可用描述。