【PyQt学习篇 · ⑧】：QWidget - 窗口特定操作

最新推荐文章于 2025-09-21 16:02:34 发布

原创

最新推荐文章于 2025-09-21 16:02:34 发布 · 1.4k 阅读

6 ·

CC 4.0 BY-SA版权

文章标签：

#pyqt #python

本文详细介绍了如何在PyQt5中设置窗口的图标、标题、透明度以及窗口状态，包括窗口最大化、最小化、全屏功能，以及窗口标志的使用，如无边框、无标题栏、半透明等。

文章目录

图标
标题
不透明度
窗口状态
最大化和最小化
窗口标志
案例

图标

setWindowIcon(QIcon("resource/header_icon.png"))：该函数用于设置QWidget的窗口图标。可以为窗口设置一个图标，以显示在窗口标题栏、任务栏或窗口管理器中。
windowIcon()：该函数用于获取已设置的QWidget的窗口图标。如果在此QWidget上设置了窗口图标，则返回一个QIcon对象，可以在需要的地方进一步使用。

代码演示：

在这里插入图片描述
将以上图片作为窗口图标：

from PyQt5.QtWidgets import *
from PyQt5.QtGui import QIcon
import sys

app = QApplication(sys.argv)

window = QWidget()
window.resize(200, 200)

window.setWindowIcon(QIcon('mouse.png'))
print(window.windowIcon())  # 打印QIcon对象

window.show()
sys.exit(app.exec_())

运行结果：

在这里插入图片描述

标题

setWindowTitle(title)：该函数用于设置QWidget的窗口标题。您可以使用该函数将自定义的标题文本设置给QWidget，这个标题文本将会显示在窗口的标题栏上。
windowTitle()：该函数用于获取QWidget的窗口标题。如果在此QWidget上设置了窗口标题，则返回该标题文本的字符串。

在之前的文章中已有相关介绍，在这里就不展开描述。

不透明度

setWindowOpacity(float)：该函数用于设置QWidget的窗口透明度。参数float的范围是从0.0（完全透明）到1.0（完全不透明）。通过调整窗口的透明度，您可以创建半透明或不透明的窗口效果。
windowOpacity()：该函数用于获取QWidget的窗口透明度。如果在此QWidget上设置了窗口透明度，则返回其当前的透明度值。

代码演示：

from PyQt5.QtWidgets import *
import sys

app = QApplication(sys.argv)

window = QWidget()
window.resize(300, 300)

window.setWindowOpacity(0.5)	# 设置窗口为半透明
print(window.windowOpacity())   # 打印窗口透明值

window.show()
sys.exit(app.exec_())

运行结果：

在这里插入图片描述

窗口状态

setWindowState(state)：该函数用于设置QWidget的窗口状态。参数state可以是以下值之一：
- Qt.WindowNoState：没有任何特殊状态，窗口以正常方式显示。
- Qt.WindowMinimized：将窗口最小化。
- Qt.WindowMaximized：将窗口最大化。
- Qt.WindowFullScreen：将窗口设置为全屏模式。
- Qt.WindowActive：将窗口设置为活动状态（在多个窗口中切换焦点）。
windowState()：该函数用于获取QWidget的窗口状态。返回一个表示当前窗口状态的整数值。

对以上窗口的不同状态进行演示，主要代码：

from PyQt5.QtWidgets import *
from PyQt5.QtCore import Qt
import sys

app = QApplication(sys.argv)

window = QWidget()
window.resize(300, 300)

window