MouseMode

class glue.viewers.common.qt.mouse_mode.MouseMode(viewer, press_callback=None, move_callback=None, release_callback=None, key_callback=None)[source]

Bases: glue.viewers.common.qt.tool.CheckableTool

The base class for all MouseModes.

MouseModes have the following attributes:

  • press_callback : Callback method that will be called whenever a MouseMode processes a mouse press event
  • move_callback : Same as above, for move events
  • release_callback : Same as above, for release events
  • key_callback : Same as above, for release events

The _callback hooks are called with the MouseMode as its only argument

Attributes Summary

action_text
enabled A property that callback functions can be added to.
icon
shortcut
status_tip
tool_id
tool_tip

Methods Summary

activate() Fired when the toolbar button is activated
close(*args)
deactivate() Fired when the toolbar button is deactivated
key(event) Handles key press events.
menu_actions() List of QtWidgets.QActions to be attached to this tool as a context menu.
move(event) Handles mouse move events.
press(event) Handles mouse presses.
release(event) Handles mouse release events.

Attributes Documentation

action_text = None
enabled

A property that callback functions can be added to.

When a callback property changes value, each callback function is called with information about the state change. Otherwise, callback properties behave just like normal instance variables.

CallbackProperties must be defined at the class level. Use the helper function add_callback() to attach a callback to a specific instance of a class with CallbackProperties

Parameters:

default

The initial value for the property

docstring : str

The docstring for the property

getter, setter : func

Custom getter and setter functions (advanced)

icon = None
shortcut = None
status_tip = None
tool_id = None
tool_tip = None

Methods Documentation

activate()

Fired when the toolbar button is activated

close(*args)
deactivate()

Fired when the toolbar button is deactivated

key(event)[source]

Handles key press events.

Calls key_callback method.

Parameters:

event : KeyEvent

The event that was triggered

menu_actions()

List of QtWidgets.QActions to be attached to this tool as a context menu.

move(event)[source]

Handles mouse move events.

Logs mouse position and calls move_callback method.

Parameters:

event : MouseEvent

The event that was triggered

press(event)[source]

Handles mouse presses.

Logs mouse position and calls press_callback method.

Parameters:

event : MouseEvent

The event that was triggered

release(event)[source]

Handles mouse release events.

Logs mouse position and calls release_callback method.

Parameters:

event : MouseEvent

The event that was triggered