GtkLinkButton

描述 [src]

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

GtkLinkButton 是带有超链接的按钮。

An example GtkLinkButton

它可用于快速链接到资源。

通过调用 gtk_link_button_new()gtk_link_button_new_with_label() 创建一个链接按钮。如果使用前者,传入构造函数的 URI 将用作小部件的标签。

绑定到 GtkLinkButtonURI 可以使用 gtk_link_button_set_uri() 专门设置。

默认情况下,当单击按钮时,GtkLinkButton 将调用 gtk_file_launcher_launch()。可以通过连接到 GtkLinkButton::activate-link 信号并从信号处理程序返回 TRUE 来覆盖此行为。

快捷方式和手势

GtkLinkButton 支持以下键盘快捷方式

  • Shift+F10Menu 打开上下文菜单。

操作

GtkLinkButton 定义了一组内置操作

  • clipboard.copy 将 url 复制到剪贴板中。
  • menu.popup 打开上下文菜单。

CSS 节点

GtkLinkButton 具有一个名为 button 的单一 CSS 节点。为了区分它和一个普通的 GtkButton,它获取了 .link 样式类。

辅助功能

GtkLinkButton 使用 GTK_ACCESSIBLE_ROLE_LINK 角色。

层次结构

hierarchy this GtkLinkButton 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_link_button_new

创建一个新的 GtkLinkButton,其 URI 为其文本。

gtk_link_button_new_with_label

创建一个新的 GtkLinkButton,其中包含一个标签。

实例方法

gtk_link_button_get_uri

检索 GtkLinkButtonURI

gtk_link_button_get_visited

检索 GtkLinkButton 的“已访问”状态。

gtk_link_button_set_uri

uri 设置为 GtkLinkButton 指向的 URI

gtk_link_button_set_visited

设置 GtkLinkButton 的“已访问”状态。

GtkButton (12) 继承的方法
gtk_button_get_can_shrink

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

since: 4.12

gtk_button_get_child

获取按钮的子小组件。

gtk_button_get_has_frame

返回按钮是否有框架。

gtk_button_get_icon_name

返回按钮的图标名称。

gtk_button_get_label

从按钮的标签获取文本。

gtk_button_get_use_underline

获取是否将下划线解释为快捷键。

gtk_button_set_can_shrink

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

since: 4.12

gtk_button_set_child

设置按钮的子小组件。

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

请求用户的屏幕阅读器播报给定的消息。

since: 4.14

gtk_accessible_get_accessible_parent

检索辅助功能对象的辅助功能父级。

since: 4.10

gtk_accessible_get_accessible_role

检索辅助功能对象的辅助功能角色。

gtk_accessible_get_at_context

检索特定辅助功能对象的实现。

since: 4.10

gtk_accessible_get_bounds

查询此辅助功能的坐标和维度。

since: 4.10

gtk_accessible_get_first_accessible_child

检索辅助功能对象的第一个辅助功能子级。

since: 4.10

gtk_accessible_get_next_accessible_sibling

检索辅助功能对象的下一个辅助功能同级。

since: 4.10

gtk_accessible_get_platform_state

查询平台状态(例如焦点)。

since: 4.10

gtk_accessible_reset_property

将辅助功能属性重置为默认值。

gtk_accessible_reset_relation

将辅助功能关系重置为默认值。

gtk_accessible_reset_state

将辅助功能状态重置为默认值。

gtk_accessible_set_accessible_parent

设置辅助功能对象的父级和同级。

since: 4.10

gtk_accessible_update_next_accessible_sibling

更新下一个辅助功能同级。

since: 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.LinkButton:uri

绑定到此按钮的 URI

Gtk.LinkButton:visited

此按钮的“已访问”状态。

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

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

since: 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

可执行小工具操作的值的目标。

信号

Gtk.LinkButton::activate-link

每次单击 GtkLinkButton 时发出。

继承自 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() 等设置其值时,会在对象上发送通知信号。