类
GtkLockButton
已舍弃:4.10
描述 [src]
final class Gtk.LockButton : Gtk.Button
implements Gtk.Accessible, Gtk.Actionable, Gtk.Buildable, Gtk.ConstraintTarget {
/* No available fields */
}
GtkLockButton
是用于获取和撤销操作控件所需的权限的组件。
它通常用于首选项对话框或控制面板中。
所需的权限由 GPermission
对象表示。GPermission
的具体实现可以使用 PolicyKit 或其他一些授权框架。要获取基于 PolicyKit 的 GPermission
,请使用 polkit_permission_new()
。
如果用户当前无法执行该操作,但可以获取权限,则组件会显示为以下内容
用户可以单击按钮来请求权限。根据平台的不同,这可能会弹出一个身份验证对话框或要求用户以其他方式进行身份验证。一旦用户获得权限,组件将更改为此内容
并且可以通过单击按钮再次放弃权限。如果用户根本无法获得权限,则组件将显示为以下内容
如果用户拥有该权限且无法丢弃该权限,则按钮处于隐藏状态。
可以在各种情况下显示的文本(和工具提示)可以使用 GtkLockButton:text-lock
、GtkLockButton:text-unlock
、GtkLockButton:tooltip-lock
、GtkLockButton:tooltip-unlock
和 GtkLockButton:tooltip-not-authorized
属性进行调整。
自 4.10 起已弃用
此组件将在 GTK 5 中移除。
实例方法
从 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
设置是否使用下划线作为助记符。
从 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)继承的方法
属性
从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)继承的属性
从 GtkActionable(2)继承的属性
信号
从 GtkButton(2)继承的信号
从 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() 等被设置其值时,将在对象上发出通知信号。