Mercurial > repos > rliterman > csp2

annotate CSP2/CSP2_env/env-d9b9114564458d9d-741b3de822f2aaca6c6caa4325c4afce/lib/python3.8/idlelib/tooltip.py @ 68:5028fdace37b

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
planemo upload commit 2e9511a184a1ca667c7be0c6321a36dc4e3d116d
author jpayne
date Tue, 18 Mar 2025 16:23:26 -0400
parents
children
rev   line source
jpayne@68 1 """Tools for displaying tool-tips.
jpayne@68 2
jpayne@68 3 This includes:
jpayne@68 4 * an abstract base-class for different kinds of tooltips
jpayne@68 5 * a simple text-only Tooltip class
jpayne@68 6 """
jpayne@68 7 from tkinter import *
jpayne@68 8
jpayne@68 9
jpayne@68 10 class TooltipBase(object):
jpayne@68 11 """abstract base class for tooltips"""
jpayne@68 12
jpayne@68 13 def __init__(self, anchor_widget):
jpayne@68 14 """Create a tooltip.
jpayne@68 15
jpayne@68 16 anchor_widget: the widget next to which the tooltip will be shown
jpayne@68 17
jpayne@68 18 Note that a widget will only be shown when showtip() is called.
jpayne@68 19 """
jpayne@68 20 self.anchor_widget = anchor_widget
jpayne@68 21 self.tipwindow = None
jpayne@68 22
jpayne@68 23 def __del__(self):
jpayne@68 24 self.hidetip()
jpayne@68 25
jpayne@68 26 def showtip(self):
jpayne@68 27 """display the tooltip"""
jpayne@68 28 if self.tipwindow:
jpayne@68 29 return
jpayne@68 30 self.tipwindow = tw = Toplevel(self.anchor_widget)
jpayne@68 31 # show no border on the top level window
jpayne@68 32 tw.wm_overrideredirect(1)
jpayne@68 33 try:
jpayne@68 34 # This command is only needed and available on Tk >= 8.4.0 for OSX.
jpayne@68 35 # Without it, call tips intrude on the typing process by grabbing
jpayne@68 36 # the focus.
jpayne@68 37 tw.tk.call("::tk::unsupported::MacWindowStyle", "style", tw._w,
jpayne@68 38 "help", "noActivates")
jpayne@68 39 except TclError:
jpayne@68 40 pass
jpayne@68 41
jpayne@68 42 self.position_window()
jpayne@68 43 self.showcontents()
jpayne@68 44 self.tipwindow.update_idletasks() # Needed on MacOS -- see #34275.
jpayne@68 45 self.tipwindow.lift() # work around bug in Tk 8.5.18+ (issue #24570)
jpayne@68 46
jpayne@68 47 def position_window(self):
jpayne@68 48 """(re)-set the tooltip's screen position"""
jpayne@68 49 x, y = self.get_position()
jpayne@68 50 root_x = self.anchor_widget.winfo_rootx() + x
jpayne@68 51 root_y = self.anchor_widget.winfo_rooty() + y
jpayne@68 52 self.tipwindow.wm_geometry("+%d+%d" % (root_x, root_y))
jpayne@68 53
jpayne@68 54 def get_position(self):
jpayne@68 55 """choose a screen position for the tooltip"""
jpayne@68 56 # The tip window must be completely outside the anchor widget;
jpayne@68 57 # otherwise when the mouse enters the tip window we get
jpayne@68 58 # a leave event and it disappears, and then we get an enter
jpayne@68 59 # event and it reappears, and so on forever :-(
jpayne@68 60 #
jpayne@68 61 # Note: This is a simplistic implementation; sub-classes will likely
jpayne@68 62 # want to override this.
jpayne@68 63 return 20, self.anchor_widget.winfo_height() + 1
jpayne@68 64
jpayne@68 65 def showcontents(self):
jpayne@68 66 """content display hook for sub-classes"""
jpayne@68 67 # See ToolTip for an example
jpayne@68 68 raise NotImplementedError
jpayne@68 69
jpayne@68 70 def hidetip(self):
jpayne@68 71 """hide the tooltip"""
jpayne@68 72 # Note: This is called by __del__, so careful when overriding/extending
jpayne@68 73 tw = self.tipwindow
jpayne@68 74 self.tipwindow = None
jpayne@68 75 if tw:
jpayne@68 76 try:
jpayne@68 77 tw.destroy()
jpayne@68 78 except TclError: # pragma: no cover
jpayne@68 79 pass
jpayne@68 80
jpayne@68 81
jpayne@68 82 class OnHoverTooltipBase(TooltipBase):
jpayne@68 83 """abstract base class for tooltips, with delayed on-hover display"""
jpayne@68 84
jpayne@68 85 def __init__(self, anchor_widget, hover_delay=1000):
jpayne@68 86 """Create a tooltip with a mouse hover delay.
jpayne@68 87
jpayne@68 88 anchor_widget: the widget next to which the tooltip will be shown
jpayne@68 89 hover_delay: time to delay before showing the tooltip, in milliseconds
jpayne@68 90
jpayne@68 91 Note that a widget will only be shown when showtip() is called,
jpayne@68 92 e.g. after hovering over the anchor widget with the mouse for enough
jpayne@68 93 time.
jpayne@68 94 """
jpayne@68 95 super(OnHoverTooltipBase, self).__init__(anchor_widget)
jpayne@68 96 self.hover_delay = hover_delay
jpayne@68 97
jpayne@68 98 self._after_id = None
jpayne@68 99 self._id1 = self.anchor_widget.bind("<Enter>", self._show_event)
jpayne@68 100 self._id2 = self.anchor_widget.bind("<Leave>", self._hide_event)
jpayne@68 101 self._id3 = self.anchor_widget.bind("<Button>", self._hide_event)
jpayne@68 102
jpayne@68 103 def __del__(self):
jpayne@68 104 try:
jpayne@68 105 self.anchor_widget.unbind("<Enter>", self._id1)
jpayne@68 106 self.anchor_widget.unbind("<Leave>", self._id2) # pragma: no cover
jpayne@68 107 self.anchor_widget.unbind("<Button>", self._id3) # pragma: no cover
jpayne@68 108 except TclError:
jpayne@68 109 pass
jpayne@68 110 super(OnHoverTooltipBase, self).__del__()
jpayne@68 111
jpayne@68 112 def _show_event(self, event=None):
jpayne@68 113 """event handler to display the tooltip"""
jpayne@68 114 if self.hover_delay:
jpayne@68 115 self.schedule()
jpayne@68 116 else:
jpayne@68 117 self.showtip()
jpayne@68 118
jpayne@68 119 def _hide_event(self, event=None):
jpayne@68 120 """event handler to hide the tooltip"""
jpayne@68 121 self.hidetip()
jpayne@68 122
jpayne@68 123 def schedule(self):
jpayne@68 124 """schedule the future display of the tooltip"""
jpayne@68 125 self.unschedule()
jpayne@68 126 self._after_id = self.anchor_widget.after(self.hover_delay,
jpayne@68 127 self.showtip)
jpayne@68 128
jpayne@68 129 def unschedule(self):
jpayne@68 130 """cancel the future display of the tooltip"""
jpayne@68 131 after_id = self._after_id
jpayne@68 132 self._after_id = None
jpayne@68 133 if after_id:
jpayne@68 134 self.anchor_widget.after_cancel(after_id)
jpayne@68 135
jpayne@68 136 def hidetip(self):
jpayne@68 137 """hide the tooltip"""
jpayne@68 138 try:
jpayne@68 139 self.unschedule()
jpayne@68 140 except TclError: # pragma: no cover
jpayne@68 141 pass
jpayne@68 142 super(OnHoverTooltipBase, self).hidetip()
jpayne@68 143
jpayne@68 144
jpayne@68 145 class Hovertip(OnHoverTooltipBase):
jpayne@68 146 "A tooltip that pops up when a mouse hovers over an anchor widget."
jpayne@68 147 def __init__(self, anchor_widget, text, hover_delay=1000):
jpayne@68 148 """Create a text tooltip with a mouse hover delay.
jpayne@68 149
jpayne@68 150 anchor_widget: the widget next to which the tooltip will be shown
jpayne@68 151 hover_delay: time to delay before showing the tooltip, in milliseconds
jpayne@68 152
jpayne@68 153 Note that a widget will only be shown when showtip() is called,
jpayne@68 154 e.g. after hovering over the anchor widget with the mouse for enough
jpayne@68 155 time.
jpayne@68 156 """
jpayne@68 157 super(Hovertip, self).__init__(anchor_widget, hover_delay=hover_delay)
jpayne@68 158 self.text = text
jpayne@68 159
jpayne@68 160 def showcontents(self):
jpayne@68 161 label = Label(self.tipwindow, text=self.text, justify=LEFT,
jpayne@68 162 background="#ffffe0", relief=SOLID, borderwidth=1)
jpayne@68 163 label.pack()
jpayne@68 164
jpayne@68 165
jpayne@68 166 def _tooltip(parent): # htest #
jpayne@68 167 top = Toplevel(parent)
jpayne@68 168 top.title("Test tooltip")
jpayne@68 169 x, y = map(int, parent.geometry().split('+')[1:])
jpayne@68 170 top.geometry("+%d+%d" % (x, y + 150))
jpayne@68 171 label = Label(top, text="Place your mouse over buttons")
jpayne@68 172 label.pack()
jpayne@68 173 button1 = Button(top, text="Button 1 -- 1/2 second hover delay")
jpayne@68 174 button1.pack()
jpayne@68 175 Hovertip(button1, "This is tooltip text for button1.", hover_delay=500)
jpayne@68 176 button2 = Button(top, text="Button 2 -- no hover delay")
jpayne@68 177 button2.pack()
jpayne@68 178 Hovertip(button2, "This is tooltip\ntext for button2.", hover_delay=None)
jpayne@68 179
jpayne@68 180
jpayne@68 181 if __name__ == '__main__':
jpayne@68 182 from unittest import main
jpayne@68 183 main('idlelib.idle_test.test_tooltip', verbosity=2, exit=False)
jpayne@68 184
jpayne@68 185 from idlelib.idle_test.htest import run
jpayne@68 186 run(_tooltip)