mirror of
https://github.com/muziing/PySide6-Code-Tutorial.git
synced 2025-02-07 00:28:22 +08:00
83 lines
3.3 KiB
Python
83 lines
3.3 KiB
Python
import sys
|
||
|
||
from PySide6 import QtWidgets
|
||
|
||
"""
|
||
QWidget 键盘输入焦点控制
|
||
|
||
只有当前获得焦点的控件才能与用户交互
|
||
Qt提供了强大的焦点控制的API
|
||
键盘Tab键可以在控件间移动焦点，也可以用代码指定子控件获取焦点的先后顺序
|
||
|
||
对本控件的焦点的控制：
|
||
https://doc.qt.io/qt-6/qwidget.html#setFocus
|
||
.hasFocus() -> bool 返回此控件（或其焦点代理）是否具有键盘输入焦点
|
||
.setFocus() 槽函数，若其父控件为活动窗口，则为此控件（或其焦点代理）设置焦点
|
||
.setFocus(reason: Qt.FocusReason) Qt.FocusReason 详见下文
|
||
.clearFocus() 移除控件的焦点
|
||
|
||
对子控件的焦点的控制：
|
||
https://doc.qt.io/qt-6/qwidget.html#focusNextPrevChild
|
||
.focusNextChild() -> bool
|
||
.focusPreviousChild() -> bool
|
||
.focusNextPrevChild(next: bool) -> bool 上两种方法的结合，当next为True时向前搜索，否则向后搜索
|
||
.focusWidget() -> QWidget
|
||
|
||
|
||
Qt.FocusReason 具体分为如下数种：
|
||
https://doc.qt.io/qt-6/qt.html#FocusReason-enum
|
||
- Qt.MouseFocusReason 鼠标活动导致
|
||
- Qt.TabFocusReason 按下了Tab键
|
||
- Qt.BacktabFocusReason Backtab导致，例如按下Shift+Tab键
|
||
- Qt.ActiveWindowFocusReason 窗口系统使该窗口处于活动或非活动状态
|
||
- Qt.PopupFocusReason 应用程序打开/关闭一个弹出窗口，该弹出窗口抓取/释放键盘焦点
|
||
- Qt.ShortcutFocusReason 用户输入了一个标签的伙伴快捷键（参阅QLabel.buddy）
|
||
- Qt.MenuBarFocusReason 菜单栏获得了焦点
|
||
- Qt.OtherFocusReason 其他原因
|
||
|
||
"""
|
||
|
||
|
||
class MyWidget(QtWidgets.QWidget):
|
||
def __init__(self, *args, **kwargs):
|
||
super().__init__(*args, **kwargs)
|
||
self.setWindowTitle("QWidget-焦点控制")
|
||
self.resize(800, 600)
|
||
self.setup_ui()
|
||
self.test_01()
|
||
|
||
def setup_ui(self) -> None:
|
||
"""设置界面"""
|
||
self.button = QtWidgets.QPushButton("测试按钮", self)
|
||
self.button.move(200, 200)
|
||
|
||
# 单行文本编辑器，当获得焦点时可以输入内容
|
||
self.le = QtWidgets.QLineEdit(self)
|
||
self.le.move(350, 100)
|
||
|
||
# 下拉菜单，当获得焦点时可以用键盘方向键上下切换当前所选
|
||
self.cbb = QtWidgets.QComboBox(self)
|
||
self.cbb.addItem("选项1")
|
||
self.cbb.addItem("选项2")
|
||
self.cbb.move(500, 100)
|
||
|
||
# 纯文本编辑器，当获得焦点时可以输入内容
|
||
self.pte = QtWidgets.QPlainTextEdit(self)
|
||
self.pte.setTabChangesFocus(True) # 将纯文本编辑器中按下Tab键功能设置为切换焦点
|
||
self.pte.move(350, 150)
|
||
|
||
def test_01(self):
|
||
"""测试设置焦点功能"""
|
||
# self.button.clicked.connect(self.pte.setFocus) # type: ignore
|
||
self.button.clicked.connect(self.focusNextChild) # type: ignore
|
||
self.button.clicked.connect(lambda: print(self.button.hasFocus())) # type: ignore
|
||
self.button.clicked.connect(lambda: print(self.le.hasFocus())) # type: ignore
|
||
self.button.clicked.connect(lambda: print(self.focusWidget())) # type: ignore
|
||
|
||
|
||
if __name__ == "__main__":
|
||
app = QtWidgets.QApplication(sys.argv)
|
||
window = MyWidget()
|
||
window.show()
|
||
sys.exit(app.exec())
|