LibreOffice
LibreOffice 24.2 SDK API Reference
|
Manage the set of registered event listeners and the event notification for a configuration controller. More...
import"XConfigurationControllerBroadcaster.idl";
Public Member Functions | |
void | addConfigurationChangeListener ([in] XConfigurationChangeListener xListener, [in] string sEventType, [in] any aUserData) |
Add a new listener for configuration changes. More... | |
void | removeConfigurationChangeListener ([in] XConfigurationChangeListener xListener) |
Remove a listener for configuration changes. More... | |
void | notifyEvent ([in] ConfigurationChangeEvent aEvent) |
With this method other objects can send events to all the registered listeners. More... | |
Manage the set of registered event listeners and the event notification for a configuration controller.
The listeners are called in the order in which they are registered.
void addConfigurationChangeListener | ( | [in] XConfigurationChangeListener | xListener, |
[in] string | sEventType, | ||
[in] any | aUserData | ||
) |
Add a new listener for configuration changes.
The listener is notified only for the specified type of configuration changes. When the listener is interested in more than one event type this method has to be called multiple times. Alternatively it can register as universal listener that will be called for all event types. However, this option is provided primarily to support debugging and monitoring.
xListener | The new listener. |
sEventType | The event type that the listener is interested in. The set of event types is not fixed and there can be no exhaustive list. The empty string is a special value in that the listener will be called for all types of event. |
aUserData | Arbitrary data that is passed to the listener when it is called for the specified event type. When one listener is registered for more than one event type then different user data objects may be given as well. Supplying unique integer values allows the listener to use a switch statement to distinguish between the different event types. |
void notifyEvent | ( | [in] ConfigurationChangeEvent | aEvent | ) |
With this method other objects can send events to all the registered listeners.
void removeConfigurationChangeListener | ( | [in] XConfigurationChangeListener | xListener | ) |
Remove a listener for configuration changes.
xListener | The listener that is to be removed. |