"""

============

Mouse Cursor

============

This example sets an alternative cursor on a figure canvas.

Note, this is an interactive example, and must be run to see the effect.

"""

import matplotlib.pyplot as plt

from matplotlib.backend_tools import Cursors

fig, axs = plt.subplots(len(Cursors), figsize=(6, len(Cursors) + 0.5),

gridspec_kw={'hspace': 0})

fig.suptitle('Hover over an Axes to see alternate Cursors')

for cursor, ax in zip(Cursors, axs):

ax.cursor_to_use = cursor

ax.text(0.5, 0.5, cursor.name,

horizontalalignment='center', verticalalignment='center')

ax.set(xticks=[], yticks=[])

def hover(event):

if fig.canvas.widgetlock.locked():

# Don't do anything if the zoom/pan tools have been enabled.

return

fig.canvas.set_cursor(

event.inaxes.cursor_to_use if event.inaxes else Cursors.POINTER)

fig.canvas.mpl_connect('motion_notify_event', hover)

plt.show()

#############################################################################

#

# .. admonition:: References

#

# The use of the following functions, methods, classes and modules is shown

# in this example:

#

# - `matplotlib.backend_bases.FigureCanvasBase.set_cursor`