:: com :: sun :: star :: ui ::
|
unpublished |
interface XContextChangeEventMultiplexer |
|
|
|
- Usage Restrictions
- not published
- Description
- Provide a central access point for a group of events.
Listeners can be added with a simple restriction on the event source.
They are only called for events that originate at the specified source.
Event providers can broadcast an event to all interested listeners.
The XEventMultiplexer interface is typically implemented as a singleton
|
Methods' Details |
addContextChangeEventListener
- Description
- Add an event listener that is called only when events are broadcast for the specified
event focus.
- Parameter xListener
- An empty reference results in an InvalidArgumentException.
One listener may be added more than once for different
event foci. Adding a listener a second time for the same
event focus results in an InvalidArgumentException.
- Parameter xEventFocus
- An empty reference is a valid value. In this case the
registered listener will be called for every event
broadcast, regardless of its event focus.
The event focus may or may not be the source of the event.
A typical example for an event focus is the XController of
a view. Using an XController restricts events passed to
a listener to events that belong to one view.
- Throws
- com::sun::star::lang::IllegalArgumentException
|
|
removeContextChangeEventListener
- Description
- Remove an event listener for the specified event focus.
When the same listener was added for other event foci then
these associations remain unmodified.
- Parameter xListener
- An empty reference results in an InvalidArgumentException.
When the listener is not registered for the given event
focus then an InvalidArgumentException is thrown.
- Parameter xEventFocus
- The listener is only removed for this event focus.
An empty reference is a valid value.
- Throws
- com::sun::star::lang::IllegalArgumentException
|
|
removeAllContextChangeEventListeners
- Description
- Remove an event listener for all event foci.
- Parameter xListener
- An empty reference results in an InvalidArgumentException.
It is not an error when the listener is not registered for any event focus.
- Throws
- com::sun::star::lang::IllegalArgumentException
|
|
broadcastContextChangeEvent
- Description
- Call all event listeners that where added for the specified event focus.
|
|
Top of Page
Copyright © 2000, 2014 LibreOffice contributors and/or their affiliates. All rights reserved.
LibreOffice was created by The Document Foundation, based on OpenOffice.org, which is Copyright 2000, 2010 Oracle and/or its affiliates.
The Document Foundation acknowledges all community members, please find more info at our website.
Privacy Policy | Impressum (Legal Info) | Copyright information: The source code of LibreOffice is licensed under the GNU Lesser General Public License (LGPLv3). "LibreOffice" and "The Document Foundation" are registered trademarks of their corresponding registered owners or are in actual use as trademarks in one or more countries. Their respective logos and icons are also subject to international copyright laws. Use thereof is explained in our trademark policy.