DM40GUI/GUI/widgets/tooltip.py at 09e384f8efe6808425de130c3b2fa0e239a4080a · maj113/DM40GUI · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
import tkinter as tk


class Tooltip:
    """Theme-aware tooltip with hover delay."""

    def __init__(
        self,
        master: tk.Misc,
        font_obj,
    ):
        self.master = master
        self._font = font_obj
        self._tip = None
        self._label = None
        self._current_text = None
        self._last_xy = None
        self._after_id = None
        self._pending = None

    def is_visible(self) -> bool:
        return self._tip is not None

    def _cancel_pending_show(self) -> None:
        if self._after_id:
            try:
                self.master.after_cancel(self._after_id)
            except tk.TclError:
                pass
        self._after_id = None
        self._pending = None

    def update_text(self, text: str) -> bool:
        self._cancel_pending_show()

        if self._current_text == text:
            return True

        if not self._tip or not self._label:
            return False

        try:
            self._label.configure(text=text)
        except tk.TclError:
            pass
        self._current_text = text
        return True

    def show(self, text: str, x: int, y: int, delay_ms: int = 150):
        if self._tip:
            self.update_text(text)
            self.move(x, y)
            return

        pending = (text, x, y)
        if self._after_id:
            if self._pending == pending:
                return
            self._cancel_pending_show()
        self._pending = pending
        self._after_id = self.master.after(delay_ms, self._materialize)

    def _materialize(self):
        self._after_id = None
        if not self._pending:
            return
        text, x, y = self._pending
        self._pending = None
        self._create_tip(text, x, y)

    def _create_tip(self, text: str, x: int, y: int):
        if self._tip:
            return
        self._tip = tk.Toplevel(self.master)
        self._tip.wm_overrideredirect(True)
        self._label = tk.Label(
            self._tip,
            text=text,
            wraplength=520,
            justify="left",
            font=self._font,
            padx=5,
            pady=3,
            highlightthickness=2
        )
        self._label.pack(fill=tk.BOTH, expand=True)
        try:
            self._tip.wm_geometry('+%s+%s' % (x, y))
        except tk.TclError:
            pass
        self._current_text = text
        self._last_xy = (x, y)

    def move(self, x: int, y: int):
        if self._tip:
            xy = (x, y)
            if self._last_xy == xy:
                return
            try:
                self._tip.wm_geometry('+%s+%s' % (x, y))
            except tk.TclError:
                pass
            self._last_xy = xy

    def hide(self):
        self._cancel_pending_show()
        if self._tip:
            try:
                self._tip.destroy()
            except tk.TclError:
                pass
        self._tip = None
        self._label = None
        self._current_text = None
        self._last_xy = None