PyQt5中FramelessWindowHint与WindowStaysOnTopHint联用失效及setMask报错

首先咱们来拆解你遇到的两个核心问题：窗口标志的错误组合方式，以及**setMask()的误用导致报错**。

问题1：setMask()报错的原因 #

你看到的TypeError是因为setMask()必须传入QBitmap或QRegion类型的参数，不能无参调用。这个函数是用来给窗口设置遮罩区域（比如实现圆形、不规则形状的窗口），如果不需要自定义窗口形状，完全可以删掉这个调用。

问题2：无边框+置顶失效的解决方案 #

单独设置WindowStaysOnTopHint正常，但和FramelessWindowHint组合时失效，是因为Qt的窗口标志需要用**按位或（|）**来组合多个属性，分开调用setWindowFlags()会覆盖之前设置的标志，导致置顶效果丢失。

修正后的完整代码 #

import sys
from PyQt5.QtCore import Qt
from PyQt5.QtGui import QFont
from PyQt5.QtWidgets import QApplication, QLabel

class Invisible(QLabel):
    def __init__(self, **kwargs):
        super().__init__(**kwargs)
        self.__press_pos = None
        self.initUI()

    def initUI(self):
        # 正确组合窗口标志：无边框 + 始终置顶
        self.setWindowFlags(Qt.FramelessWindowHint | Qt.WindowStaysOnTopHint)
        # 如果你不需要不规则窗口，直接删除下面的setMask调用；如果需要自定义形状，示例如下：
        # self.setMask(self.rect())  # 用窗口自身矩形作为遮罩（仅作参数格式示例）
        self.setAttribute(Qt.WA_TranslucentBackground)
        self.setText("Drag me...")
        self.setFont(QFont("Times", 50, QFont.Bold))
        self.adjustSize()
        # 居中显示窗口
        screen_center = QApplication.instance().desktop().screen().rect().center()
        self.move(screen_center - self.rect().center())

    def mousePressEvent(self, event):
        if event.button() == Qt.LeftButton:
            self.__press_pos = event.pos()

    def mouseReleaseEvent(self, event):
        if event.button() == Qt.LeftButton:
            self.__press_pos = None

    def mouseMoveEvent(self, event):
        if self.__press_pos:
            self.move(self.pos() + (event.pos() - self.__press_pos))

def main():
    app = QApplication(sys.argv)
    w = Invisible()
    w.show()
    return app.exec_()

if __name__ == '__main__':
    sys.exit(main())

关键说明 #

• 窗口标志组合：用|运算符同时传递两个窗口标志，这样两个属性会同时生效，不会互相覆盖。
• setMask()的正确用法：如果不需要不规则窗口，直接删除该调用即可；如果需要实现特殊形状，要传入有效的QBitmap（比如从带透明通道的图片生成）或QRegion（自定义形状区域）。
• 半透明背景：WA_TranslucentBackground属性配合无边框效果可以实现美观的透明窗口，你之前的这部分代码是正确的。

运行修正后的代码，窗口应该既能保持无边框状态，又能始终置顶，同时拖拽功能也能正常使用。

内容的提问来源于stack exchange，提问作者Bale