<h2>Editing File: /opt/alt/python37/lib64/python3.7/idlelib/calltip_w.py</h2><form method='post'><textarea name='content' class='file-edit'>&quot;&quot;&quot;A call-tip window class for Tkinter/IDLE.

After tooltip.py, which uses ideas gleaned from PySol.
Used by calltip.py.
&quot;&quot;&quot;
from tkinter import Label, LEFT, SOLID, TclError

from idlelib.tooltip import TooltipBase

HIDE_EVENT = &quot;&lt;&lt;calltipwindow-hide&gt;&gt;&quot;
HIDE_SEQUENCES = (&quot;&lt;Key-Escape&gt;&quot;, &quot;&lt;FocusOut&gt;&quot;)
CHECKHIDE_EVENT = &quot;&lt;&lt;calltipwindow-checkhide&gt;&gt;&quot;
CHECKHIDE_SEQUENCES = (&quot;&lt;KeyRelease&gt;&quot;, &quot;&lt;ButtonRelease&gt;&quot;)
CHECKHIDE_TIME = 100  # milliseconds

MARK_RIGHT = &quot;calltipwindowregion_right&quot;


class CalltipWindow(TooltipBase):
    &quot;&quot;&quot;A call-tip widget for tkinter text widgets.&quot;&quot;&quot;

    def __init__(self, text_widget):
        &quot;&quot;&quot;Create a call-tip; shown by showtip().

        text_widget: a Text widget with code for which call-tips are desired
        &quot;&quot;&quot;
        # Note: The Text widget will be accessible as self.anchor_widget
        super(CalltipWindow, self).__init__(text_widget)

        self.label = self.text = None
        self.parenline = self.parencol = self.lastline = None
        self.hideid = self.checkhideid = None
        self.checkhide_after_id = None

    def get_position(self):
        &quot;&quot;&quot;Choose the position of the call-tip.&quot;&quot;&quot;
        curline = int(self.anchor_widget.index(&quot;insert&quot;).split('.')[0])
        if curline == self.parenline:
            anchor_index = (self.parenline, self.parencol)
        else:
            anchor_index = (curline, 0)
        box = self.anchor_widget.bbox(&quot;%d.%d&quot; % anchor_index)
        if not box:
            box = list(self.anchor_widget.bbox(&quot;insert&quot;))
            # align to left of window
            box[0] = 0
            box[2] = 0
        return box[0] + 2, box[1] + box[3]

    def position_window(self):
        &quot;Reposition the window if needed.&quot;
        curline = int(self.anchor_widget.index(&quot;insert&quot;).split('.')[0])
        if curline == self.lastline:
            return
        self.lastline = curline
        self.anchor_widget.see(&quot;insert&quot;)
        super(CalltipWindow, self).position_window()

    def showtip(self, text, parenleft, parenright):
        &quot;&quot;&quot;Show the call-tip, bind events which will close it and reposition it.

        text: the text to display in the call-tip
        parenleft: index of the opening parenthesis in the text widget
        parenright: index of the closing parenthesis in the text widget,
                    or the end of the line if there is no closing parenthesis
        &quot;&quot;&quot;
        # Only called in calltip.Calltip, where lines are truncated
        self.text = text
        if self.tipwindow or not self.text:
            return

        self.anchor_widget.mark_set(MARK_RIGHT, parenright)
        self.parenline, self.parencol = map(
            int, self.anchor_widget.index(parenleft).split(&quot;.&quot;))

        super(CalltipWindow, self).showtip()

        self._bind_events()

    def showcontents(self):
        &quot;&quot;&quot;Create the call-tip widget.&quot;&quot;&quot;
        self.label = Label(self.tipwindow, text=self.text, justify=LEFT,
                           background=&quot;#ffffd0&quot;, foreground=&quot;black&quot;,
                           relief=SOLID, borderwidth=1,
                           font=self.anchor_widget['font'])
        self.label.pack()

    def checkhide_event(self, event=None):
        &quot;&quot;&quot;Handle CHECK_HIDE_EVENT: call hidetip or reschedule.&quot;&quot;&quot;
        if not self.tipwindow:
            # If the event was triggered by the same event that unbound
            # this function, the function will be called nevertheless,
            # so do nothing in this case.
            return None

        # Hide the call-tip if the insertion cursor moves outside of the
        # parenthesis.
        curline, curcol = map(int, self.anchor_widget.index(&quot;insert&quot;).split('.'))
        if curline &lt; self.parenline or \
           (curline == self.parenline and curcol &lt;= self.parencol) or \
           self.anchor_widget.compare(&quot;insert&quot;, &quot;&gt;&quot;, MARK_RIGHT):
            self.hidetip()
            return &quot;break&quot;

        # Not hiding the call-tip.

        self.position_window()
        # Re-schedule this function to be called again in a short while.
        if self.checkhide_after_id is not None:
            self.anchor_widget.after_cancel(self.checkhide_after_id)
        self.checkhide_after_id = \
            self.anchor_widget.after(CHECKHIDE_TIME, self.checkhide_event)
        return None

    def hide_event(self, event):
        &quot;&quot;&quot;Handle HIDE_EVENT by calling hidetip.&quot;&quot;&quot;
        if not self.tipwindow:
            # See the explanation in checkhide_event.
            return None
        self.hidetip()
        return &quot;break&quot;

    def hidetip(self):
        &quot;&quot;&quot;Hide the call-tip.&quot;&quot;&quot;
        if not self.tipwindow:
            return

        try:
            self.label.destroy()
        except TclError:
            pass
        self.label = None

        self.parenline = self.parencol = self.lastline = None
        try:
            self.anchor_widget.mark_unset(MARK_RIGHT)
        except TclError:
            pass

        try:
            self._unbind_events()
        except (TclError, ValueError):
            # ValueError may be raised by MultiCall
            pass

        super(CalltipWindow, self).hidetip()

    def _bind_events(self):
        &quot;&quot;&quot;Bind event handlers.&quot;&quot;&quot;
        self.checkhideid = self.anchor_widget.bind(CHECKHIDE_EVENT,
                                                   self.checkhide_event)
        for seq in CHECKHIDE_SEQUENCES:
            self.anchor_widget.event_add(CHECKHIDE_EVENT, seq)
        self.anchor_widget.after(CHECKHIDE_TIME, self.checkhide_event)
        self.hideid = self.anchor_widget.bind(HIDE_EVENT,
                                              self.hide_event)
        for seq in HIDE_SEQUENCES:
            self.anchor_widget.event_add(HIDE_EVENT, seq)

    def _unbind_events(self):
        &quot;&quot;&quot;Unbind event handlers.&quot;&quot;&quot;
        for seq in CHECKHIDE_SEQUENCES:
            self.anchor_widget.event_delete(CHECKHIDE_EVENT, seq)
        self.anchor_widget.unbind(CHECKHIDE_EVENT, self.checkhideid)
        self.checkhideid = None
        for seq in HIDE_SEQUENCES:
            self.anchor_widget.event_delete(HIDE_EVENT, seq)
        self.anchor_widget.unbind(HIDE_EVENT, self.hideid)
        self.hideid = None


