类

GtkWindow

描述 [源文件]

class Gtk.Window : Gtk.Widget
  implements Gtk.Accessible, Gtk.Buildable, Gtk.ConstraintTarget, Gtk.Native, Gtk.Root, Gtk.ShortcutManager {
  /* No available fields */
}

可包含其他小部件的顶级窗口。

An example GtkWindow

窗口通常具有由窗口系统控制的装饰，它允许用户操纵窗口（调整大小、移动、关闭等）。

GtkWindow 作为 GtkBuildable

GtkWindow 的 GtkBuildable 接口实现支持通过将 “titlebar” 指定为 <child> 元素的 “type” 属性来将子项设置为标题栏。

快捷键和手势

GtkWindow 支持以下键盘快捷键

F10 激活菜单栏（如果存在）。
Alt 在按下时使助记符可见。

以下信号具有默认的按键绑定

操作

GtkWindow 定义一组内置操作

default.activate 激活默认小部件。
window.minimize 最小化窗口。
window.toggle-maximized 最大化或还原窗口。
window.close 关闭窗口。

CSS 节点

window.background [.csd / .solid-csd / .ssd] [.maximized / .fullscreen / .tiled]
├── <child>
╰── <titlebar child>.titlebar [.default-decoration]

GtkWindow 具有一个带有名称 window 和样式类 .background 的主 CSS 节点。

通常与主 CSS 节点一起使用的样式类是 .csd（当使用客户端装饰时）、.solid-csd（用于没有不可见边框的客户端装饰）、.ssd（mutter 在渲染服务器端装饰时使用）。GtkWindow 还使用以下样式类表示主节点上的窗口状态：.maximized、.fullscreen、.tiled（如果支持，还有 .tiled-top、.tiled-left、.tiled-right、.tiled-bottom）。

GtkWindow 子类通常会添加自己的区分样式类，例如 .dialog、.popup 或 .tooltip。

一般来说，一些 CSS 属性对顶级窗口节点没有意义，例如边距或填充。当客户端装饰没有不可见边框时（即 .solid-csd 样式类已添加到主窗口节点），顶级窗口的 CSS 边框用于调整拖动大小。对于 .csd 案例，窗口之外的阴影区域可用于调整大小。

GtkWindow 将 .titlebar 和 .default-decoration 样式类添加到作为标题栏子项添加的小部件。

辅助功能

在 GTK 4.10 之前，GtkWindow 使用 GTK_ACCESSIBLE_ROLE_WINDOW 角色。

从 GTK 4.12 开始，GtkWindow 使用 GTK_ACCESSIBLE_ROLE_APPLICATION 角色。

层级

祖先

后代

实现

构造函数

gtk_window_new

创建一个新的 GtkWindow。

从 GtkWidget (162) 继承的方法

有关方法的完整列表，请参见 GtkWidget。

从 GObject (43) 继承的方法

有关方法的完整列表，请参见 GObject。

从 GtkBuildable（1）继承的方法

gtk_buildable_get_buildable_id

获取 buildable 对象的 ID。

从 GtkAccessible (1) 继承的属性

GtkAccessible:accessible-role

给定的 `GtkAccessible` 实现的辅助角色。

从 GObject 继承的信号（1 个）

GObject::notify

当对象通过 g_object_set_property()、g_object_set() 等函数设置其属性值时，会发送 notify 信号。

类结构

struct GtkWindowClass {
  GtkWidgetClass parent_class;
  void (* activate_focus) (
    GtkWindow* window
  );
  void (* activate_default) (
    GtkWindow* window
  );
  void (* keys_changed) (
    GtkWindow* window
  );
  gboolean (* enable_debugging) (
    GtkWindow* window,
    gboolean toggle
  );
  gboolean (* close_request) (
    GtkWindow* window
  );
  
}

暂无描述。

成员

parent_class: GtkWidgetClass: 父类。
activate_focus: void (* activate_focus) ( GtkWindow* window ): 激活窗口内当前聚焦的窗口。
activate_default: void (* activate_default) ( GtkWindow* window ): 激活窗口的默认窗口。
keys_changed: void (* keys_changed) ( GtkWindow* window ): 当与窗口关联的加速器或助记符发生改变时，会发送信号。
enable_debugging: gboolean (* enable_debugging) ( GtkWindow* window, gboolean toggle ): 类处理程序，用于 GtkWindow::enable-debugging 关键绑定信号。
close_request: gboolean (* close_request) ( GtkWindow* window ): 暂无描述。

描述 [源文件]

GtkWindow 作为 GtkBuildable

快捷键和手势

操作

CSS 节点

辅助功能

层级

祖先

后代

实现

构造函数

函数

实例方法

从 GtkWidget (162) 继承的方法

从 GObject (43) 继承的方法

从 GtkAccessible (19) 继承的方法

从 GtkBuildable（1）继承的方法

从 GtkNative（5）继承的方法

从 GtkRoot（3）继承的方法

属性

从 GtkWidget (34) 继承的属性