如何在GTK 4.0（Python）中为搜索框添加下拉结果列表？

你可以通过Gtk.Popover + Gtk.ListBox的组合来实现需求，这个方案完全可控，能适配你自己的过滤排序逻辑，同时支持键盘箭头导航。以下是具体实现步骤和代码示例：

核心思路 #

1. 用Gtk.SearchEntry作为搜索输入控件，监听输入变化信号触发结果更新。
2. 用Gtk.Popover作为下拉容器，绑定到搜索框下方显示，容器内用Gtk.ListBox展示自定义过滤后的结果。
3. 监听键盘按键事件，手动处理上下箭头的导航逻辑，实现列表项的选中切换。

完整代码示例 #

import gi
gi.require_version('Gtk', '4.0')
from gi.repository import Gtk

class SearchWindow(Gtk.ApplicationWindow):
    def __init__(self, app):
        super().__init__(application=app, title="自定义搜索下拉")
        self.set_default_size(400, 300)

        # 主布局容器
        main_box = Gtk.Box(
            orientation=Gtk.Orientation.VERTICAL,
            spacing=10,
            margin_top=20,
            margin_start=20,
            margin_end=20
        )
        self.set_child(main_box)

        # 搜索输入框
        self.search_entry = Gtk.SearchEntry()
        self.search_entry.connect("search-changed", self.on_search_update)
        self.search_entry.connect("key-press-event", self.handle_key_nav)
        main_box.append(self.search_entry)

        # 下拉弹窗容器
        self.result_popover = Gtk.Popover()
        self.result_popover.set_parent(self.search_entry)
        self.result_popover.set_position(Gtk.PositionType.BOTTOM)

        # 结果列表控件
        self.result_list = Gtk.ListBox()
        self.result_list.set_activate_on_single_click(True)
        self.result_list.connect("row-activated", self.on_result_select)
        self.result_popover.set_child(self.result_list)

        # 模拟数据源（替换成你的实际数据）
        self.raw_data = ["Apple", "Banana", "Cherry", "Date", "Elderberry", "Fig", "Grape"]

    def on_search_update(self, entry):
        # 自定义过滤排序逻辑（替换成你的实现）
        query = entry.get_text().lower()
        filtered_results = [item for item in self.raw_data if query in item.lower()]
        filtered_results.sort()  # 这里用你的自定义排序逻辑

        # 更新列表内容
        self.result_list.remove_all()
        for item in filtered_results:
            row = Gtk.ListBoxRow()
            row.set_child(Gtk.Label(label=item, margin=5))
            self.result_list.append(row)

        # 控制弹窗显示/隐藏
        if filtered_results:
            self.result_popover.popup()
        else:
            self.result_popover.popdown()

    def handle_key_nav(self, entry, event):
        keyval = event.keyval
        # 向下箭头选中下一项
        if keyval == Gtk.KEY_Down:
            current_row = self.result_list.get_selected_row()
            if current_row:
                next_row = current_row.get_next_sibling()
                if next_row:
                    self.result_list.select_row(next_row)
            else:
                first_row = self.result_list.get_row_at_index(0)
                if first_row:
                    self.result_list.select_row(first_row)
            return True
        # 向上箭头选中上一项
        elif keyval == Gtk.KEY_Up:
            current_row = self.result_list.get_selected_row()
            if current_row:
                prev_row = current_row.get_previous_sibling()
                if prev_row:
                    self.result_list.select_row(prev_row)
            return True
        # 回车键确认选中项
        elif keyval == Gtk.KEY_Return:
            current_row = self.result_list.get_selected_row()
            if current_row:
                self.on_result_select(self.result_list, current_row)
            return True
        return False

    def on_result_select(self, list_box, row):
        selected_label = row.get_child()
        # 选中后将内容填入搜索框
        self.search_entry.set_text(selected_label.get_label())
        # 隐藏弹窗
        self.result_popover.popdown()
        # 这里可以添加选中后的业务逻辑
        print(f"已选中: {selected_label.get_label()}")

class SearchApp(Gtk.Application):
    def __init__(self):
        super().__init__(application_id="org.example.SearchDemo")

    def do_activate(self):
        window = SearchWindow(self)
        window.present()

if __name__ == "__main__":
    app = SearchApp()
    app.run(None)

关键细节说明 #

• Popover绑定：GTK4中用set_parent()方法将Popover绑定到SearchEntry，设置PositionType.BOTTOM确保弹窗在搜索框下方显示。
• 自定义数据处理：on_search_update方法中可以直接替换成你已有的过滤排序逻辑，不需要依赖GTK自带的过滤组件。
• 键盘导航：通过key-press-event监听上下箭头，手动控制ListBox的选中项，完全适配你的交互需求。
• EntryCompletion替代：由于GTK4 Python绑定未暴露SearchEntry.set_completion()方法，Popover+ListBox是更灵活的替代方案，不受GTK内置逻辑限制。

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