GtkLockButton

已舍弃:4.10 

描述 [src]

final class Gtk.LockButton : Gtk.Button
  implements Gtk.Accessible, Gtk.Actionable, Gtk.Buildable, Gtk.ConstraintTarget {
  /* No available fields */
}

GtkLockButton 是用于获取和撤销操作控件所需的权限的组件。

An example GtkLockButton

它通常用于首选项对话框或控制面板中。

所需的权限由 GPermission 对象表示。GPermission 的具体实现可以使用 PolicyKit 或其他一些授权框架。要获取基于 PolicyKit 的 GPermission,请使用 polkit_permission_new()

如果用户当前无法执行该操作,但可以获取权限,则组件会显示为以下内容

用户可以单击按钮来请求权限。根据平台的不同,这可能会弹出一个身份验证对话框或要求用户以其他方式进行身份验证。一旦用户获得权限,组件将更改为此内容

并且可以通过单击按钮再次放弃权限。如果用户根本无法获得权限,则组件将显示为以下内容

如果用户拥有该权限且无法丢弃该权限,则按钮处于隐藏状态。

可以在各种情况下显示的文本(和工具提示)可以使用 GtkLockButton:text-lockGtkLockButton:text-unlockGtkLockButton:tooltip-lockGtkLockButton:tooltip-unlockGtkLockButton:tooltip-not-authorized 属性进行调整。

自 4.10 起已弃用

此组件将在 GTK 5 中移除。

层次

hierarchy this GtkLockButton implements_0 GtkAccessible this--implements_0 implements_1 GtkActionable this--implements_1 implements_2 GtkBuildable this--implements_2 implements_3 GtkConstraintTarget this--implements_3 ancestor_0 GtkButton ancestor_0--this ancestor_1 GtkWidget ancestor_1--ancestor_0 ancestor_2 GInitiallyUnowned ancestor_2--ancestor_1 ancestor_3 GObject ancestor_3--ancestor_2

构造函数

gtk_lock_button_new

创建一个反映 permission 的新的锁定按钮。

已舍弃:4.10 

实例方法

gtk_lock_button_get_permission

获取控制 buttonGPermission 对象。

已舍弃:4.10 

gtk_lock_button_set_permission

设置控制 buttonGPermission 对象。

已舍弃:4.10 

GtkButton(12)继承的方法
gtk_button_get_can_shrink

检索该按钮是否可以比其内容的自然大小还小。

自 4.12 起

gtk_button_get_child

获取 button 的子组件。

gtk_button_get_has_frame

返回按钮是否具有框架。

gtk_button_get_icon_name

返回该按钮的图标名称。

gtk_button_get_label

从该按钮的标签中获取文本。

gtk_button_get_use_underline

获取下划线是否被解释为助记符。

gtk_button_set_can_shrink

设置按钮尺寸是否可以小于其内容的自然尺寸。

自 4.12 起

gtk_button_set_child

设置 `button` 的子小部件。

gtk_button_set_has_frame

设置按钮的样式。

gtk_button_set_icon_name

添加一个带有给定图标名称的 `GtkImage` 作为子级。

gtk_button_set_label

将按钮标签的文本设置为 `label`。

gtk_button_set_use_underline

设置是否使用下划线作为助记符。

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

更新无障碍状态数组。

GtkActionable(6)继承的方法
gtk_actionable_get_action_name

获取 `actionable` 的操作名称。

gtk_actionable_get_action_target_value

获取 `actionable` 的当前目标值。

gtk_actionable_set_action_name

指定小部件应该与其关联的操作名称。

gtk_actionable_set_action_target

设置可操作小部件的目标。

gtk_actionable_set_action_target_value

设置可操作小部件的目标值。

gtk_actionable_set_detailed_action_name

设置可操作小部件的操作名称和关联的字符串目标值。

GtkBuildable(1)继承的方法
gtk_buildable_get_buildable_id

获取 `buildable` 对象的 ID。

属性

Gtk.LockButton:permission

控制此按钮的`GPermission`对象。

已舍弃:4.10 

Gtk.LockButton:text-lock

提示用户锁定时要显示的文本。

已舍弃:4.10 

Gtk.LockButton:text-unlock

提示用户解锁时要显示的文本。

已舍弃:4.10 

Gtk.LockButton:tooltip-lock

提示用户锁定时要显示的工具提示。

已舍弃:4.10 

Gtk.LockButton:tooltip-not-authorized

用户无法获得授权时要显示的工具提示。

已舍弃:4.10 

Gtk.LockButton:tooltip-unlock

提示用户解锁时要显示的工具提示。

已舍弃:4.10 

GtkButton中继承的属性(6)
Gtk.Button:can-shrink

按钮的大小是否可以小于其内容的自然大小。

自 4.12 起

Gtk.Button:child

子控件。

Gtk.Button:has-frame

按钮是否有边框。

Gtk.Button:icon-name

用于自动填充按钮的图标的名称。

Gtk.Button:label

如果按钮包含一个标签控件,则为按钮内标签的文本。

Gtk.Button:use-underline

如果设置该属性,则文本中的下划线表示要使用以下字符作为助记符。

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 实现的可访问角色。

GtkActionable(2)继承的属性
GtkActionable:action-name

该窗口小组件应与其关联的操作的名称。

GtkActionable:action-target

可操作窗口小组件操作的目标值。

信号

GtkButton(2)继承的信号
GtkButton::activate

发出以设置按下,然后释放的动画。

GtkButton::clicked

在按钮被激活(按下并释放)时发出。

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() 等被设置其值时,将在对象上发出通知信号。