swingutils.events

swingutils.events.addActionListener(target, listener, *args, **kwargs)

Shortcut for addEventListener(target, ActionListener, ‘actionPerformed’, listener).

swingutils.events.addCaretListener(target, listener, *args, **kwargs)

Shortcut for addEventListener(target, CaretListener, ‘caretUpdate’, listener).

swingutils.events.addChangeListener(target, listener, *args, **kwargs)

Shortcut for addEventListener(target, ChangeListener, ‘stateChanged’, listener).

swingutils.events.addDocumentListener(target, listener, *args, **kwargs)

Shortcut for addEventListener(target, DocumentListener, (‘insertUpdate’, ‘removeUpdate’, ‘changedUpdate’), listener).

swingutils.events.addEventListener(target, eventInterface, event, listener, *args, **kwargs)

Adds an event listener to target.

Parameters:

• target – an object that supports listening to the events of the given type (the add*Listener methods must be inherited from a Java class so that autodetection will work)
• eventInterface (Java interface) – the interface that the listener wrapper has to implement (e.g. java.awt.MouseListener)
• event (string or an iterable of strings) – name(s) of the event(s) to listen for (e.g. “mouseClicked”)
• listener (callable) – callable that is called with (event, *args, **kwargs) when the event is fired

Returns:

the listener wrapper that you can use to stop listening to these events (with unlisten())

swingutils.events.addFocusLostListener(target, listener, *args, **kwargs)

Shortcut for addEventListener(target, FocusListener, ‘focusLost’, listener).

swingutils.events.addItemListener(target, listener, *args, **kwargs)

Shortcut for addEventListener(target, ItemListener, ‘itemStateChanged’, listener).

swingutils.events.addListDataListener(target, listener, *args, **kwargs)

Shortcut for addEventListener(target, ListDataListener, (‘contentsChanged’, ‘intervalAdded’, ‘intervalRemoved’), listener).

swingutils.events.addListSelectionListener(target, listener, *args, **kwargs)

Shortcut for addEventListener(target, ListSelectionListener, ‘valueChanged’, listener).

swingutils.events.addMouseClickListener(target, listener, *args, **kwargs)

Shortcut for addEventListener(target, MouseListener, ‘mouseClicked’, listener).

swingutils.events.addPropertyListener(target, property, listener, *args, **kwargs)

Adds a callback that is called when the given property has changed. A listener can either listen to changes in a specific property, or all properties (by supplying None as the property name). The listener is called with (event, *args, **kwargs).

Parameters:

• target – the object whose property will be listened to
• property – name of the property, or None to listen to all property changes

Returns:

the listener wrapper that you can use to stop listening to these events (with obj.removePropertyChangeListener())

swingutils.events.addRowSorterListener(target, listener, *args, **kwargs)

Shortcut for addEventListener(target, addTreeSelectionListener, ‘sorterChanged’, listener).

swingutils.events.addTableModelListener(target, listener, *args, **kwargs)

Shortcut for addEventListener(target, TableModelListener, ‘tableChanged’, listener).

swingutils.events.addTreeSelectionListener(target, listener, *args, **kwargs)

Shortcut for addEventListener(target, TreeSelectionListener, ‘valueChanged’, listener).

swingutils.events.addUndoableEditListener(target, listener, *args, **kwargs)

Shortcut for addEventListener(target, UndoableEditListener, ‘undoableEditHappened’, listener).