QWidget 是所有可視化控件的基類
其中胧华,控件即為用戶界面中的最小元素(接收各種鼠標(biāo)秦爆、鍵盤(pán)等事件)
控件都是矩形的序愚,按Z軸順序排列的憔披。
不擁有父控件的控件為窗口等限。
控件被同級(jí)新建控件覆蓋。
QWidget 繼承自 QtCore.QObject 和 QtGui.QPaintDevice
print(QWidget.__bases__)
print(QWidget.mro())
創(chuàng)建 QWidget 時(shí)調(diào)用的方法:
def __init__(self, parent=None, flags, Qt_WindowFlags=None, Qt_WindowType=None, *args, **kwargs):
# real signature unknown; NOTE: unreliably restored from __doc__
pass
基于父控件創(chuàng)建子控件:
base = QWidget()
red = QWidget(base)
red.resize(100, 100)
red.setStyleSheet("background-color: red;")
控件以左上角為坐標(biāo)原點(diǎn)芬膝,向右為 x 軸正方向望门,向下為 y 軸正方向
控件顯示完畢之后,具體的位置尺寸信息才會(huì)正確
-
.x()
相對(duì)于父控件的 x 位置(包含窗口框架) -
.y()
相對(duì)于父控件的 y 位置 -
.pos
坐標(biāo) -
width()
:寬度 -
height()
:高度 -
size
:QSize(width, height) -
geometry()
:QRect(x, y, width, height)锰霜,用戶區(qū)域相對(duì)于父控件的位置和尺寸 -
rect
:QRect(0, 0, width, height) frameSize
frameGeometry
位置尺寸的設(shè)置
-
.move(x, y)
:移動(dòng)窗口位置 -
.resize(width, height)
:重置用戶區(qū)域尺寸(有最小尺寸限制) - `.setGeometry(x_noFrame, y_noFrame, width, height):設(shè)置用戶區(qū)域筹误,在顯示之后設(shè)置
-
.adjustSize()
:自適應(yīng)尺寸 -
.setFixedSize(width, height)
:固定尺寸
案例:創(chuàng)建一個(gè)窗口,設(shè)置尺寸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() # 顯示當(dāng)前控件及其所有子控件
sys.exit(app.exec_())
案例:在窗口內(nèi)按九宮格布局(一行三列)創(chuàng)建給定個(gè)數(shù)的子控件
# 總的控件個(gè)數(shù)
widget_count = 100
# 一行有多少列
column_count = 3
# 計(jì)算一個(gè)控件的寬度
widget_width = window.width() / column_count
# 總共有多少行 (編號(hào) // 一行多少列 + 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()
最大/小尺寸限制
設(shè)置尺寸
-
.setMaximumWidth()
/.setMinimumWidth()
-
.setMaximumHeight()
/.setMinimumHeight()
-
.setMaximumSize()
/.setMinimumSize()
獲取尺寸
-
.maximumWidth()
/.minimumWidth()
-
.maximumHeight()
/.minimumHeight()
-
.maximumSize()
/.minimumSize()
當(dāng)已限定尺寸厨剪,再 resize
時(shí),實(shí)際上無(wú)法修改尺寸
內(nèi)容邊距
設(shè)置內(nèi)容邊距:.setContentsMargins(左, 上, 右, 下)
獲取內(nèi)容邊距:.getContentsMargins()
友存,返回一個(gè) (左, 上, 右, 下)
的元組
獲取內(nèi)容區(qū)域:.contentsRect()
鼠標(biāo)控制
-
設(shè)置鼠標(biāo)形狀
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 對(duì)象
pixmap = QPixmap("xxx.png") scaled = pixmap.scaled(50, 50) cursor = QCursor(scaled) window.setCursor(cursor)
重置鼠標(biāo)形狀:
.unsetCursor()
-
獲取鼠標(biāo):
.cursor()
祷膳,返回 QCursor
QCursor 對(duì)象的方法:-
.pixmap()
:鼠標(biāo)的圖形 -
.pos()
:獲取鼠標(biāo)相對(duì)于整個(gè)屏幕的位置 setPos(x,y)
-
鼠標(biāo)跟蹤
hasMouseTracking()
:判定是否設(shè)置了鼠標(biāo)跟蹤
setMouseTracking(bool)
:設(shè)置鼠標(biāo)是否跟蹤
不跟蹤:鼠標(biāo)移動(dòng)時(shí),必須處于按下?tīng)顟B(tài)屡立,才會(huì)觸發(fā) mouseMoveEvent 事件
跟蹤:鼠標(biāo)移動(dòng)時(shí)直晨,不處于按下?tīng)顟B(tài),也會(huì)觸發(fā) MouseMoveEvent 事件
案例:在 label 中實(shí)時(shí)跟蹤鼠標(biāo)位置
import sys
from PyQt5.Qt import *
class Window(QWidget):
def mouseMoveEvent(self, mv):
print("鼠標(biāo)移動(dòng)", mv.localPos())
label = self.findChild(QLabel)
x = mv.localPos().x()
y = mv.localPos().y()
label.move(x, y)
label.setText("當(dāng)前坐標(biāo):({}, {})".format(x, y))
app = QApplication(sys.argv)
window = Window()
window.setWindowTitle("實(shí)時(shí)鼠標(biāo)跟蹤")
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("當(dāng)前坐標(biāo):(x, y)")
label.resize(200, 50)
label.move(100, 100)
label.setStyleSheet("background-color: cyan;")
window.show()
sys.exit(app.exec_())
事件消息
顯示/關(guān)閉 event:
.showEvent(QShowEvent)
,控件顯示時(shí)調(diào)用勇皇;.closeEvent(QCloseEvent)
罩句,控件關(guān)閉時(shí)調(diào)用移動(dòng) event:
.moveEvent(QMoveEvent)
,控件移動(dòng)時(shí)調(diào)用調(diào)整尺寸 event:
.resizeEvent(QResizeEvent)
敛摘,控件調(diào)整尺寸時(shí)調(diào)用-
鼠標(biāo)事件
-
enterEvent(QEvent)
:鼠標(biāo)進(jìn)入控件范圍內(nèi)時(shí)觸發(fā) -
leaveEvent(QEvent)
:鼠標(biāo)離開(kāi)控件范圍內(nèi)時(shí)觸發(fā) -
mousePressEvent(QMouseEvent)
:鼠標(biāo)按下時(shí)觸發(fā) -
mouseReleaseEvent(QMouseEvent)
:鼠標(biāo)釋放時(shí)觸發(fā) -
mouseDoubleClickEvent(QMouseEvent)
:鼠標(biāo)雙擊時(shí)觸發(fā) -
mouseMoveEvent(QMouseEvent)
:鼠標(biāo)按下后移動(dòng)時(shí)觸發(fā)门烂,設(shè)置setMouseTracking(True)
后也可追蹤未按下的移動(dòng)
-
-
鍵盤(pán)事件
-
keyPressEvent(QKeyEvent)
:按鍵按下時(shí)調(diào)用 -
keyReleaseEvent(QKeyEvent)
:案件釋放時(shí)調(diào)用
-
-
焦點(diǎn)事件
-
focusInEvent(QFocusEvent)
:獲取焦點(diǎn)時(shí)調(diào)用 -
focusOutEvent(QFocusEvent)
:失去焦點(diǎn)時(shí)調(diào)用
-
-
拖拽事件
-
dragEnterEvent(QDragEnterEvent)
:拖拽進(jìn)入控件時(shí)調(diào)用 -
dragLeaveEvent(QDragLeaveEvent)
:拖拽離開(kāi)控件時(shí)調(diào)用 -
dragMoveEvent(QDragMoveEvent)
:拖拽在控件內(nèi)移動(dòng)時(shí)調(diào)用 -
dropEvent(QDropEvent)
:拖拽放下時(shí)調(diào)用
-
繪制事件
paintEvent(QPaintEvent)
:顯示刷新控件時(shí)調(diào)用變更事件
changeEvent(QEvent)
:窗體、字體改變時(shí)調(diào)用右鍵菜單
contextMenuEvent(QContextMenuEvent)
:訪問(wèn)右鍵菜單時(shí)調(diào)用輸入法
inputMethodEvent(QInputMethodEvent)
:輸入法調(diào)用