PyQt 窗口焦点：选择当前交互的窗口

我是麦叔

于 2024-01-06 19:13:19 发布

阅读量1.1k

点赞数 7

文章标签： pyqt python

本文链接：https://blog.csdn.net/weixin_40646871/article/details/135430426

版权

窗口焦点的概念

PyQt中的窗口焦点是指当前接收键盘和鼠标事件的窗口或部件。通常情况下，只有一个窗口或部件能够成为焦点，其他窗口或部件则会失去焦点。无论是输入文本、执行特定操作，还是浏览导航控件，焦点窗口的存在都大大提升了用户的操作体验。在某些情况下，我们可能需要手动控制窗口焦点，以确保用户的交互顺序和期望行为能够得到满足。

获取焦点

在PyQt中，要使特定的窗口或部件获得焦点，我们可以使用setFocus()方法。这个方法会将焦点设置给指定的窗口或部件，使其成为当前活动窗口。以下是一个示例代码片段，展示了如何将焦点设置给一个按钮部件：

button = QPushButton("Click me")  
button.setFocus()

在这个例子中，我们创建了一个按钮部件，并使用setFocus()方法将其设置为焦点。这样，当应用程序运行时，用户将能够直接与这个按钮进行交互，例如通过键盘进行点击操作。

自动切换焦点

PyQt中的窗口管理器会根据默认的焦点顺序自动切换焦点。这个默认的焦点顺序是基于窗口部件的添加顺序和层次结构来确定的。也就是说，后添加的部件通常会获得焦点。当用户使用Tab键或向下导航键时，焦点会自动切换到下一个窗口或部件。

如果你想自定义焦点切换的顺序，可以使用setTabOrder()方法。这个方法允许你指定一个窗口部件的焦点切换顺序。例如，如果你想设置两个按钮部件的焦点切换顺序为button1 -> button2，你可以这样写：

button1 = QPushButton("Button 1")  
button2 = QPushButton("Button 2")  
button1.setTabOrder(button1, button2)

这样，当用户按下Tab键并依次通过窗口部件时，焦点将首先移至button1，然后自动切换到button2。

手动切换焦点

除了自动切换焦点的机制，我们还可以根据某些特定事件或条件来手动控制焦点的切换。PyQt提供了以下方法用于焦点切换：

setFocus(): 将焦点设置给指定的窗口或部件。这个方法会立即将焦点转移到指定的窗口或部件，使其成为活动窗口。
clearFocus(): 从当前窗口或部件清除焦点。这个方法将焦点从当前窗口或部件移除，使其不再接收键盘和鼠标事件。
nextInFocusChain(): 获取下一个窗口或部件的焦点。这个方法用于在窗口或部件之间进行焦点切换，尤其是在用户按下Tab键时。
previousInFocusChain(): 获取上一个窗口或部件的焦点。这个方法用于逆向切换焦点，通常在用户按下Shift+Tab键时使用。

from PyQt5.QtWidgets import QApplication, QWidget, QLineEdit, QVBoxLayout

app = QApplication([])
window = QWidget()

layout = QVBoxLayout()
line1 = QLineEdit()
line2 = QLineEdit()
line3 = QLineEdit()

layout.addWidget(line1)
layout.addWidget(line2)
layout.addWidget(line3)
window.setLayout(layout)
window.show()

def on_return_pressed():
    # 当用户按下回车键时，将焦点切换到下一个文本框
    current_line = window.focusWidget()
    next_line = current_line.nextInFocusChain()
    next_line.setFocus()

line1.returnPressed.connect(on_return_pressed)
line2.returnPressed.connect(on_return_pressed)
line3.returnPressed.connect(on_return_pressed)

app.exec_()

监听焦点变化

除了设置和切换焦点，我们还可以监听焦点的变化。PyQt提供了focusInEvent()和focusOutEvent()这两个方法，用于在窗口或部件获得和失去焦点时执行特定的操作。

当我们重写这些方法时，可以在窗口或部件获得焦点时执行某些操作，或在失去焦点时执行其他操作。例如，我们可以使用这些方法来触发特定的信号或执行自定义的逻辑，以满足应用程序的需求。

from PyQt5.QtWidgets import QApplication, QWidget, QPushButton  
from PyQt5.QtCore import QCoreApplication  
  
class MyWidget(QWidget):  
    def __init__(self):  
        super().__init__()  
        self.initUI()  
  
    def initUI(self):  
        self.setWindowTitle('焦点监听示例')  
        self.resize(400, 300)  
  
        self.button = QPushButton('点击我', self)  
        self.button.move(100, 100)  
        self.button.focusInEvent = self.on_focus_in  
        self.button.focusOutEvent = self.on_focus_out  
  
    def on_focus_in(self, event):  
        print('按钮获得焦点')  
  
    def on_focus_out(self, event):  
        print('按钮失去焦点')  
  
if __name__ == '__main__':  
    app = QApplication([])  
    widget = MyWidget()  
    widget.show()  
    app.exec_()

在这个例子中，我们创建了一个自定义的QWidget类，并在其中重写了focusInEvent()和focusOutEvent()方法。当按钮获得焦点时，on_focus_in()方法会被调用，并打印出"按钮获得焦点"；当按钮失去焦点时，on_focus_out()方法会被调用，并打印出"按钮失去焦点"。通过这种方式，我们可以监听焦点变化，并根据需要执行特定的操作。