Tkinter Text 组件 yview_scroll 嵌套框架滚动黑色背景框问题及解决办法

2024-03-01 16:32:20

Tkinter Text 组件的 yview_scroll 滚动怪象

引言

在构建复杂的 Tkinter GUI 时，充分利用 Text 组件的强大功能至关重要。然而，当嵌入嵌套框架并以编程方式滚动时，您可能会遇到一个怪异的现象，导致出现纯黑色背景框。让我们深入探讨这个问题，揭开其成因并提供有效的变通办法。

问题

问题出现在当您使用 yview_scroll(-2, "units") 方法从下往上滚动嵌套在 Notebook 中的 Text 组件时。这种滚动行为会导致在向上滚动时出现一个黑色背景框，该框在滚动更长时间后最终消失。向下滚动时不会发生这种情况。

原因分析

经过一番探索，我们发现此问题源于Tkinter内部窗口管理的复杂性。嵌套的框架本质上是子窗口，并且它们的滚动与主 Text 组件的滚动相互影响。当使用 yview_scroll 方法时，它会更新子窗口的滚动位置，但不会立即刷新 GUI。因此，在向上滚动时，主窗口会暂时显示子窗口的旧内容，导致黑色背景框出现。

变通办法

由于 Tkinter 缺乏开箱即用的解决方法，我们必须寻找变通办法来解决此问题。一种方法是计算单行相对于整个 Text 内容的百分比，然后使用 yview_moveto 方法以编程方式滚动。这种方法可以有效地模拟正常的滚动行为，而不会产生黑色背景框。

代码示例

以下是实现上述变通办法的 Python 代码：

import tkinter as tk

class CustomText(tk.Text):
    def get_fraction(self, num_lines: int = 1) -> float:
        total_lines = self.count("1.0", "end-1c lineend", "displaylines")[0]
        fraction = num_lines / total_lines
        return fraction

    def scroll_up(self, check: bool = False) -> None:
        fraction = self.get_fraction()
        self.yview_moveto(self.yview()[0] - fraction)