一、常用API

1、大小与位置:
  x():相对于父控件的位置,顶层控件(没有父控件)则相对于桌面的x位置
  y():相对于父控件的y位置,顶层控件(没有父控件)则相对于桌面的y位置
  pos():x和y的组合 QPoint(x, y)
  width():控件的宽度,不包含任何窗口框架
  height():控件的高度,不包含任何窗口框架
  size():width和height的组合 ,QSize(width, height)
  geometry():用户区域相对于父控件的位置和尺寸组合 QRect(x, y, width, height)
  rect():0, 0, width, height的组合 QRect(0, 0, width, height)
  frameSize():框架大小
  frameGeometry():框架尺寸
  move(x, y):操控的是x, y;也就是pos 包括窗口框架
  resize(width, height):操控的是宽高 不包括窗口框架
  setGeometry(x_noFrame, y_noFrame, width, height):
  adjustSize():根据内容自适应大小
  setFixedSize():设置固定尺寸


2、最大和最小尺寸:
  minimumWidth():最小尺寸的宽度
  minimumHeight():最小尺寸的高度
  minimumSize():最小尺寸
  maximumWidth():最大尺寸的宽度
  maximumHeight():最大尺寸的高度
  maximumSize():最大尺寸
  setMaximumWidth():
  setMaximumHeight():
  setMinimumWidth():
  setMinimumHeight():
  setMinimumSize()


3、设置内容边距:
  setContentsMargins(左, 上, 右, 下)
  getContentsMargins():获取内容边距
  contentsRect():获取内容区域


4、鼠标相关:
  setCursor():设置鼠标形状
  unsetCursor():重置鼠标
  cursor() -> QCursor:获取鼠标
  hasMouseTracking():判定是否设置了鼠标跟踪
  setMouseTracking(bool):设置鼠标是否跟踪 。所谓的鼠标跟踪,其实就是设置检测鼠标移动事件的条件


5、事件相关:
  showEvent(QShowEvent):控件显示时调用
  closeEvent(QCloseEvent):控件关闭时调用
  moveEvent(QMoveEvent):控件移动时调用
  resizeEvent(QResizeEvent):控件调整大小时调用
  enterEvent(QEvent):鼠标进入时触发
  leaveEvent(QEvent):鼠标离开时触发
  mousePressEvent(QMouseEvent):
  mouseReleaseEvent(QMouseEvent):
  mouseDoubleClickEvent(QMouseEvent)
  mouseMoveEvent(QMouseEvent):鼠标按下后移动时触发
  keyPressEvent(QKeyEvent):键盘按下时调用
  keyReleaseEvent(QKeyEvent):
  focusInEvent(QFocusEvent):获取焦点时调用
  focusOutEvent(QFocusEvent):失去焦点时调用
  dragEnterEvent(QDragEnterEvent):拖拽进入控件时调用
  dragLeaveEvent(QDragLeaveEvent):拖拽离开控件时调用
  dragMoveEvent(QDragMoveEvent):拖拽在控件内移动时调用
  dropEvent(QDropEvent):拖拽放下时调用
  paintEvent(QPaintEvent):显示控件, 更新控件时调用
  changeEvent(QEvent):窗体改变, 字体改变时调用
  contextMenuEvent(QContextMenuEvent):访问右键菜单时调用
  inputMethodEvent(QInputMethodEvent):输入法调用


6、父子关系:
  childAt(x, y):获取在指定坐标的控件。(根据当前点击的坐标获取子控件)
  parentWidget():获取指定控件的父控件
  childrenRect():所有子控件组成的边界矩形

from PyQt5.Qt import *
import sys

class Window(QWidget):
    def mousePressEvent(self, evt):
        click_x = evt.x()
        click_y = evt.y()
        # 根据当前点击的坐标获取子控件
        child = self.childAt(click_x, click_y)
        if child is not None:
            child.setStyleSheet('background-color: green')

if __name__ == '__main__':
    app = QApplication(sys.argv)
    window = Window()
    window.setWindowTitle('QWidget')
    window.resize(500, 400)
    
    label1 = QLabel(window)
    label1.setText('label1')
    
    label2 = QLabel(window)
    label2.setText('label2')
    label2.move(100, 100)
    
    window.show()
    sys.exit(app.exec_())

 

