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)：输入法调用

【PyQt】QWidget