概述

在这里插入图片描述

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)

控件尺寸

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

在这里插入图片描述

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

事件

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

焦点和交互

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

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

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

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

功能总结

Context	Functions and Properties
窗口函数	`show()` , `hide()` , `raise()` , `lower()` , `close()` .
顶级窗口函数	`windowModified` , `windowTitle` , `windowIcon` , `isActiveWindow` , `activateWindow()` , `minimized` , `showMinimized()` , `maximized` , `showMaximized()` , `fullScreen` , `showFullScreen()` , `showNormal()` .
窗口内容	`update()` , `repaint()` , `scroll()` .
位置	`pos` , `x()` , `y()` , `rect` , `size` , `width()` , `height()` , `move()` , `resize()` , `sizePolicy` , `sizeHint()` , `minimumSizeHint()` , `updateGeometry()` , `layout()` , `frameGeometry` , `geometry` , `childrenRect` , `childrenRegion` , `adjustSize()` , `mapFromGlobal()` , `mapToGlobal()` , `mapFromParent()` , `mapToParent()` , `maximumSize` , `minimumSize` , `sizeIncrement` , `baseSize` , `setFixedSize()`
模式	`visible` , `isVisibleTo()` , `enabled` , `isEnabledTo()` , `modal` , `isWindow()` , `mouseTracking` , `updatesEnabled` , `visibleRegion()` .
外观	`style()` , `setStyle()` , styleSheet , `cursor` , font , `palette` , `backgroundRole()` , `setBackgroundRole()` , `fontInfo()` , `fontMetrics()` .
键盘和焦点	`focus` , `focusPolicy` , `setFocus()` , `clearFocus()` , `setTabOrder()` , `setFocusProxy()` , `focusNextChild()` , `focusPreviousChild()` .
鼠标和键盘	`grabMouse()` , `releaseMouse()` , `grabKeyboard()` , `releaseKeyboard()` , `mouseGrabber()` , `keyboardGrabber()` .
事件处理	`event()` , `mousePressEvent()` , `mouseReleaseEvent()` , `mouseDoubleClickEvent()` , `mouseMoveEvent()` , `keyPressEvent()` , `keyReleaseEvent()` , `focusInEvent()` , `focusOutEvent()` , `wheelEvent()` , `enterEvent()` , `leaveEvent()` , `paintEvent()` , `moveEvent()` , `resizeEvent()` , `closeEvent()` , `dragEnterEvent()` , `dragMoveEvent()` , `dragLeaveEvent()` , `dropEvent()` , `childEvent()` , `showEvent()` , `hideEvent()` , `customEvent()` . `changeEvent()` ,
系统函数	`parentWidget()` , `window()` , `setParent()` , `winId()` , `find()` , `metric()` .
菜单	`contextMenuPolicy` , `contextMenuEvent()` , `customContextMenuRequested()` , `actions()`
交互提示	`setToolTip()` , `setWhatsThis()`