PyQt-Frameless-Window

<p align="center"> <img width="15%" align="center" src="https://yellow-cdn.veclightyear.com/ab5030c0/8228a708-6353-4bc3-9eb7-35f25c254db5.png" alt="logo"> </p> <h1 align="center"> PyQt-无边框窗口 </h1> <p align="center"> 基于PyQt5的跨平台无边框窗口 </p> <p align="center"> <a style="text-decoration:none"> <img src="https://img.shields.io/badge/平台-Win32%20|%20Linux%20|%20macOS-blue?color=#4ec820" alt="Platform Win32 | Linux | macOS"/> </a> <a style="text-decoration:none"> <img src="https://static.pepy.tech/personalized-badge/pyqt5-frameless-window?period=total&units=international_system&left_color=grey&right_color=brightgreen&left_text=下载量" alt="Download"/> </a> <a style="text-decoration:none"> <img src="https://img.shields.io/badge/许可协议-GPLv3-blue?color=#4ec820" alt="GPLv3"/> </a> </p>

Cover

功能

窗口移动
窗口拉伸
窗口阴影
窗口动画
Win11窗口快照布局
Win10毛玻璃效果
Win11米卡效果
Win7Aero毛玻璃效果
macOS毛玻璃效果

安装

通过pip安装:

pip install PyQt5-Frameless-Window

或克隆仓库:

git clone https://github.com/zhiyiYo/PyQt-Frameless-Window.git
python setup.py install

依赖

平台	依赖
Win32	pywin32
Linux	xcffib
macOS	pyobjc

用法

要使用无边框窗口,只需继承FramelessWindow或FramelessMainWindow。这是一个最小化示例:

import sys

from PyQt5.QtWidgets import QApplication
from qframelesswindow import FramelessWindow


class Window(FramelessWindow):

    def __init__(self, parent=None):
        super().__init__(parent=parent)
        self.setWindowTitle("PyQt-无边框窗口")
        self.titleBar.raise_()


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

对于更复杂的需求,请查看demo.py和main_window.py。

示例

普通无边框窗口
毛玻璃无边框窗口

文档

想了解更多关于PyQt-Frameless-Window的信息?请阅读帮助文档 👈

注意事项

FramelessWindow提供了一个默认的自定义标题栏。如果你不喜欢它,只需要像demo.py那样重写它。
在Win10上移动毛玻璃窗口可能会卡顿。目前没有好的解决方案。也许你可以在移动窗口时禁用毛玻璃效果,但我在源代码中还没有这样做。
窗口快照布局默认是禁用的。查看#56了解如何启用它。
如果你在Windows上遇到这个问题:

ImportError: DLL load failed while importing win32api

请查看我在stackoverflow或博客上的解决方案。
如果你正在使用PySide2、PySide6或PyQt6,你可以从PySide2、PySide6或PyQt6分支下载代码。