Merge pull request matplotlib#19019 from anntzer/tkresize

Deprecate never used `resize_callback` param to FigureCanvasTk.

Author: QuLogic

doc/api/next_api_changes/deprecations/19019-AL.rst

@@ -0,0 +1,5 @@
+*resize_callback* parameter to ``FigureCanvasTk``
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+This parameter was never used internally and is deprecated.  Tk-level custom
+event handlers for resize events can be added to a ``FigureCanvasTk`` using
+e.g. ``get_tk_widget().bind('<Configure>', ..., True)``.

lib/matplotlib/backends/_backend_tk.py

@@ -159,6 +159,9 @@ def _on_timer(self):
 class FigureCanvasTk(FigureCanvasBase):
     required_interactive_framework = "tk"
 
+    @cbook._delete_parameter(
+        "3.4", "resize_callback",
+        alternative="get_tk_widget().bind('<Configure>', ..., True)")
     def __init__(self, figure, master=None, resize_callback=None):
         super().__init__(figure)
         self._idle = True