简中自述文件（已提交拉取请求无回应，先将中文文档贴在议题里）

[TC999]

PyQt-Frameless-Window

一个基于PyQt5的跨平台无边框窗口

特性

• 移动
• 调整大小
• 窗口阴影
• 窗口动画
• Win11 切片布局
• Win10 亚克力模糊
• Win11 云母模糊
• Win7 Aero 模糊
• 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-Frameless-Window")
        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 的信息吗？请阅读 帮助文档 👈

注意事项

1. FramelessWindow 提供了一个默认的自定义标题栏。如果不喜欢，只需像 demo.py 中那样重新编写它。

2. 在 Win10 上移动亚克力窗口可能会卡住。目前还没有很好的解决方案。也许在移动窗口时可以禁用亚克力效果，但我在源代码中还没有这样做。

3. 切片布局默认未启用。请查看#56以了解如何启用。

4. 如果在 Windows 上遇到此问题:

   ImportError: DLL load failed while importing win32api

   可以查看我在 stackoverflow 上的回答或我的 博客 中的解决方案。

5. 如果使用 PySide2、PySide6 或 PyQt6，可以在 PySide2、PySide6 或 PyQt6 分支中下载代码。

支持

如果这个项目对您有很大帮助，您想支持该项目的开发和维护，可以通过 爱发电 或 ko-fi 赞助我。非常感谢您的支持 🥰

参考

以下是一些使用 PyQt-Frameless-Window 的项目:

• zhiyiYo/Groove: 基于 PyQt5 的跨平台音乐播放器
• zhiyiYo/Alpha-Gobang-Zero: 基于强化学习的五子棋机器人
• zhiyiYo/PyQt-Fluent-Widgets: 基于 PyQt5 的流畅设计小部件库
• zhiyiYo/QMaterialWidgets: 基于 PySide 的材料设计小部件库

参考

• wangwenx190/framelesshelper: 为 Qt Widgets 和 Qt Quick 应用程序提供无边框窗口。支持 Win32、X11、Wayland 和 macOS
• libxcb: 使用 XCB 库进行基本图形编程

许可证

PyQt-Frameless-Window 使用 GPLv3 许可。

版权所有 © 2021 年 zhiyiYo。

[zhiyiYo]

不好意思，最近有点忙，忘记处理 issue 和 pr 了，感觉中文的 README 不是很有必要，因为这个库的使用方式太简单了，看下 example 应该就知道怎么用了