【PyQt】QWidget

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__ 

基于父控件创建子控件：


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)

    不跟踪：鼠标移动时，必须处于按下状态，才会触发 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)：窗体、字体改变时调用