PyWebView窗口焦点事件异常问题分析与解决方案

问题背景

在使用PyWebView开发桌面应用时，开发者发现窗口焦点事件存在异常触发行为。具体表现为：当窗口失去焦点后重新获得焦点时，会依次触发focus、blur、focus三个事件，而正常情况下应该只触发一次focus事件。

问题复现

通过以下代码可以复现该问题：

import webview

def preload(window):
    window.evaluate_js('window.onblur = ()=>{pywebview.api.log("blur")}')
    window.evaluate_js('window.onfocus = ()=>{pywebview.api.log("focus")}')

class RuntimeApi:
    def log(self, message):
        print(message)

if __name__ == '__main__':
    window = webview.create_window('test', js_api=RuntimeApi())
    webview.start(preload, window)

问题原因分析

经过深入分析，发现问题根源在于PyWebView的Windows平台实现中on_activated事件处理逻辑。在winforms.py文件的235行附近，当窗口被激活时，框架会自动调用SetWindowLongW设置窗口样式，并尝试将焦点设置到浏览器控件上。

这种自动获取焦点的行为导致了焦点事件的连锁反应：

1. 窗口首次获得焦点，触发focus事件
2. 框架内部再次设置焦点，导致浏览器控件先失去焦点(触发blur)
3. 然后重新获得焦点(再次触发focus)

解决方案

通过修改on_activated方法的实现可以解决这个问题。具体修改如下：

def on_activated(self, *_):
    if not self.pywebview_window.focus:
        windll.user32.SetWindowLongW(self.Handle.ToInt32(), -20, 
                                   windll.user32.GetWindowLongW(self.Handle.ToInt32(), -20) | 0x8000000)
    elif self.browser:
        pass  # 注释掉自动获取焦点的代码
        # self.browser.web_view.Focus()

    if is_cef and self.pywebview_window.focus:
        CEF.focus(self.uid)

技术原理

在Windows平台下，窗口焦点管理是一个复杂的过程。PyWebView为了确保Web内容能够正确接收输入，会在窗口激活时自动将焦点设置到嵌入式浏览器控件上。然而这种自动行为在某些情况下会干扰正常的焦点事件流。

通过移除自动获取焦点的代码，我们让系统自然地处理焦点转移过程，避免了不必要的事件触发。这种修改保持了功能完整性的同时，提供了更符合预期的行为。

影响评估

该修改主要影响：

1. 焦点事件的行为更加符合开发者预期
2. 不会影响其他功能的正常工作
3. 对于依赖焦点事件的应用(如实时编辑器、游戏等)尤为重要

最佳实践

对于需要在PyWebView中处理焦点事件的开发者，建议：

1. 明确区分用户触发的焦点变化和程序控制的焦点变化
2. 在事件处理函数中加入防抖逻辑，避免重复处理
3. 测试不同场景下的焦点行为，确保应用在各种情况下都能正常工作

总结

窗口焦点管理是桌面应用开发中的重要环节。PyWebView的这一修改使其行为更加符合Web开发者的预期，减少了意外事件触发带来的困扰。开发者现在可以更可靠地使用onfocus和onblur事件来构建响应式的用户界面。