|
void | prepareSet (rtl::OUString const &propertyName, com::sun::star::uno::Any const &oldValue, com::sun::star::uno::Any const &newValue, BoundListeners *boundListeners) |
| A function used by subclasses of cppu::PropertySetMixin when implementing UNO interface type attribute setter functions. More...
|
|
void | dispose () |
| Mark this instance as being disposed. More...
|
|
virtual com::sun::star::uno::Any | queryInterface (com::sun::star::uno::Type const &type) throw (com::sun::star::uno::RuntimeException) |
| A function used by subclasses of cppu::PropertySetMixin when implementing com::sun::star::uno::XInterface::queryInterface . More...
|
|
virtual
com::sun::star::uno::Reference
< com::sun::star::beans::XPropertySetInfo > | getPropertySetInfo () throw (com::sun::star::uno::RuntimeException, std::exception) |
|
virtual void | setPropertyValue (rtl::OUString const &propertyName, com::sun::star::uno::Any const &value) throw ( com::sun::star::beans::UnknownPropertyException, com::sun::star::beans::PropertyVetoException, com::sun::star::lang::IllegalArgumentException, com::sun::star::lang::WrappedTargetException, com::sun::star::uno::RuntimeException, std::exception) |
|
virtual com::sun::star::uno::Any | getPropertyValue (rtl::OUString const &propertyName) throw ( com::sun::star::beans::UnknownPropertyException, com::sun::star::lang::WrappedTargetException, com::sun::star::uno::RuntimeException, std::exception) |
|
virtual void | addPropertyChangeListener (rtl::OUString const &propertyName, com::sun::star::uno::Reference< com::sun::star::beans::XPropertyChangeListener > const &listener) throw ( com::sun::star::beans::UnknownPropertyException, com::sun::star::lang::WrappedTargetException, com::sun::star::uno::RuntimeException, std::exception) |
| Adds a com::sun::star::beans::XPropertyChangeListener . More...
|
|
virtual void | removePropertyChangeListener (rtl::OUString const &propertyName, com::sun::star::uno::Reference< com::sun::star::beans::XPropertyChangeListener > const &listener) throw ( com::sun::star::beans::UnknownPropertyException, com::sun::star::lang::WrappedTargetException, com::sun::star::uno::RuntimeException, std::exception) |
|
virtual void | addVetoableChangeListener (rtl::OUString const &propertyName, com::sun::star::uno::Reference< com::sun::star::beans::XVetoableChangeListener > const &listener) throw ( com::sun::star::beans::UnknownPropertyException, com::sun::star::lang::WrappedTargetException, com::sun::star::uno::RuntimeException, std::exception) |
| Adds a com::sun::star::beans::XVetoableChangeListener . More...
|
|
virtual void | removeVetoableChangeListener (rtl::OUString const &propertyName, com::sun::star::uno::Reference< com::sun::star::beans::XVetoableChangeListener > const &listener) throw ( com::sun::star::beans::UnknownPropertyException, com::sun::star::lang::WrappedTargetException, com::sun::star::uno::RuntimeException, std::exception) |
|
virtual void | setFastPropertyValue (sal_Int32 handle, com::sun::star::uno::Any const &value) throw ( com::sun::star::beans::UnknownPropertyException, com::sun::star::beans::PropertyVetoException, com::sun::star::lang::IllegalArgumentException, com::sun::star::lang::WrappedTargetException, com::sun::star::uno::RuntimeException, std::exception) |
|
virtual com::sun::star::uno::Any | getFastPropertyValue (sal_Int32 handle) throw ( com::sun::star::beans::UnknownPropertyException, com::sun::star::lang::WrappedTargetException, com::sun::star::uno::RuntimeException, std::exception) |
|
virtual
com::sun::star::uno::Sequence
< com::sun::star::beans::PropertyValue > | getPropertyValues () throw (com::sun::star::uno::RuntimeException, std::exception) |
|
virtual void | setPropertyValues (com::sun::star::uno::Sequence< com::sun::star::beans::PropertyValue > const &props) throw ( com::sun::star::beans::UnknownPropertyException, com::sun::star::beans::PropertyVetoException, com::sun::star::lang::IllegalArgumentException, com::sun::star::lang::WrappedTargetException, com::sun::star::uno::RuntimeException, std::exception) |
|
A helper base class for cppu::PropertySetMixin
.
See the documentation of cppu::PropertySetMixin
for further details.
That cppu::PropertySetMixin
is derived from this base class should be considered an implementation detail. The functionality of cppu::PropertySetMixin
that is inherited from this base class and is visible to subclasses of cppu::PropertySetMixin
should be treated by such subclasses as being provided by cppu::PropertySetMixin
directly (e.g., in such subclasses, use “PropertySetMixin::Implements
” instead of “PropertySetMixinImpl::Implements
”).
- Since
- UDK 3.2.1
void cppu::PropertySetMixinImpl::dispose |
( |
| ) |
|
|
protected |
Mark this instance as being disposed.
See com::sun::star::lang::XComponent
for the general concept of disposing UNO objects. On the first call to this function, 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 function are ignored.
May throw com::sun::star::uno::RuntimeException
and std::bad_alloc
.
A function used by subclasses of cppu::PropertySetMixin
when implementing UNO interface type attribute setter functions.
First, this function checks whether this instance has already been disposed (see cppu::PropertySetMixinImpl::dispose
), and throws a com::sun::star::lang::DisposedException
if applicable. For a constrained attribute (whose setter can explicitly raise com::sun::star::beans::PropertyVetoException
), this function notifies any com::sun::star::beans::XVetoableChangeListener
s. For a bound attribute, this function modifies the passed-in boundListeners
so that it can afterwards be used to notify any com::sun::star::beans::XPropertyChangeListener
s. This function should be called before storing the new attribute value, and boundListeners->notify()
should be called exactly once after storing the new attribute value (in case the attribute is bound; otherwise, calling boundListeners->notify()
is ignored). Furthermore, boundListeners->notify()
and this function have to be called from the same thread.
May throw com::sun::star::beans::PropertyVetoException
, com::sun::star::uno::RuntimeException
(and com::sun::star::lang::DisposedException
in particular), and std::bad_alloc
.
- 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, a VOID Any 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” 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, a VOID Any can be used instead. |
boundListeners | a pointer to a fresh cppu::PropertySetMixinImpl::BoundListeners instance (which has not been passed to this function before, and on which notify has not yet been called); may only be null if the attribute that is going to be set is not bound |