7、层级控制:注意:以下操作专指同级控件
  lower():将控件降低到最底层
  raise下划线():将控件提升到最上层
  a.stackUnder(b):让a放在b下面

from PyQt5.Qt import *
import sys

class Label(QLabel):
    def mousePressEvent(self, evt):
        # 将控件提升到最上层
        self.raise_()

if __name__ == '__main__':
    app = QApplication(sys.argv)
    window = QWidget()
    window.setWindowTitle('层级关系调整')
    window.resize(500, 500)
    
    label1 = Label(window)
    label1.setText('QLabel1')
    label1.resize(200, 200)
    label1.setStyleSheet('background-color: red')
    
    label2 = Label(window)
    label2.setText('QLabel2')
    label2.resize(200, 200)
    label2.setStyleSheet('background-color: green')
    label2.move(100, 100)
    
    window.show()
    sys.exit(app.exec_())


8、顶层窗口相关:
  setWindowIcon(QIcon("resource/header_icon.png")):
  windowIcon():
  setWindowTitle("社会我顺哥"):
  windowTitle():
  setWindowOpacity(float):不透明度
  windowOpacity():
  setWindowState(state):设置窗口的状态
  showFullScreen():
  showMaximized():
  showNormal():正常
  isMinimized():是否是最小化窗口
  isMaximized():是否是最大化窗口
  isFullScreen():是否全屏
  window.setWindowFlags(Qt.WindowStaysOnTopHint):窗口样式

from PyQt5.Qt import *
import sys

class Window(QWidget):
    def __init__(self):
        super().__init__()
        
    def mousePressEvent(self, evt):
        # 判断窗口是否最大化
        if self.isMaximized():
            # 设置最小化
            self.showNormal()
        else:
            # 设置最大化
            self.showMaximized()

if __name__ == '__main__':
    app = QApplication(sys.argv)
    window = Window()
    window.setWindowTitle('QWidget-窗口相关的操作')
    window.show()
    sys.exit(app.exec_())


9、交互状态:
  setEnabled(bool):设置控件是否禁用
  isEnabled():获取控件是否可用
  setVisible(bool):
  isHidden():
  isVisible():
  isVisibleTo(widget):
  setWindowModified(bool):是否编辑
  isWindowModified():
  isActiveWindow():是否为活跃窗口
  close():

from PyQt5.Qt import *
import sys

class Window(QWidget):
    def __init__(self):
        super().__init__()
        self.setWindowTitle('QWidget-交互状态')
        self.setGeometry(0,0, 500, 400)
        self.setup_ui()
    
    def setup_ui(self):
        edit = QLineEdit(self)
        btn = QPushButton(self)
        btn.setText('按钮')
        btn.setDisabled(True)
        btn.move(0,100)
        def change(text):
            btn.setDisabled((not len(text) > 0))
        edit.textChanged.connect(change)

if __name__ == '__main__':
    app = QApplication(sys.argv)
    window = Window()
    window.show()
    sys.exit(app.exec_())

 

10、信息提示:
  statusTip():状态提示
  setStatusTip(str):
  toolTip():工具提示
  setToolTip(str):
  setWhatsThis(str):这是啥提示
  whatsThis():


11、焦点控制:
  setFocus():指定控件获取焦点
  setFocusPolicy(Policy):设置焦点获取策略
  Qt.TabFocus:通过Tab键获得焦点
  Qt.ClickFocus:通过被单击获得焦点
  Qt.StrongFocus:可通过上面两种方式获得焦点
  Qt.NoFocus:不能通过上两种方式获得焦点(默认值),setFocus仍可使其获得焦点
  clearFocus():取消焦点


12、不太重要的方法:
  setAttribute(Qt :: WidgetAttribute 属性,bool on = true):属性
  QWidget :: mask()const:遮罩 返回当前在小部件上设置的遮罩。如果没有设置掩码,返回值将是一个空白区域。


13、信号:
  windowTitleChanged(QString):窗口标题改变信号
  windowIconChanged(QIcon):窗口图标改变信号
  customContextMenuRequested(QPoint):自定义上下文菜单请求信号