Type hints

src/ScrollableContainers/_tk.py

@@ -46,7 +46,7 @@ def __init__(self, *args, **kwargs):
         self._canvas.xview_moveto(0.0)
         self._canvas.yview_moveto(0.0)
 
-    def _xview(self, *args, width=None):
+    def _xview(self, *args, width: int | None = None):
         """
         Called when a horizontal scroll is requested. Called by other callbacks
         (``_on_canvas_configure`` and ``_on_frame_configure``) whenever it is
@@ -55,7 +55,7 @@ def _xview(self, *args, width=None):
         move the scrollbar to such a position that they are horizontally
         centred.
 
-        :param args: Tuple which can be passed to ``tkinter.Canvas.xview``.
+        :param args: Passed to ``tkinter.Canvas.xview``.
         :param width: Width of the canvas.
         """
         if self._canvas.xview() != (0.0, 1.0):
@@ -74,12 +74,12 @@ def _yview(self, *args):
         Called when a vertical scroll is requested. Scroll the view only if the
         contents are not completely visible.
 
-        :param args: Tuple which can be passed to ``tkinter.Canvas.yview``.
+        :param args: Passed to ``tkinter.Canvas.yview``.
         """
         if self._canvas.yview() != (0.0, 1.0):
             self._canvas.yview(*args)
 
-    def _on_canvas_configure(self, event):
+    def _on_canvas_configure(self, event: tk.Event):
         """
         Called when the canvas is resized. Update the scrollable region.
 
@@ -88,20 +88,20 @@ def _on_canvas_configure(self, event):
         self._canvas.configure(scrollregion=self._canvas.bbox(tk.ALL))
         self._xview(tk.SCROLL, 0, tk.UNITS, width=event.width)
 
-    def _on_frame_configure(self, _=None):
+    def _on_frame_configure(self, _event: tk.Event | None = None):
         """
         Called when the frame is resized or the canvas is scrolled. Update the
         scrollable region.
 
         This method is necessary to handle updates which may occur after the
         GUI loop has started.
 
-        :param _: Configure event.
+        :param _event: Configure event.
         """
         self._canvas.configure(scrollregion=self._canvas.bbox(tk.ALL))
         self._xview(tk.SCROLL, 0, tk.UNITS)
 
-    def _on_frame_expose(self, _=None):
+    def _on_frame_expose(self, _event: tk.Event | None = None):
         """
         Called when the frame becomes visible. Call ``_on_frame_configure`` and
         then disable this callback.
@@ -113,34 +113,34 @@ def _on_frame_expose(self, _=None):
         because its frame configure events work differently.) Hence, I try to
         centre the contents again upon an expose event.
 
-        :param _: Expose event.
+        :param _event: Expose event.
         """
         self._on_frame_configure()
         self.frame.unbind("<Expose>", self._on_frame_expose_id)
 
-    def _on_canvas_enter(self, _=None):
+    def _on_canvas_enter(self, _event: tk.Event | None = None):
         """
         Called when the mouse pointer enters the canvas. Set up vertical
         scrolling with the mouse wheel.
 
-        :param _: Enter event.
+        :param _event: Enter event.
         """
         self.bind_all("<Button-4>", self._on_mouse_scroll)
         self.bind_all("<Button-5>", self._on_mouse_scroll)
         self.bind_all("<MouseWheel>", self._on_mouse_scroll)
 
-    def _on_canvas_leave(self, _=None):
+    def _on_canvas_leave(self, _event: tk.Event | None = None):
         """
         Called when the mouse pointer leaves the canvas. Unset vertical
         scrolling with the mouse wheel.
 
-        :param _: Leave event.
+        :param _event: Leave event.
         """
         self.unbind_all("<Button-4>")
         self.unbind_all("<Button-5>")
         self.unbind_all("<MouseWheel>")
 
-    def _on_mouse_scroll(self, event):
+    def _on_mouse_scroll(self, event: tk.Event):
         """
         Called when the mouse wheel is scrolled or a two-finger swipe gesture
         is performed on the touchpad. Ask to scroll the view horizontally if