ooodev.adapter.awt.enhanced_mouse_click_events module

class ooodev.adapter.awt.enhanced_mouse_click_events.EnhancedMouseClickEvents(trigger_args=None, cb=None, listener=None, subscriber=None)[source]

Bases: object

Class for managing Enhanced Mouse Click Events.

Parameters:

trigger_args (GenericArgs | None) –
cb (ListenerEventCallbackT | None) –
listener (EnhancedMouseClickHandler | None) –
subscriber (XEnhancedMouseClickBroadcaster | None) –

__init__(trigger_args=None, cb=None, listener=None, subscriber=None)[source]

Constructor

Parameters:

trigger_args (GenericArgs, optional) – Args that are passed to events when they are triggered. This only applies if the listener is not passed.
cb (ListenerEventCallbackT | None, optional) – Callback that is invoked when an event is added or removed.
listener (EnhancedMouseClickHandler | None, optional) – Listener that is used to manage events.
subscriber (XEnhancedMouseClickBroadcaster, optional) – An UNO object that implements the XEnhancedMouseClickBroadcaster interface. If passed in then this instance listener is automatically added to it.

Return type:

None

add_event_enhanced_mouse_click_events_disposing(cb)[source]

Adds a listener for an event.

Event is invoked when the broadcaster is about to be disposed.

The callback EventArgs.event_data will contain a UNO com.sun.star.lang.EventObject struct.

Return type:: None
Parameters:: cb (Any) –

add_event_mouse_pressed(cb)[source]

Adds a listener for an event.

Event is invoked when a mouse button has been pressed on a window.

The callback CancelEventArgs.event_data will contain a UNO com.sun.star.awt.EnhancedMouseEvent struct.

Note

The callback event will be CancelEventArgs. If the CancelEventArgs.cancel is set to True then the action will be canceled if the CancelEventArgs.handled is set to True then the action will be performed.

Return type:: None
Parameters:: cb (Any) –

add_event_mouse_released(cb)[source]

Adds a listener for an event.

Event is invoked when a mouse button has been released on a window.

The callback CancelEventArgs.event_data will contain a UNO com.sun.star.awt.EnhancedMouseEvent struct.

Note

The callback event will be CancelEventArgs. If the CancelEventArgs.cancel is set to True then the action will be canceled if the CancelEventArgs.handled is set to True then the action will be performed.

Return type:: None
Parameters:: cb (Any) –

remove_event_enhanced_mouse_click_events_disposing(cb)[source]

Removes a listener for an event

Return type:: None
Parameters:: cb (Any) –

remove_event_mouse_pressed(cb)[source]

Removes a listener for an event

Return type:: None
Parameters:: cb (Any) –

remove_event_mouse_released(cb)[source]

Removes a listener for an event

Return type:: None
Parameters:: cb (Any) –

property events_listener_enhanced_mouse_click: EnhancedMouseClickHandler

Returns listener

Return type:: EnhancedMouseClickHandler

ooodev.adapter.awt.enhanced_mouse_click_events.on_lazy_cb(source, event)[source]

Callback that is invoked when an event is added or removed.

This method is generally used to add the listener to the component in a lazy manner. This means this callback will only be called once in the lifetime of the component.

Parameters:

source (Any) – Expected to be an instance of EnhancedMouseClickEvents that is a partial class of a component based class.
event (ListenerEventArgs) – Event arguments.

Return type:

None

Warning

This method is intended for internal use only.