QWidget 是所有可视化控件的基类
其中，控件即为用户界面中的最小元素（接收各种鼠标、键盘等事件）
控件都是矩形的，按Z轴顺序排列的。
不拥有父控件的控件为窗口。
控件被同级新建控件覆盖。

QWidget 继承自 QtCore.QObject 和 QtGui.QPaintDevice

print(QWidget.__bases__)
print(QWidget.mro())

创建 QWidget 时调用的方法：

def __init__(self, parent=None, flags, Qt_WindowFlags=None, Qt_WindowType=None, *args, **kwargs): 
    # real signature unknown; NOTE: unreliably restored from __doc__ 
    pass

基于父控件创建子控件：

base = QWidget()
red = QWidget(base)
red.resize(100, 100)
red.setStyleSheet("background-color: red;")

控件以左上角为坐标原点，向右为 x 轴正方向，向下为 y 轴正方向

控件显示完毕之后，具体的位置尺寸信息才会正确

• .x() 相对于父控件的 x 位置（包含窗口框架）
• .y() 相对于父控件的 y 位置
• .pos 坐标
• width()：宽度
• height()：高度
• size：QSize(width, height)
• geometry()：QRect(x, y, width, height)，用户区域相对于父控件的位置和尺寸
• rect：QRect(0, 0, width, height)
• frameSize
• frameGeometry

位置尺寸的设置

