GtkPasswordEntry

说明 [src]

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

GtkPasswordEntry 是一个专门用于输入密码的输入框。

An example GtkPasswordEntry

它不会以明文形式显示其内容,不允许将其复制到剪贴板,并且在大写锁定键被启用时会显示警告。如果底层平台允许,GtkPasswordEntry 还会将文本放在不可分页的内存区域中,以避免它被操作系统写入磁盘。

另外,它可以提供一种以明文形式显示内容的方法。

GtkPasswordEntry 仅提供最小的 API,应与 GtkEditable API 一起使用。

CSS 节点

entry.password
╰── text
    ├── image.caps-lock-indicator
    ┊

GtkPasswordEntry 具有一个带有名称 entry 的单个 CSS 节点,它带有 .passwordstyle 类。其下面的文本 Css 节点具有一个带有名称 image 和样式类 .caps-lock-indicator 的子节点(用于大写锁定指示符),还可能具有其他子节点。

辅助功能

GtkPasswordEntry 使用 GTK_ACCESSIBLE_ROLE_TEXT_BOX 角色。

层次结构

hierarchy this GtkPasswordEntry 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_password_entry_new

创建 GtkPasswordEntry

实例方法

gtk_password_entry_get_extra_menu

获取使用 gtk_password_entry_set_extra_menu() 设置的菜单模型。

gtk_password_entry_get_show_peek_icon

返回输入框是否显示用于显示内容的图标。

gtk_password_entry_set_extra_menu

entry 构造上下文菜单时,设置要添加的菜单模型。

gtk_password_entry_set_show_peek_icon

设置输入框是否应该具有一个可点击的图标,用于显示内容。

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

获取 ID buildable 对象。

GtkEditable 继承的方法 (24)

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

属性

Gtk.PasswordEntry:activates-default

在按下 Enter 时是否激活默认小部件。

Gtk.PasswordEntry:extra-menu

其内容将附加到上下文菜单的菜单模型。

Gtk.PasswordEntry:placeholder-text

GtkPasswordEntry 为空且未聚焦时显示在其中的文本。

Gtk.PasswordEntry:show-peek-icon

是否显示用于显示内容的图标。

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(右)。

信号

Gtk.PasswordEntry::activate

激活条目时发出。

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

窗口状态发生更改时发出。

GtkWidget::unmap

将取消映射 widget 时发出。

GtkWidget::unrealize

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

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

当通过 g_object_set_property()、g_object_set() 等设置了对象某个属性的值时,将对该对象发送该 notify 信号。

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

在对内容进行用户可见的单次操作结束时发送。

GtkEditable::delete-text

当用户从窗口小部件中删除文字时发送。

GtkEditable::insert-text

当用户在窗口小部件中插入文字时发送。

类结构

struct GtkPasswordEntryClass {
  /* no available fields */
}

无可用描述。