Add 03-01-08

03-QtWidgets-常用控件/01-QWidget-控件的基类/08-QWidget-键盘输入焦点-1.py

@@ -0,0 +1,82 @@
+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())