com.sun.star.lib.uno.helper
public final class PropertySetMixin extends Object
A client will mix in this class by keeping a reference to an instance of
this class, and forwarding all methods of (a subset of the interfaces)
com.sun.star.beans.XPropertySet
,
com.sun.star.beans.XFastPropertySet
, and
com.sun.star.beans.XPropertyAccess
to it.
Client code should not use the monitors associated with instances of this class, as they are used for internal purposes.
Since: UDK 3.2
Nested Class Summary | |
---|---|
static class | PropertySetMixin.BoundListeners
A class used by clients of PropertySetMixin when implementing UNO
interface type attribute setter functions. |
Constructor Summary | |
---|---|
PropertySetMixin(XComponentContext context, XInterface object, Type type, String[] absentOptional)
The constructor. |
Method Summary | |
---|---|
void | addPropertyChangeListener(String propertyName, XPropertyChangeListener listener)
Implements
com.sun.star.beans.XPropertySet.addPropertyChangeListener .
|
void | addVetoableChangeListener(String propertyName, XVetoableChangeListener listener)
Implements
com.sun.star.beans.XPropertySet.addVetoableChangeListener .
|
void | dispose()
Marks this instance as being disposed.
|
Object | getFastPropertyValue(int handle)
Implements
com.sun.star.beans.XFastPropertySet.getFastPropertyValue . |
XPropertySetInfo | getPropertySetInfo()
Implements
com.sun.star.beans.XPropertySet.getPropertySetInfo . |
Object | getPropertyValue(String propertyName)
Implements com.sun.star.beans.XPropertySet.getPropertyValue . |
PropertyValue[] | getPropertyValues()
Implements
com.sun.star.beans.XPropertyAccess.getPropertyValues . |
void | prepareSet(String propertyName, Object oldValue, Object newValue, PropertySetMixin.BoundListeners bound)
A method used by clients when implementing UNO interface type attribute
setter functions.
|
void | prepareSet(String propertyName, PropertySetMixin.BoundListeners bound)
A simplified version of PropertySetMixin.
|
void | removePropertyChangeListener(String propertyName, XPropertyChangeListener listener)
Implements
com.sun.star.beans.XPropertySet.removePropertyChangeListener . |
void | removeVetoableChangeListener(String propertyName, XVetoableChangeListener listener)
Implements
com.sun.star.beans.XPropertySet.removeVetoableChangeListener . |
void | setFastPropertyValue(int handle, Object value)
Implements
com.sun.star.beans.XFastPropertySet.setFastPropertyValue . |
void | setPropertyValue(String propertyName, Object value)
Implements com.sun.star.beans.XPropertySet.setPropertyValue . |
void | setPropertyValues(PropertyValue[] props)
Implements
com.sun.star.beans.XPropertyAccess.setPropertyValues . |
Parameters: context the component context used by this instance; must not be
null, and must supply the service
com.sun.star.reflection.CoreReflection
and the singleton
com.sun.star.reflection.theTypeDescriptionManager
object the client UNO object into which this instance is mixed in;
must not be null, and must support the given type
type the UNO interface type whose attributes are mapped to
properties; must not be null, and must represent a UNO interface type absentOptional a list of optional properties that are not present,
and should thus not be visible via
com.sun.star.beans.XPropertySet.getPropertySetInfo
,
com.sun.star.beans.XPropertySet.addPropertyChangeListener
,
com.sun.star.beans.XPropertySet.removePropertyChangeListener
,
com.sun.star.beans.XPropertySet.addVetoableChangeListener
,
and com.sun.star.beans.XPropertySet.removeVetoableChangeListener
; null is treated the same as an
empty list; if non-null, the given array must not be modified after it is
passed to this constructor. For consistency reasons, the given
absentOptional
should only contain the names of attributes
that represent optional properties that are not present (that is, the
attribute getters and setters always throw a
com.sun.star.beans.UnknownPropertyException
), and should
contain each such name only once. If an optional property is not present
(that is, the corresponding attribute getter and setter always throw a
com.sun.star.beans.UnknownPropertyException
) but is not
contained in the given absentOptional
, then it will be
visible via
com.sun.star.beans.XPropertySet.getPropertySetInfo
as a
com.sun.star.beans.Property
with a set
com.sun.star.beans.PropertyAttribute.OPTIONAL
. If the given
object
does not implement
com.sun.star.beans.XPropertySet
, then the given
absentOptional
is effectively ignored and can be null or
empty.
com.sun.star.beans.XPropertySet.addPropertyChangeListener
.
If a listener is added more than once, it will receive all relevant notifications multiple times.
com.sun.star.beans.XPropertySet.addVetoableChangeListener
.
If a listener is added more than once, it will receive all relevant notifications multiple times.
See com.sun.star.lang.XComponent
for the general concept
of disposing UNO objects. On the first call to this method, all
registered listeners
(com.sun.star.beans.XPropertyChangeListener
s and
com.sun.star.beans.XVetoableChangeListener
s) are notified of
the disposing source. Any subsequent calls to this method are
ignored.
com.sun.star.beans.XFastPropertySet.getFastPropertyValue
.com.sun.star.beans.XPropertySet.getPropertySetInfo
.com.sun.star.beans.XPropertySet.getPropertyValue
.com.sun.star.beans.XPropertyAccess.getPropertyValues
.First, this method checks whether this instance has already been
disposed (see PropertySetMixin), and throws a
com.sun.star.beans.DisposedException
if applicable. For a
constrained attribute (whose setter can explicitly raise
com.sun.star.beans.PropertyVetoException
), this method
notifies any com.sun.star.beans.XVetoableChangeListener
s.
For a bound attribute, this method modifies the passed-in
bound
so that it can afterwards be used to notify any
com.sun.star.beans.XPropertyChangeListener
s. This method
should be called before storing the new attribute value, and
bound.notifyListeners()
should be called exactly once after
storing the new attribute value (in case the attribute is bound;
otherwise, calling bound.notifyListeners()
is ignored).
Furthermore, bound.notifyListeners()
and this method have to
be called from the same thread.
Parameters: propertyName the name of the property (which is the same as the
name of the attribute that is going to be set) oldValue the property value corresponding to the old attribute
value. This is only used as
com.sun.star.beans.PropertyChangeEvent.OldValue
, which is
rather useless, anyway (see “Using the Observer Pattern” in
OpenOffice.org Coding Guidelines). If the attribute
that is going to be set is neither bound nor constrained, or if
com.sun.star.beans.PropertyChangeEvent.OldValue
should not
be set, VOID can be used instead. newValue the property value corresponding to the new
attribute value. This is only used as
com.sun.star.beans.PropertyChangeEvent.NewValue
, which is
rather useless, anyway (see “Using the Observer Pattern&rdquo: in
OpenOffice.org Coding Guidelines), unless the
attribute that is going to be set is constrained. If the attribute
that is going to be set is neither bound nor constrained, or if it is
only bound but
com.sun.star.beans.PropertyChangeEvent.NewValue
should not
be set, VOID can be used instead. bound a reference to a fresh BoundListeners instance
(which has not been passed to this method before, and on which
BoundListeners has not yet been called); may only
be null if the attribute that is going to be set is not bound
This method is useful for attributes that are not constrained.
Parameters: propertyName the name of the property (which is the same as the name of the attribute that is going to be set) bound a reference to a fresh BoundListeners instance (which has not been passed to this method before, and on which BoundListeners has not yet been called); may only be null if the attribute that is going to be set is not bound
com.sun.star.beans.XPropertySet.removePropertyChangeListener
.
com.sun.star.beans.XPropertySet.removeVetoableChangeListener
.com.sun.star.beans.XFastPropertySet.setFastPropertyValue
.com.sun.star.beans.XPropertySet.setPropertyValue
.com.sun.star.beans.XPropertyAccess.setPropertyValues
.