如何让Gtk+ 3的EntryCompletion在Entry为空时显示自动补全？

嘿，我刚好碰到过这个问题！默认情况下Gtk.EntryCompletion确实只会在输入框有字符的时候才会显示建议，直接调用complete()没用是因为它内部的匹配逻辑过滤掉了空输入的情况。咱们得从两个地方入手调整：

1. 自定义匹配函数，允许空输入匹配所有条目 #

首先要给EntryCompletion替换默认的匹配规则，让输入框为空时能返回所有列表项。你可以在代码里添加一个自定义匹配函数：

def match_func(completion, key, iter, data):
    # 获取当前列表项的文本内容
    model = completion.get_model()
    item_text = model[iter][0]
    # 如果输入的关键词为空，直接匹配所有条目
    if not key:
        return True
    # 非空时用前缀匹配（你也可以改成模糊匹配，比如用in判断）
    return item_text.lower().startswith(key.lower())

# 给你的completion实例绑定这个匹配函数
self.completion.set_match_func(match_func, None)

2. 在合适时机手动触发补全弹出 #

现在匹配逻辑支持空输入了，接下来需要在用户操作时触发补全，比如输入框获得焦点、被点击的时候。这里以绑定焦点事件为例：

def on_entry_focus_in(self, entry, event):
    # 当输入框为空且获得焦点时，触发补全
    if not entry.get_text():
        self.completion.complete()
    return False  # 返回False让事件继续传递

# 假设你的Entry组件是self.entry，绑定事件
self.entry.connect("focus-in-event", self.on_entry_focus_in)

整合后的完整代码示例 #

把这些逻辑放到你的MainWindow类里，大概是这样：

class MainWindow(Gtk.Window):
    def __init__(self):
        Gtk.Window.__init__(self, title="Entry Completion Test")
        self.set_default_size(300, 100)

        # 创建Entry和数据模型
        self.entry = Gtk.Entry()
        self.liststore = Gtk.ListStore(str)
        # 填充示例数据
        for item in ["Apple", "Banana", "Cherry", "Date", "Elderberry"]:
            self.liststore.append([item])

        # 配置EntryCompletion
        self.completion = Gtk.EntryCompletion()
        self.completion.set_model(self.liststore)
        self.completion.set_text_column(0)
        # 设置自定义匹配函数
        self.completion.set_match_func(self.match_func, None)
        self.entry.set_completion(self.completion)

        # 绑定焦点事件触发空输入补全
        self.entry.connect("focus-in-event", self.on_entry_focus_in)

        # 布局容器
        box = Gtk.Box(orientation=Gtk.Orientation.VERTICAL, spacing=10)
        box.set_border_width(10)
        box.add(self.entry)
        self.add(box)

    def match_func(self, completion, key, iter, data):
        model = completion.get_model()
        item_text = model[iter][0]
        if not key:
            return True
        return item_text.lower().startswith(key.lower())

    def on_entry_focus_in(self, entry, event):
        if not entry.get_text():
            self.completion.complete()
        return False

小提示 #

• 如果你想要模糊匹配（比如输入字符出现在条目任意位置都能匹配），可以把匹配逻辑改成return key.lower() in item_text.lower()。
• 除了焦点事件，你也可以绑定button-press-event（点击输入框时触发），或者根据自己的需求选择触发时机。

内容的提问来源于stack exchange，提问作者Lou K.