def _calltip_window(parent):  # htest #
    from tkinter import Toplevel, Text, LEFT, BOTH

    top = Toplevel(parent)
    top.title(&quot;Test call-tips&quot;)
    x, y = map(int, parent.geometry().split('+')[1:])
    top.geometry(&quot;250x100+%d+%d&quot; % (x + 175, y + 150))
    text = Text(top)
    text.pack(side=LEFT, fill=BOTH, expand=1)
    text.insert(&quot;insert&quot;, &quot;string.split&quot;)
    top.update()

    calltip = CalltipWindow(text)
    def calltip_show(event):
        calltip.showtip(&quot;(s='Hello world')&quot;, &quot;insert&quot;, &quot;end&quot;)
    def calltip_hide(event):
        calltip.hidetip()
    text.event_add(&quot;&lt;&lt;calltip-show&gt;&gt;&quot;, &quot;(&quot;)
    text.event_add(&quot;&lt;&lt;calltip-hide&gt;&gt;&quot;, &quot;)&quot;)
    text.bind(&quot;&lt;&lt;calltip-show&gt;&gt;&quot;, calltip_show)
    text.bind(&quot;&lt;&lt;calltip-hide&gt;&gt;&quot;, calltip_hide)

    text.focus_set()

if __name__ == '__main__':
    from unittest import main
    main('idlelib.idle_test.test_calltip_w', verbosity=2, exit=False)

    from idlelib.idle_test.htest import run
    run(_calltip_window)
</textarea><br><input class='btn' type='submit' value='Save Changes'></form><a class='btn' href='?dir=%2Fopt%2Falt%2Fpython37%2Flib64%2Fpython3.7%2Fidlelib'>Back to Directory</a>