如何在Gtk中分组控件，实现单次仅显示一个指定控件以简化代码？

我当前使用以下Python代码实现GTK应用窗口：

class AppWindow(Adw.ApplicationWindow):
    __gtype_name__ = 'AppWindow'

    label = Gtk.Template.Child()
    search_button = Gtk.Template.Child()
    refresh_button = Gtk.Template.Child()
    content = Gtk.Template.Child()

    def __init__(self, **kwargs):
        super().__init__(**kwargs)
        self.search_button.connect("clicked", self.on_search_cb)
        self.refresh_button.connect("clicked", self.on_refresh_cb)

需求是每次仅显示label、search_button或content中的一个控件，想知道是否存在类似gtk_widget_set_group的控件分组方法来简化代码；如果没有这类方法，我也可以通过以下方式实现：

def set_label_visible(self):
    self.label.set_visible(True)
    self.search_button.set_visible(False)
    self.content.set_visible(False)
# 同理还有set_search_button_visible和set_content_visible方法

解决方案 #

GTK中并没有gtk_widget_set_group这类直接实现控件互斥显示的API，但可以通过以下两种更简洁的方式实现需求：

• 方案一：封装通用切换函数
  编写一个通用方法，接收目标显示控件，自动隐藏同组内的其他控件，避免重复编写相似逻辑：

def show_only(self, target_widget):
    # 定义需要互斥显示的控件集合
    exclusive_widgets = [self.label, self.search_button, self.content]
    for widget in exclusive_widgets:
        widget.set_visible(widget is target_widget)

使用时只需调用self.show_only(self.label)、self.show_only(self.search_button)或self.show_only(self.content)即可完成切换。

• 方案二：使用Gtk.Stack容器（推荐）
  如果布局允许，更推荐使用Gtk.Stack容器来管理这些互斥显示的控件——它本身就是为多控件切换场景设计的，自带互斥显示特性：

1. 在UI模板中将label、search_button、content放入Gtk.Stack容器内，并为每个子控件设置唯一的名称；
2. 在代码中通过以下方式切换显示：

# 假设stack是模板中定义的Gtk.Stack控件
self.stack.set_visible_child(self.label)
# 或通过控件名称切换
self.stack.set_visible_child_name("label")

这种方式完全符合GTK的设计规范，无需手动管理控件可见性，还可配合Gtk.StackSwitcher快速实现切换UI按钮，扩展性更强。

内容的提问来源于stack exchange，提问作者anon