tkinter中能否为Listbox组件设置图片作为背景？

所有框架下Listbox设置背景图的核心逻辑都是一致的：重写控件的绘制事件，优先渲染背景图，再渲染列表项内容，同时设置列表项默认背景为透明避免覆盖背景图。以下是不同常用开发场景的实现代码：

• Tkinter 实现
  继承原生Listbox类重写绘制逻辑即可：

  from tkinter import *
  from PIL import Image, ImageTk
  
  class ImageListbox(Listbox):
      def __init__(self, parent, image_path, *args, **kwargs):
          super().__init__(parent, *args, **kwargs)
          self.origin_img = Image.open(image_path)
          self.bg_img = ImageTk.PhotoImage(self.origin_img)
          # 绑定窗口尺寸变化事件重绘背景
          self.bind("<Configure>", self._resize_background)
          # 设置基础样式避免默认背景遮挡图片
          self.config(
              bg="systemTransparent",
              selectbackground="#4287f5",
              selectforeground="#fff",
              bd=0,
              highlightthickness=0
          )
          self._draw_background()
      
      def _resize_background(self, event):
          # 适配控件尺寸调整背景图大小
          resized_img = self.origin_img.resize((event.width, event.height), Image.Resampling.LANCZOS)
          self.bg_img = ImageTk.PhotoImage(resized_img)
          self._draw_background()
      
      def _draw_background(self):
          self.create_image(0, 0, image=self.bg_img, anchor=NW)
  

  调用时直接实例化自定义类，传入背景图路径即可正常使用。

• PyQt/PySide 实现
  重写QListWidget的paintEvent方法完成背景绘制：

  from PyQt5.QtWidgets import QListWidget
  from PyQt5.QtGui import QPainter, QPixmap
  from PyQt5.QtCore import Qt
  
  class ImageListWidget(QListWidget):
      def __init__(self, image_path, parent=None):
          super().__init__(parent)
          self.bg_pixmap = QPixmap(image_path)
          # 样式表设置列表项透明
          self.setStyleSheet("""
              QListWidget {border: none; outline: none;}
              QListWidget::item {
                  background: transparent;
                  color: #fff;
                  padding: 8px 12px;
              }
              QListWidget::item:selected {
                  background: rgba(66, 135, 245, 0.8);
              }
          """)
      
      def paintEvent(self, event):
          painter = QPainter(self.viewport())
          # 绘制适配控件尺寸的背景图
          scaled_pix = self.bg_pixmap.scaled(self.viewport().size(), Qt.IgnoreAspectRatio, Qt.SmoothTransformation)
          painter.drawPixmap(0, 0, scaled_pix)
          super().paintEvent(event)
  

• 前端场景实现
  直接通过CSS配置即可，无需额外JS逻辑：

  /* 针对任意框架的Listbox组件 */
  .listbox-root {
      background-image: url("你的背景图路径");
      background-size: cover;
      background-position: center center;
  }
  .listbox-item {
      background-color: transparent;
  }
  /* 选中/hover态可设置半透明背景提升可读性 */
  .listbox-item:hover, .listbox-item.active {
      background-color: rgba(66, 135, 245, 0.8);
  }
  

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