GTK+ 4.0 中的 Widget 层级结构

但是，GTK+3 中还有更复杂的 widget，它们不继承自 GtkContainer，例如 GtkSpinButton 或 GtkSwitch。这些 widget 从来没有真正的 GtkWidget 子项。例如，考虑 GtkSpinButton 中的两个可点击区域。我在这里不称它们为“按钮”是有原因的，因为在 GTK+3 中，它们不是实际的 GtkButton 实例，因为 GtkSpinButton 不是 GtkContainer。相反，GtkSpinButton 必须绕过这个事实，并为向上/向下区域创建两个 GdkWindow，然后在其中渲染两个图标；关心悬停和 CSS 状态；各种按钮向上/向下事件；以及 GdkWindow 的生命周期等。为了绕过 GtkContainer 的要求，我们在 GTK+3 中引入了小部件（GtkCssGadget）。在样式方面，小部件对应于 CSS 盒子，因此代表 CSS 树中的一个节点。在 widget 方面，它们被用于为非容器 widget 提供“类似 widget 的”、可使用 CSS 设置样式的子项。

当然，在 GTK+4 中支持这些用例需要进行很多更改。我不会在这里列出所有更改（特别是像焦点处理这样更丑陋的更改），但我认为其中大多数对于应用程序开发人员和自定义 widget 作者来说都非常有趣和重要。总的来说，我们正试图摆脱特殊情况，并通过尽可能地重用 widget 来走更通用的道路。因此，与其使用 PangoLayout来显示文本，不如让 widget 使用GtkLabel。如果你有一个具有按钮语义的可点击区域，请尝试使用GtkButton。如果你想以水平或垂直方向布局 widget，请使用GtkBox。这样，我们就有了一个可以同时进行输入和渲染的 widget 树。实际上，这意味着主要要摆脱 widget 内部使用的所有小部件，以及独立的GtkCssNode实例。

• gtk_widget_get_first_child()
• gtk_widget_get_last_child()
• gtk_widget_get_prev_sibling()
• gtk_widget_get_next_sibling()

GtkWidget *widget;
GtkWidget *child;
for (child = gtk_widget_get_first_child (widget);
     child != NULL;
     child = gtk_widget_get_next_sibling (child))
  {
    /* Do stuff with @child */
    g_assert (gtk_widget_get_parent (child) == widget);
  }

向非容器父项添加 widget

在 GTK+4 中，gtk_widget_set_parent() 仍然有效，并将 widget 添加到父项的子 widget 列表的末尾。但是，我们显然也想管理子 widget 的顺序，以及我们在列表中添加新子项的位置，因此我们有：

• gtk_widget_insert_before()
• gtk_widget_insert_after()

Widget CSS 名称

转换后的 Widget 示例

GtkSwitch

在 GTK+ 主分支中，开关仍然有其 widget 级别的 GtkCssGadget，因此它支持 min-width/min-height CSS 属性和 CSS 边距，但是滑块小部件已被 GtkButton 取代，两个 PangoLayout 已被 GtkLabel 取代。这样，我们可以节省大约 300 行 gtkswitch.c 中的代码。理论上，我们还拥有更多功能，例如可以使用 GtkLabel 支持的文本装饰 CSS 属性的有限支持，但我只是怀疑这是否真的很有用。

GtkSpinButton

如前所述，GtkSpinButton 可以轻松地为向上/向下区域使用实际的 GtkButton，并且它在 GTK+ 主分支中（在某个时候将成为 GTK+4）也是这样做的。这样可以删除 gtkspinbutton.c 中的另外 300 行代码。通过使用 GtkButton，旧的图标助手小部件也变成了实际的 GtkImage 实例。不幸的是，我们必须在这里自己实现一些 GtkGesture 的魔法，因为 GtkSpinButton 还支持在其按钮上进行鼠标中键和右键单击，而 GtkButton::clicked 仅对单个主鼠标按钮单击做出反应。

GtkLevelBar

GtkProgressBar

GtkProgressBar 使用构件（gadget）来表示槽和进度节点。它还使用 PangoLayout 来显示百分比或用户给定的字符串。

在主分支（master）中，槽和进度条都是部件，PangoLayout 当然是一个 GtkLabel。不必监听 GtkWidget::style-changed（部件会自动处理），并且不必自己绘制 PangoLayout（现在由 GtkLabel 处理）可以节省大约 200 行代码，这是一个不错的代码大小节省。

GtkExpander

意外的 GtkBox & GtkButton 子类

通用重构规则和未来