My Project
UDK 3.2.7 C/C++ API Reference
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Macros Pages
Classes | Protected Types | Protected Member Functions | Friends | List of all members
cppu::PropertySetMixinImpl Class Reference

A helper base class for cppu::PropertySetMixin. More...

#include <propertysetmixin.hxx>

Inheritance diagram for cppu::PropertySetMixinImpl:
cppu::PropertySetMixin< T >

Classes

class  BoundListeners
 A class used by subclasses of cppu::PropertySetMixin when implementing UNO interface type attribute setter functions. More...

Protected Types

enum  Implements { IMPLEMENTS_PROPERTY_SET = 1, IMPLEMENTS_FAST_PROPERTY_SET = 2, IMPLEMENTS_PROPERTY_ACCESS = 4 }
 Flags used by subclasses of cppu::PropertySetMixin to specify what UNO interface types shall be supported. More...

Protected Member Functions

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.
void dispose ()
 Mark this instance as being disposed.
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.
virtual
com::sun::star::uno::Reference
< com::sun::star::beans::XPropertySetInfo > 
getPropertySetInfo () throw (com::sun::star::uno::RuntimeException)
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)
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)
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)
 Adds a com::sun::star::beans::XPropertyChangeListener.
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)
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)
 Adds a com::sun::star::beans::XVetoableChangeListener.
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)
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)
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)
virtual
com::sun::star::uno::Sequence
< com::sun::star::beans::PropertyValue > 
getPropertyValues () throw (com::sun::star::uno::RuntimeException)
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)

Friends

class Impl
class PropertySetMixin

Detailed Description

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

Member Enumeration Documentation

Flags used by subclasses of cppu::PropertySetMixin to specify what UNO interface types shall be supported.

Enumerator:
IMPLEMENTS_PROPERTY_SET 

Flag specifying that the UNO interface type com::sun::star::beans::XPropertySet shall be supported.

IMPLEMENTS_FAST_PROPERTY_SET 

Flag specifying that the UNO interface type com::sun::star::beans::XFastPropertySet shall be supported.

IMPLEMENTS_PROPERTY_ACCESS 

Flag specifying that the UNO interface type com::sun::star::beans::XPropertyAccess shall be supported.

Member Function Documentation

virtual void cppu::PropertySetMixinImpl::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)
protectedvirtual

Adds a com::sun::star::beans::XPropertyChangeListener.

If a listener is added more than once, it will receive all relevant notifications multiple times.

See Also
com::sun::star::beans::XPropertySet::addPropertyChangeListener
virtual void cppu::PropertySetMixinImpl::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)
protectedvirtual

Adds a com::sun::star::beans::XVetoableChangeListener.

If a listener is added more than once, it will receive all relevant notifications multiple times.

See Also
com::sun::star::beans::XPropertySet::addVetoableChangeListener
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::XPropertyChangeListeners and com::sun::star::beans::XVetoableChangeListeners) 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.

virtual com::sun::star::uno::Any cppu::PropertySetMixinImpl::getFastPropertyValue ( sal_Int32  handle) throw ( com::sun::star::beans::UnknownPropertyException, com::sun::star::lang::WrappedTargetException, com::sun::star::uno::RuntimeException)
protectedvirtual
virtual com::sun::star::uno::Reference< com::sun::star::beans::XPropertySetInfo > cppu::PropertySetMixinImpl::getPropertySetInfo ( ) throw (com::sun::star::uno::RuntimeException)
protectedvirtual
virtual com::sun::star::uno::Any cppu::PropertySetMixinImpl::getPropertyValue ( rtl::OUString const &  propertyName) throw ( com::sun::star::beans::UnknownPropertyException, com::sun::star::lang::WrappedTargetException, com::sun::star::uno::RuntimeException)
protectedvirtual
virtual com::sun::star::uno::Sequence< com::sun::star::beans::PropertyValue > cppu::PropertySetMixinImpl::getPropertyValues ( ) throw (com::sun::star::uno::RuntimeException)
protectedvirtual
void cppu::PropertySetMixinImpl::prepareSet ( rtl::OUString const &  propertyName,
com::sun::star::uno::Any const &  oldValue,
com::sun::star::uno::Any const &  newValue,
BoundListeners boundListeners 
)
protected

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::XVetoableChangeListeners. 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::XPropertyChangeListeners. 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
propertyNamethe name of the property (which is the same as the name of the attribute that is going to be set)
oldValuethe 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.
newValuethe 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.
boundListenersa 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
virtual com::sun::star::uno::Any cppu::PropertySetMixinImpl::queryInterface ( com::sun::star::uno::Type const &  type) throw (com::sun::star::uno::RuntimeException)
protectedvirtual

A function used by subclasses of cppu::PropertySetMixin when implementing com::sun::star::uno::XInterface::queryInterface.

This function checks for support of any of the UNO interface types specified in the call of the cppu::PropertySetMixin constructor. It does not check for any other UNO interface types (not even for com::sun::star::uno::XInterface), and should not be used directly as the implementation of com::sun::star::uno::XInterface::queryInterface of this UNO object.

virtual void cppu::PropertySetMixinImpl::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)
protectedvirtual
virtual void cppu::PropertySetMixinImpl::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)
protectedvirtual
virtual void cppu::PropertySetMixinImpl::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)
protectedvirtual
virtual void cppu::PropertySetMixinImpl::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)
protectedvirtual
virtual void cppu::PropertySetMixinImpl::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)
protectedvirtual

Friends And Related Function Documentation

friend class Impl
friend
friend class PropertySetMixin
friend

The documentation for this class was generated from the following file: