ooodev.adapter.awt.text_events module
- class ooodev.adapter.awt.text_events.TextEvents(trigger_args=None, cb=None, listener=None, subscriber=None)[source]
Bases:
object
Class for managing Text Events.
This class is usually inherited by control classes that implement
com.sun.star.awt.XTextListener
.- Parameters:
trigger_args (GenericArgs | None) –
cb (ListenerEventCallbackT | None) –
listener (TextListener | None) –
subscriber (XTextComponent | 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 (TextListener | None, optional) – Listener that is used to manage events.
subscriber (XTextComponent, optional) – An UNO object that implements the
XTextComponent
interface. If passed in then this instance listener is automatically added to it.
- Return type:
None
- add_event_text_changed(cb)[source]
Adds a listener for an event.
Event is invoked when the text has changed.
The callback
EventArgs.event_data
will contain a UNOcom.sun.star.awt.TextEvent
struct.- Return type:
None
- Parameters:
cb (Any) –
- add_event_text_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 UNOcom.sun.star.lang.EventObject
struct.- Return type:
None
- Parameters:
cb (Any) –
- remove_event_text_changed(cb)[source]
Removes a listener for an event
- Return type:
None
- Parameters:
cb (Any) –
- remove_event_text_events_disposing(cb)[source]
Removes a listener for an event
- Return type:
None
- Parameters:
cb (Any) –
- property events_listener_text: TextListener
Returns listener
- Return type:
- ooodev.adapter.awt.text_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 TextEvents 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.