Merge pull request matplotlib#25557 from anntzer/en

Rename parameter of Annotation.contains and Legend.contains.

Author: oscargus

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

@@ -0,0 +1,3 @@
+The parameter of ``Annotation.contains`` and ``Legend.contains`` is renamed to *mouseevent*
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+... consistently with `.Artist.contains`.

lib/matplotlib/legend.py

@@ -1173,8 +1173,9 @@ def _find_best_position(self, width, height, renderer, consider=None):
 
         return l, b
 
-    def contains(self, event):
-        return self.legendPatch.contains(event)
+    @_api.rename_parameter("3.8", "event", "mouseevent")
+    def contains(self, mouseevent):
+        return self.legendPatch.contains(mouseevent)
 
     def set_draggable(self, state, use_blit=False, update='loc'):
         """

lib/matplotlib/text.py

@@ -1848,12 +1848,13 @@ def transform(renderer) -> Transform
         # Must come last, as some kwargs may be propagated to arrow_patch.
         Text.__init__(self, x, y, text, **kwargs)
 
-    def contains(self, event):
-        if self._different_canvas(event):
+    @_api.rename_parameter("3.8", "event", "mouseevent")
+    def contains(self, mouseevent):
+        if self._different_canvas(mouseevent):
             return False, {}
-        contains, tinfo = Text.contains(self, event)
+        contains, tinfo = Text.contains(self, mouseevent)
         if self.arrow_patch is not None:
-            in_patch, _ = self.arrow_patch.contains(event)
+            in_patch, _ = self.arrow_patch.contains(mouseevent)
             contains = contains or in_patch
         return contains, tinfo