• .move(x, y)：移动窗口位置
• .resize(width, height)：重置用户区域尺寸（有最小尺寸限制）
• `.setGeometry(x_noFrame, y_noFrame, width, height)：设置用户区域，在显示之后设置
• .adjustSize()：自适应尺寸
• .setFixedSize(width, height)：固定尺寸

案例：创建一个窗口，设置尺寸500*500，位置 300, 300

import sys
from PyQt5.Qt import *

app = QApplication(sys.argv)

window = QWiget()

window.resize(500, 500) # 除去边框
window.move(300, 300) # 加上边框
window.show() # 显示当前控件及其所有子控件

sys.exit(app.exec_())

案例：在窗口内按九宫格布局（一行三列）创建给定个数的子控件

# 总的控件个数
widget_count = 100
# 一行有多少列
column_count = 3

# 计算一个控件的宽度
widget_width = window.width() / column_count
# 总共有多少行 (编号 // 一行多少列 + 1)
row_count = (widget_count - 1) // column_count + 1
widget_height = window.height() / row_count

for i in range(0, widget_count):
    w = QWidget(window)
    w.resize(widget_width, widget_height)
    widget_x = i % column_count * widget_width
    widget_y = i // column_count * widget_height
    w.move(widget_x, widget_y)
    w.setStyleSheet("background-color: red;border: 1px solid yellow;")
    w.show()

最大/小尺寸限制

设置尺寸

• .setMaximumWidth() / .setMinimumWidth()
• .setMaximumHeight() / .setMinimumHeight()
• .setMaximumSize() / .setMinimumSize()

获取尺寸

• .maximumWidth() / .minimumWidth()
• .maximumHeight() / .minimumHeight()
• .maximumSize() / .minimumSize()

当已限定尺寸，再 resize 时，实际上无法修改尺寸

内容边距

设置内容边距：.setContentsMargins(左, 上, 右, 下)
获取内容边距：.getContentsMargins()，返回一个 (左, 上, 右, 下) 的元组
获取内容区域：.contentsRect()

鼠标控制

• 设置鼠标形状 setCursor()
  枚举类型：

  • Qt.ArrowCursor
  • Qt.UpArrowCursor
  • Qt.CrossCursor
  • Qt.IBeamCursor
  • Qt.WaitCursor
  • Qt.BusyCursor
  • Qt.ForbiddenCursor
  • Qt.PointingHandCursor
  • Qt.WhatsThisCursor
  • Qt.SizeVerCursor
  • Qt.SizeHorCursor
  • Qt.SizeBDiagCursor
  • Qt.SizeAllCursor
  • Qt.SplitVCursor
  • Qt.SplitHCursor
  • Qt.OpenHandCursor
  • Qt.ClosedHandCursor
  • Qt.BlankCursor
  • 自定义 QCursor 对象

    pixmap = QPixmap("xxx.png")
    scaled = pixmap.scaled(50, 50)
    cursor = QCursor(scaled)
    window.setCursor(cursor)
    

• 重置鼠标形状：.unsetCursor()

• 获取鼠标：.cursor()，返回 QCursor
  QCursor 对象的方法：

  • .pixmap()：鼠标的图形
  • .pos()：获取鼠标相对于整个屏幕的位置
  • setPos(x,y)

• 鼠标跟踪
  hasMouseTracking()：判定是否设置了鼠标跟踪
  setMouseTracking(bool)：设置鼠标是否跟踪

不跟踪：鼠标移动时，必须处于按下状态，才会触发 mouseMoveEvent 事件
跟踪：鼠标移动时，不处于按下状态，也会触发 MouseMoveEvent 事件

案例：在 label 中实时跟踪鼠标位置

import sys
from PyQt5.Qt import *

class Window(QWidget):
    def mouseMoveEvent(self, mv):
        print("鼠标移动", mv.localPos())
        label = self.findChild(QLabel)
        x = mv.localPos().x()
        y = mv.localPos().y()
        label.move(x, y)
        label.setText("当前坐标：({}, {})".format(x, y))

app = QApplication(sys.argv)

window = Window()
window.setWindowTitle("实时鼠标跟踪")
window.resize(500, 500)
window.move(200, 200)
window.setMouseTracking(True)

pixmap = QPixmap("xxx.png").scaled(50, 50)
cursor = QCursor(pixmap)
window.setCursor(cursor)

label = QLabel(window)
label.setText("当前坐标：(x, y)")
label.resize(200, 50)
label.move(100, 100)
label.setStyleSheet("background-color: cyan;")

window.show()
sys.exit(app.exec_())

事件消息

• 显示/关闭 event：.showEvent(QShowEvent)，控件显示时调用；.closeEvent(QCloseEvent)，控件关闭时调用

• 移动 event：.moveEvent(QMoveEvent)，控件移动时调用

• 调整尺寸 event：.resizeEvent(QResizeEvent)，控件调整尺寸时调用

• 鼠标事件

  • enterEvent(QEvent)：鼠标进入控件范围内时触发
  • leaveEvent(QEvent)：鼠标离开控件范围内时触发
  • mousePressEvent(QMouseEvent)：鼠标按下时触发
  • mouseReleaseEvent(QMouseEvent)：鼠标释放时触发
  • mouseDoubleClickEvent(QMouseEvent)：鼠标双击时触发
  • mouseMoveEvent(QMouseEvent)：鼠标按下后移动时触发，设置 setMouseTracking(True) 后也可追踪未按下的移动

• 键盘事件

  • keyPressEvent(QKeyEvent)：按键按下时调用
  • keyReleaseEvent(QKeyEvent)：案件释放时调用

• 焦点事件

  • focusInEvent(QFocusEvent)：获取焦点时调用
  • focusOutEvent(QFocusEvent)：失去焦点时调用

• 拖拽事件

  • dragEnterEvent(QDragEnterEvent)：拖拽进入控件时调用
  • dragLeaveEvent(QDragLeaveEvent)：拖拽离开控件时调用
  • dragMoveEvent(QDragMoveEvent)：拖拽在控件内移动时调用
  • dropEvent(QDropEvent)：拖拽放下时调用

• 绘制事件
  paintEvent(QPaintEvent)：显示刷新控件时调用

• 变更事件
  changeEvent(QEvent)：窗体、字体改变时调用

• 右键菜单
  contextMenuEvent(QContextMenuEvent)：访问右键菜单时调用

• 输入法
  inputMethodEvent(QInputMethodEvent)：输入法调用