Python Gtk：修改Gtk Treeview行背景色及Gtk.CellRendererText问题

阿华AIGC实验室

2026-5-19

动态设置单元格颜色（无需修改ListStore）

嘿，我完全懂你不想给ListStore额外加列的顾虑——为了个颜色多维护一列确实挺冗余的。其实不用纠结怎么“访问单元格部件”，GTK里有个更优雅的方案，能直接根据单元格值动态调整颜色，完全不用改动数据模型的结构。

核心方案：使用CellRenderer的`data_func`

你之前试的CssProvider没生效，大概率是没把样式和单元格的动态状态绑定好。而**数据函数（data_func）**就是专门用来在渲染单元格时，根据当前行的数据动态调整渲染属性的，完美适配你这种“值有效变绿，无效变红”的需求。

下面给你分GTK3和GTK4两种情况举例子，你可以对应自己的版本来用：

示例1：GTK3（TreeView + ListStore）

import gi
gi.require_version('Gtk', '3.0')
from gi.repository import Gtk

def on_cell_data_func(column, cell, model, iter, data):
    # 获取当前单元格要检查的值（这里假设第0列是目标值）
    value = model.get_value(iter, 0)
    # 自定义你的有效性判断逻辑，这里举个“非空且为正数字”的例子
    try:
        num = float(value)
        is_valid = num > 0
    except (ValueError, TypeError):
        is_valid = False
    
    # 根据有效性设置单元格前景色
    if is_valid:
        cell.set_property('foreground', '#00cc00')  # 绿色
    else:
        cell.set_property('foreground', '#cc0000')  # 红色

# 构建界面
window = Gtk.Window(title="动态单元格颜色")
liststore = Gtk.ListStore(str)  # 只需要存值的列，不用加颜色列
liststore.append(["123"])
liststore.append(["abc"])
liststore.append(["-45"])
liststore.append([""])

treeview = Gtk.TreeView(model=liststore)
renderer = Gtk.CellRendererText()
column = Gtk.TreeViewColumn("输入值", renderer, text=0)
# 把data_func绑定到列上，渲染时自动触发
column.set_cell_data_func(renderer, on_cell_data_func)

treeview.append_column(column)
window.add(treeview)
window.connect("destroy", Gtk.main_quit)
window.show_all()
Gtk.main()

示例2：GTK4（ListView + ListModel）

GTK4的API有变化，我们可以结合CssProvider和动态CSS类来实现，更灵活：

import gi
gi.require_version('Gtk', '4.0')
from gi.repository import Gtk

def on_cell_bind(factory, list_item):
    # 获取当前行的数据和显示用的Label
    item = list_item.get_item()
    label = list_item.get_child()
    label.set_label(item.get_string())
    
    # 有效性判断
    try:
        num = float(item.get_string())
        is_valid = num > 0
    except (ValueError, TypeError):
        is_valid = False
    
    # 动态添加/移除CSS类
    if is_valid:
        label.add_css_class('valid-cell')
        label.remove_css_class('invalid-cell')
    else:
        label.add_css_class('invalid-cell')
        label.remove_css_class('valid-cell')

# 构建界面
window = Gtk.ApplicationWindow(title="动态单元格颜色")
string_list = Gtk.StringList.new(["123", "abc", "-45", ""])

# 创建列表项工厂
factory = Gtk.SignalListItemFactory()
factory.connect("setup", lambda _, list_item: list_item.set_child(Gtk.Label()))
factory.connect("bind", on_cell_bind)

list_view = Gtk.ListView(model=string_list, factory=factory)

# 加载CSS样式
css_provider = Gtk.CssProvider()
css_provider.load_from_data(b"""
.valid-cell { color: #00cc00; font-weight: bold; }
.invalid-cell { color: #cc0000; }
""")
# 把样式应用到整个窗口的显示上下文
Gtk.StyleContext.add_provider_for_display(
    window.get_display(),
    css_provider,
    Gtk.STYLE_PROVIDER_PRIORITY_APPLICATION
)

# 滚动容器包裹ListView
scrolled_window = Gtk.ScrolledWindow()
scrolled_window.set_child(list_view)
window.set_child(scrolled_window)
window.present()

# 启动应用
app = Gtk.Application()
app.connect("activate", lambda _, win=window: win.present())
app.run()