【超详细教程】PyQt学习（三）QWidget介绍_pyqt qwidget

概述

大家好，我们的gzh是朝阳三只大明白，满满全是干货，分享近期的学习知识以及个人总结（包括读研和IT），跪求一波关注，希望和大家一起努力、进步！！

QWidget 类是所有 Qt GUI 界面类的基类，是 PyQt 程序中的最小元素，也就是所有可现实的控件的基类。一个继承自 QWidget 的类可以在屏幕上绘制自身，这是因为 QWidget 继承了 QPaintDevice 类，该类用于将控件绘制在屏幕上。每一个可视控件都是矩形的且都按 Z 顺序排序，一个空间的显示会被自己的父类（指定的 parent）和其他控件进行阻挡。

未嵌入到窗口的可视控件称之为窗口，例如 QDialog 和 QMainWindow。

重要属性和功能

位置和大小

QWidget 类最重要的功能是提供了控件的显示，显示依赖于两个属性位置和大小，在 PyQt 框架中，控件坐标系统以左上角为原点，向右为 X 轴的正方向，向下为 Y 轴正方向建立。

每个控件都有一个边框，因此在高度、位置的设置和获取上，都有两种方式，即包含边框和不包含边框。

包含框架的位置获取方法：

• x()：获取相对于父控件的 X 位置（没有父控件则相对于桌面）；
• y()：相对于父控件的 Y 位置（没有父控件则相对于桌面）；
• pos()：x 和 y 的组合方法，返回QPoint对象。

不包含框架的位置获取方法：

• geometry().x()：获取相对于父控件的 X 位置；
• geometry().y()：获取相对于父控件的 Y 位置；
• geometry()：获取用户区域相对于父控件的位置和尺寸。

包含框架的大小获取方法：

• frameGeometry().width()：获取控件的宽度；
• frameGeometry().height()：获取控件的高度；
• frameGeometry()：获取控件尺寸。

不包含框架的大小获取方法：

• width()：获取控件的宽度；
• height()：获取控件的高度；
• rect()：获取控件宽高。

设置位置和大小

• resize()：设置控件的大小（不包含边框）；
• move()：移动控件（包括框架）；
• setFixedSize()：设置控件固定尺寸。

除了直接给定控件大小，还可以设置大小的上下限，相关方法介绍如下：

• minimumwidth()：获取最小宽度；
• minimumheight()：获取最小高度；
• minimumsize()：上面两个方法的结合；
• maxmumwidth()：获取最小宽度；
• maxmumheight()：获取最小高度；
• maxmumsize()：上面两个方法的结合方法。

控件层级

没有父窗口小部件的窗口小部件始终是一个独立窗口，对于这些控件，可以调用 setWindowTitle() 和 setWindowIcon() 设置标题栏和图标。QWidget 类本身提供了这些方法，但是如果不是顶级控件，调用这些方法会失效。如下图所示，QGroupBox是父控件，其余的 QLabel、QDateEdit 等控件都受它的管理。

子控件的生命周期和父控件一致，在创建任何一个控件的时候传递一个 QWidget 子类实例作为新创建的控件的父控件。例如 self.widget_2 = QtWidgets.QWidget(self.centralwidget)，在 QWidget 类中提供了几个方法用于管理父子关系

• childAt()：获取在指定坐标位置的子控件；
• parentWidget()：获取指定控件的父控件；
• childreanRect()：获取所有子控件组成的边界矩形。

除了这种父子的层级关系，控件之间在 Z 轴上还有一种层级关系，QWidget 提供了一些方法用来管理这种关系：

• lower()：将控件放到最底层；
• raise()：将控件放到最上层；
• a.stackunder(b)：将 a 控件放到指定控件 b 之下。

绘制自定义控件

由于 QWidget 是 QPaintDevice 的子类，因此子类可使用 QPainter 类的实例使用一系列绘画操作，所以如果想要创建自己的控件，最好继承自 QWidget 类。

每一个控件都有一个 paintEvent() 方法，在这个函数中执行所有的绘制操作，每当需要重绘控件的时候都会调用该方法。一般的处理方案如下：

def paintEvent(self, a0: QPaintEvent) -> None:  
    ... # 自定义操作
    super(MainWindow, self).paintEvent(a0)

1
2
3
4

控件尺寸

除了直接指定大小、最大、最小长宽之外，QWidget 还提供了尺寸策略，这个主要用于在布局情况下，多个子控件之间的大小调整，尺寸策略的可选值如下：

默认情况下，顶级控件的大小被限制为桌面高度和宽度的 23\frac{2}{3}32​ 。

事件

在 PyQt 中控件和用户的交互一般通过事件，有一个消息队列不断接收程序产生的事件信息，并将其包装为QEvent对象进行分发处理。针对不同类型的QEvent对象，每个控件都有对应的处理函数，比方说 moveEvent() 用于处理窗口移动事件；enterEvent() 用于处理鼠标光标进入事件。

焦点和交互

控制状态就是获取焦点的状态，一个控件只有获取了焦点的控件才能进行交互，针对焦点，QWidget 提供了如下函数进行管理；

• setFocus()：指定控件获取焦点；
• setFocusPolicy()：设置获取焦点的策略；
• focuswidget()：获得子控件中当前聚焦的控件；
• focusNextChild()：聚焦下一个子控件；
• setTabOrder()：设置子控件获取焦点的顺序。

针对交互，QWdiget 也提供了相应的方法：

• setEnabled()：指定控件是否可用；
• isEnabled()：返回控件是否可用；
• isvisible()：代表了控件的最终状态，即使被其他控件遮挡也算看的见；
• isHidden()：代表该控件是否对父控件可见。

---------------------------END---------------------------

题外话

感兴趣的小伙伴，赠送全套Python学习资料，包含面试题、简历资料等具体看下方。