类
GtkAboutDialog
说明 [src]
final class Gtk.AboutDialog : Gtk.Window
implements Gtk.Accessible, Gtk.Buildable, Gtk.ConstraintTarget, Gtk.Native, Gtk.Root, Gtk.ShortcutManager {
/* No available fields */
}显示有关程序信息的一种简单方式。
显示的信息包括程序的徽标、名称、版权、网站和许可证。此外还可以列出参与了该程序开发的作者、文档编写者、翻译者和艺术家。
用户从帮助菜单中选择关于选项时，通常会打开一个关于对话框。对话框的所有部分都是可选的。
关于对话框通常包含链接和电子邮件地址。GtkAboutDialog会将它们显示为可单击链接。默认情况下，当用户点击一个链接时，它会调用 gtk_file_launcher_launch()。可以通过 GtkAboutDialog::activate-link 信号来覆盖此行为。
要指定带有电子邮件地址的人员，请使用如下字符串：Edgar Allan Poe <[email protected]>。要指定带有标题的网站，请使用如下字符串：GTK team https://gtk.org.cn。
为了尽可能方便地构建关于对话框，您可以使用 gtk_show_about_dialog() 函数，该函数构建并显示一个对话框，并保留它，以便可以再次显示。
请注意，GTK 在对话框窗口上设置默认标题 _("About %s") （其中 %s 被应用程序的名称替换，但是为了确保标题的正确翻译，应用程序在构建关于对话框时应显式设置标题属性，如下面的示例所示
GFile *logo_file = g_file_new_for_path ("./logo.png");
GdkTexture *example_logo = gdk_texture_new_from_file (logo_file, NULL);
g_object_unref (logo_file);
gtk_show_about_dialog (NULL,
"program-name", "ExampleCode",
"logo", example_logo,
"title", _("About ExampleCode"),
NULL);
快捷方式和手势
GtkAboutDialog 支持以下键盘快捷方式
- Escape 关闭窗口。
CSS 节点
GtkAboutDialog 具有单个 CSS 节点，名称为 window，样式类为 .aboutdialog。
实例方法
从 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
更新可访问状态数组。
从 GtkBuildable (1) 继承的方法
从 GtkNative (5) 继承的方法
gtk_native_get_renderer
返回用于此 GtkNative 的渲染器。
gtk_native_get_surface
返回此 GtkNative 的表面。
gtk_native_get_surface_transform
检索 self 的表面转换。
gtk_native_realize
实现 GtkNative。
gtk_native_unrealize
取消实现 GtkNative。
从 GtkRoot (3) 继承的方法
gtk_root_get_display
返回此 GtkRoot 所在的显示器。
gtk_root_get_focus
检索根目录中的当前焦点窗口小部件。
gtk_root_set_focus
如果focus不是当前焦点小部件，并且可获得焦点，则将其设置为该根的焦点小部件。
属性
从 GtkWindow（25）继承的属性
Gtk.Window:application
与该窗口关联的GtkApplication。
Gtk.Window:child
子小部件。
Gtk.Window:decorated
窗口是否应有框架（也称为“装饰”）。
Gtk.Window:default-height
窗口的默认高度。
Gtk.Window:default-widget
默认小部件。
Gtk.Window:default-width
窗口的默认宽度。
Gtk.Window:deletable
窗口框架是否应有关闭按钮。
Gtk.Window:destroy-with-parent
如果当父窗口被摧毁时该窗口应被摧毁。
Gtk.Window:display
将显示该窗口的显示器。
Gtk.Window:focus-visible
该窗口中是否当前可见“焦点矩形”。
Gtk.Window:focus-widget
焦点小部件。
Gtk.Window:fullscreened
窗口是否为全屏。
Gtk.Window:handle-menubar-accel
窗口框架是否应处理 F10 以激活菜单栏。
since: 4.2
Gtk.Window:hide-on-close
当用户单击关闭按钮时是否应隐藏该窗口。
Gtk.Window:icon-name
指定用作窗口图标的主题图标的名称。
Gtk.Window:is-active
该顶层窗口是否当前活动。
Gtk.Window:maximized
窗口是否最大化。
Gtk.Window:mnemonics-visible
该窗口中是否当前可见助记符。
Gtk.Window:modal
如果为真，则该窗口为模式窗口。
Gtk.Window:resizable
如果为真，则用户可以调整窗口大小。
Gtk.Window:startup-id
用于设置窗口启动通知标识符的只写属性。
Gtk.Window:suspended
窗口是否处于暂停状态。
since: 4.12
Gtk.Window:title
窗口的标题。
Gtk.Window:titlebar
标题栏小部件。
since: 4.6
Gtk.Window:transient-for
该窗口的瞬态父窗口。
从 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
启用或禁用 GtkWidget::query-tooltip 在 widget 上发出的信号。
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)
信号
继承自 GtkWindow 的信号 (5)
GtkWindow::activate-default
当用户激活默认小部件时发出。
GtkWindow::activate-focus
当用户激活 window 当前聚焦的小部件时发出。
GtkWindow::close-request
当用户单击窗口的关闭按钮时发出。
GtkWindow::enable-debugging
当用户启用或禁用交互式调试时发出。
GtkWindow::keys-changed
当与窗口关联的加速键或助记符集发生更改时发出。
已弃用：4.10
继承自 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() 等设置值时，notify 信号会在该对象上触发。