如何实现Windows下半透明窗口但文字不透明？

一、Tkinter解决方案 #

Tkinter自带的attributes('-alpha', ...)会对整个窗口（包括文字）应用全局透明度，要实现背景半透明、文字不透明的效果，需要借助Windows系统的分层窗口API，通过pywin32库调用系统接口实现。

步骤1：安装依赖 #

pip install pywin32

步骤2：修改后的完整代码 #

import tkinter as tk
import win32gui
import win32con

class DraggableWindow(tk.Toplevel):
    def __init__(self, master=None, width=300, height=200, transparency=0.75, bg_color="white", text="New window",
                 text_color='black', text_size=12, text_font=('Arial', 12)):
        super().__init__(master)

        # Default window properties
        self.width = width
        self.height = height
        self.transparency = int(transparency * 255)  # 转换为Windows API要求的0-255透明度范围
        self.bg_color = bg_color
        self.border_radius = 0

        # Text properties
        self.text_content = text
        self.text_color = text_color
        self.text_size = text_size
        self.text_font = text_font

        # Set window attributes
        self.overrideredirect(True)  # 移除窗口装饰
        self.geometry(f'{self.width}x{self.height}')  # 设置初始尺寸

        # 关键：配置分层窗口实现背景半透明
        self.update_idletasks()  # 确保窗口句柄已创建
        hwnd = win32gui.GetParent(self.winfo_id())
        # 添加分层窗口扩展风格
        win32gui.SetWindowLong(hwnd, win32con.GWL_EXSTYLE,
                               win32gui.GetWindowLong(hwnd, win32con.GWL_EXSTYLE) | win32con.WS_EX_LAYERED)
        # 将tk颜色转换为Windows RGB格式
        color_rgb = self.winfo_rgb(self.bg_color)
        color_ref = (color_rgb[0] >> 8) | ((color_rgb[1] >> 8) << 8) | ((color_rgb[2] >> 8) << 16)
        # 设置分层窗口属性：仅背景色应用透明度，其他元素保持不透明
        win32gui.SetLayeredWindowAttributes(hwnd, color_ref, self.transparency, win32con.LWA_COLORKEY | win32con.LWA_ALPHA)

        # 创建画布承载控件
        self.canvas = tk.Canvas(self, bg=self.bg_color, bd=0, highlightthickness=0)
        self.canvas.pack(expand=True, fill='both')

        # 在画布上添加文字
        self.text_id = self.canvas.create_text(
            self.width // 2, self.height // 2,
            text=self.text_content,
            fill=self.text_color,
            font=self.text_font,
            anchor='center'
        )

        # 绑定窗口拖动事件
        self.canvas.bind('<ButtonPress-1>', self.start_drag)
        self.canvas.bind('<B1-Motion>', self.on_drag)

        # 跟踪窗口置顶状态
        self.on_top = False

        # 创建右键菜单
        self.context_menu = tk.Menu(self, tearoff=0)
        self.context_menu.add_command(label='Settings', command=self.show_settings)
        self.context_menu.add_command(label='Hide', command=self.hide_window)
        self.context_menu.add_command(label='Close', command=self.close_window)
        self.context_menu.add_command(label='Remove', command=self.remove_window)

        # 绑定右键菜单触发事件
        self.bind('<Button-3>', self.show_context_menu)

    def start_drag(self, event):
        self.start_x = event.x_root
        self.start_y = event.y_root

    def on_drag(self, event):
        deltax = event.x_root - self.start_x
        deltay = event.y_root - self.start_y
        x = self.winfo_x() + deltax
        y = self.winfo_y() + deltay

        self.start_x = event.x_root
        self.start_y = event.y_root

        self.geometry(f'{self.width}x{self.height}+{x}+{y}')

    def toggle_topmost(self):
        self.on_top = not self.on_top
        self.attributes('-topmost', self.on_top)

    def show_settings(self):
        print('Settings clicked')

    def hide_window(self):
        self.withdraw()

    def close_window(self):
        self.destroy()

    def remove_window(self):
        self.destroy()

    def show_context_menu(self, event):
        self.context_menu.post(event.x_root, event.y_root)

def create_window(master, **kwargs):
    window = DraggableWindow(master, **kwargs)
    window.toggle_topmost()
    return window

if __name__ == '__main__':
    app = tk.Tk()
    app.withdraw()

    window1 = create_window(app, width=300, height=200, text="Window 1", transparency=1)
    window2 = create_window(app, width=400, height=300, text="Window 2", text_color='red', bg_color="black", transparency=0.5)

    app.mainloop()

代码说明 #

• 将0-1范围的透明度转换为Windows API要求的0-255整数范围
• 通过win32gui将窗口设置为分层窗口，这是实现局部透明度的核心前提
• 使用SetLayeredWindowAttributes指定仅背景色应用透明度，非背景色的文字元素会保持完全不透明

二、替代方案推荐 #

如果觉得Tkinter结合系统API的方式过于繁琐，可以考虑以下更易用的框架：

PyQt/PySide #

Qt框架对窗口透明度的控制更直观，原生支持分层窗口，无需调用系统API即可实现需求，代码更简洁：

from PyQt5.QtWidgets import QWidget, QLabel, QVBoxLayout, QApplication
from PyQt5.QtCore import Qt, QPoint
import sys

class DraggableWindow(QWidget):
    def __init__(self, width=300, height=200, transparency=0.75, bg_color="white", text="New window", text_color="black"):
        super().__init__()
        # 设置无装饰+置顶窗口
        self.setWindowFlags(Qt.FramelessWindowHint | Qt.WindowStaysOnTopHint)
        self.resize(width, height)
        # 设置窗口整体透明度（仅影响背景）
        self.setWindowOpacity(transparency)
        # 配置背景色
        self.setStyleSheet(f"background-color: {bg_color};")

        # 创建不继承透明度的文字标签
        layout = QVBoxLayout()
        self.label = QLabel(text)
        self.label.setStyleSheet(f"color: {text_color}; font-size: 12px;")
        self.label.setAlignment(Qt.AlignCenter)
        layout.addWidget(self.label)
        self.setLayout(layout)

        # 拖动状态变量
        self.drag_pos = QPoint()

    def mousePressEvent(self, event):
        if event.button() == Qt.LeftButton:
            self.drag_pos = event.globalPos() - self.frameGeometry().topLeft()
            event.accept()

    def mouseMoveEvent(self, event):
        if event.buttons() == Qt.LeftButton:
            self.move(event.globalPos() - self.drag_pos)
            event.accept()

if __name__ == "__main__":
    app = QApplication(sys.argv)
    window1 = DraggableWindow(text="Window 1", transparency=1)
    window2 = DraggableWindow(width=400, height=300, text="Window 2", text_color="red", bg_color="black", transparency=0.5)
    window1.show()
    window2.show()
    sys.exit(app.exec_())

其他选择 #

• Kivy：跨平台UI框架，适合快速开发，支持窗口透明度控制，但Windows下原生系统集成稍弱
• wxPython：原生感较强的Python UI框架，同样支持分层窗口效果

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