Language

The Free and Open Productivity Suite
Released: Apache OpenOffice 4.1.11
 Overview   Namespace   Class   Index   Help 

Methods of Class OPropertySetHelper


OPropertySetHelper
OPropertySetHelper(
OBroadcastHelper & rBHelper ) throw();

virtual abstract const volatile template static inline C-linkage
NO NO NO NO NO NO NO NO

Parameters
rBHelper
this structure containes the basic members of
a broadcaster.
The lifetime must be longer than the lifetime
of this object. Stored in the variable rBHelper.

~OPropertySetHelper
~OPropertySetHelper() throw();

virtual abstract const volatile template static inline C-linkage
NO NO NO NO NO NO NO NO

Summary
You must call disposing before destruction.

queryInterface
::com::sun::star::uno::Any queryInterface(
const ::com::sun::star::uno::Type & rType )
throw( ::com::sun::star::uno::RuntimeException );

virtual abstract const volatile template static inline C-linkage
NO NO NO NO NO NO NO NO

Summary
Only returns a reference to XMultiPropertySet, XFastPropertySet, XPropertySet and XEventListener.

disposing
void disposing() throw();

virtual abstract const volatile template static inline C-linkage
NO NO NO NO NO NO NO NO

Summary
Send a disposing notification to the listeners in the conatiners aBoundLC and aVetoableLC.
See Also
OComponentHelper

setPropertyValue
virtual void setPropertyValue(
const ::rtl::OUString & rPropertyName,
const ::com::sun::star::uno::Any & aValue )
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 abstract const volatile template static inline C-linkage
YES NO NO NO NO NO NO NO

Description
Throw UnknownPropertyException or PropertyVetoException if the property with the name rPropertyName does not exist or is readonly. Otherwise rPropertyName is changed to its handle value and setFastPropertyValue is called.

getPropertyValue
virtual ::com::sun::star::uno::Any getPropertyValue(
const ::rtl::OUString & aPropertyName )
throw( ::com::sun::star::beans::UnknownPropertyException, ::com::sun::star::lang::WrappedTargetException, ::com::sun::star::uno::RuntimeException );

virtual abstract const volatile template static inline C-linkage
YES NO NO NO NO NO NO NO

Summary
Throw UnknownPropertyException if the property with the name rPropertyName does not exist.

addPropertyChangeListener
virtual void addPropertyChangeListener(
const ::rtl::OUString & aPropertyName,
const ::com::sun::star::uno::Reference< ::com::sun::star::beans::XPropertyChangeListener > & aListener )
throw( ::com::sun::star::beans::UnknownPropertyException, ::com::sun::star::lang::WrappedTargetException, ::com::sun::star::uno::RuntimeException );

virtual abstract const volatile template static inline C-linkage
YES NO NO NO NO NO NO NO

Summary
Ignored if the property is not bound.

removePropertyChangeListener
virtual void removePropertyChangeListener(
const ::rtl::OUString & aPropertyName,
const ::com::sun::star::uno::Reference< ::com::sun::star::beans::XPropertyChangeListener > & aListener )
throw( ::com::sun::star::beans::UnknownPropertyException, ::com::sun::star::lang::WrappedTargetException, ::com::sun::star::uno::RuntimeException );

virtual abstract const volatile template static inline C-linkage
YES NO NO NO NO NO NO NO

Summary
Ignored if the property is not bound.

addVetoableChangeListener
virtual void addVetoableChangeListener(
const ::rtl::OUString & aPropertyName,
const ::com::sun::star::uno::Reference< ::com::sun::star::beans::XVetoableChangeListener > & aListener )
throw( ::com::sun::star::beans::UnknownPropertyException, ::com::sun::star::lang::WrappedTargetException, ::com::sun::star::uno::RuntimeException );

virtual abstract const volatile template static inline C-linkage
YES NO NO NO NO NO NO NO

Summary
Ignored if the property is not constrained.

removeVetoableChangeListener
virtual void removeVetoableChangeListener(
const ::rtl::OUString & aPropertyName,
const ::com::sun::star::uno::Reference< ::com::sun::star::beans::XVetoableChangeListener > & aListener )
throw( ::com::sun::star::beans::UnknownPropertyException, ::com::sun::star::lang::WrappedTargetException, ::com::sun::star::uno::RuntimeException );

virtual abstract const volatile template static inline C-linkage
YES NO NO NO NO NO NO NO

Summary
Ignored if the property is not constrained.

setFastPropertyValue
virtual void setFastPropertyValue(
sal_Int32 nHandle,
const ::com::sun::star::uno::Any & rValue )
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 abstract const volatile template static inline C-linkage
YES NO NO NO NO NO NO NO

Description
Throw UnknownPropertyException or PropertyVetoException if the property with the name rPropertyName does not exist or is readonly. Otherwise the method convertFastPropertyValue is called, then the vetoable listeners are notified. After this the value of the property is changed with the setFastPropertyValue_NoBroadcast method and the bound listeners are notified.

getFastPropertyValue
virtual ::com::sun::star::uno::Any getFastPropertyValue(
sal_Int32 nHandle )
throw( ::com::sun::star::beans::UnknownPropertyException, ::com::sun::star::lang::WrappedTargetException, ::com::sun::star::uno::RuntimeException );

virtual abstract const volatile template static inline C-linkage
YES NO NO NO NO NO NO NO


setPropertyValues
virtual void setPropertyValues(
const ::com::sun::star::uno::Sequence< ::rtl::OUString > & PropertyNames,
const ::com::sun::star::uno::Sequence< ::com::sun::star::uno::Any > & Values )
throw( ::com::sun::star::beans::PropertyVetoException, ::com::sun::star::lang::IllegalArgumentException, ::com::sun::star::lang::WrappedTargetException, ::com::sun::star::uno::RuntimeException );

virtual abstract const volatile template static inline C-linkage
YES NO NO NO NO NO NO NO


getPropertyValues
virtual ::com::sun::star::uno::Sequence< ::com::sun::star::uno::Any > getPropertyValues(
const ::com::sun::star::uno::Sequence< ::rtl::OUString > & PropertyNames )
throw( ::com::sun::star::uno::RuntimeException );

virtual abstract const volatile template static inline C-linkage
YES NO NO NO NO NO NO NO


addPropertiesChangeListener
virtual void addPropertiesChangeListener(
const ::com::sun::star::uno::Sequence< ::rtl::OUString > & PropertyNames,
const ::com::sun::star::uno::Reference< ::com::sun::star::beans::XPropertiesChangeListener > & Listener )
throw( ::com::sun::star::uno::RuntimeException );

virtual abstract const volatile template static inline C-linkage
YES NO NO NO NO NO NO NO


removePropertiesChangeListener
virtual void removePropertiesChangeListener(
const ::com::sun::star::uno::Reference< ::com::sun::star::beans::XPropertiesChangeListener > & Listener )
throw( ::com::sun::star::uno::RuntimeException );

virtual abstract const volatile template static inline C-linkage
YES NO NO NO NO NO NO NO


firePropertiesChangeEvent
virtual void firePropertiesChangeEvent(
const ::com::sun::star::uno::Sequence< ::rtl::OUString > & PropertyNames,
const ::com::sun::star::uno::Reference< ::com::sun::star::beans::XPropertiesChangeListener > & Listener )
throw( ::com::sun::star::uno::RuntimeException );

virtual abstract const volatile template static inline C-linkage
YES NO NO NO NO NO NO NO


fire
void fire(
sal_Int32 * pnHandles,
const ::com::sun::star::uno::Any * pNewValues,
const ::com::sun::star::uno::Any * pOldValues,
sal_Int32 nCount,
sal_Bool bVetoable );

virtual abstract const volatile template static inline C-linkage
NO NO NO NO NO NO NO NO

Summary
This method fire events to all registered property listeners.
Parameters
pnHandles
the id's of the properties that changed.
pNewValues
the new values of the properties.
pOldValues
the old values of the properties.
nCount
the number of elements in the arrays pnHandles, pNewValues and pOldValues.
bVetoable
true means fire to VetoableChangeListener, false means fire to
           XPropertyChangedListener and XMultiPropertyChangedListener.

setFastPropertyValues
void setFastPropertyValues(
sal_Int32 nSeqLen,
sal_Int32 * pHandles,
const ::com::sun::star::uno::Any * pValues,
sal_Int32 nHitCount )
throw( ::com::sun::star::uno::Exception );

virtual abstract const volatile template static inline C-linkage
NO NO NO NO NO NO NO NO

Summary
Set multiple properties with the handles.
Parameters
nSeqLen
the length of the arrays pHandles and Values.
pHandles
the handles of the properties. The number of elements
       in the Values sequence is the length of the handle array. A value of -1
       of a handle means invalid property. These are ignored.
pValues
the values of the properties.
nHitCount
the number of valid entries in the handle array.

getInfoHelper
virtual IPropertyArrayHelper & getInfoHelper() = 0;

virtual abstract const volatile template static inline C-linkage
YES YES NO NO NO NO NO NO

Summary
This abstract method must return the name to index table. This table contains all property names and types of this object. The method is not implemented in this class.

convertFastPropertyValue
virtual sal_Bool convertFastPropertyValue(
::com::sun::star::uno::Any & rConvertedValue,
::com::sun::star::uno::Any & rOldValue,
sal_Int32 nHandle,
const ::com::sun::star::uno::Any & rValue )
throw( ::com::sun::star::lang::IllegalArgumentException ) = 0;

virtual abstract const volatile template static inline C-linkage
YES YES NO NO NO NO NO NO

Description
Converted the value rValue and return the result in rConvertedValue and the old value in rOldValue. A IllegalArgumentException is thrown. The method is not implemented in this class. After this call the vetoable listeners are notified.
Parameters
rConvertedValue
the converted value. Only set if return is true.
rOldValue
the old value. Only set if return is true.
nHandle
the handle of the proberty.
Return
true if the value converted.

setFastPropertyValue_NoBroadcast
virtual void setFastPropertyValue_NoBroadcast(
sal_Int32 nHandle,
const ::com::sun::star::uno::Any & rValue )
throw( ::com::sun::star::uno::Exception ) = 0;

virtual abstract const volatile template static inline C-linkage
YES YES NO NO NO NO NO NO

Description
The same as setFastProperyValue; nHandle is always valid. The changes must not be broadcasted in this method. The method is implemented in a derived class.
ATTENTION!
Although you are permitted to throw any UNO exception, only the following are valid for usage: -- ::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
Parameters
nHandle
       handle
rValue
       value

getFastPropertyValue
virtual void getFastPropertyValue(
::com::sun::star::uno::Any & rValue,
sal_Int32 nHandle ) const = 0;

virtual abstract const volatile template static inline C-linkage
YES YES YES NO NO NO NO NO

Description
The same as getFastProperyValue, but return the value through rValue and nHandle is always valid. The method is not implemented in this class.

OPropertySetHelper
OPropertySetHelper(
const OPropertySetHelper & ) throw();

virtual abstract const volatile template static inline C-linkage
NO NO NO NO NO NO NO NO


operator=
OPropertySetHelper & operator=(
const OPropertySetHelper & ) throw();

virtual abstract const volatile template static inline C-linkage
NO NO NO NO NO NO NO NO


createPropertySetInfo
static ::com::sun::star::uno::Reference< ::com::sun::star::beans::XPropertySetInfo > createPropertySetInfo(
IPropertyArrayHelper & rProperties ) throw();

virtual abstract const volatile template static inline C-linkage
NO NO NO NO NO YES NO NO

Summary
The property sequence is created in the call. The interface isn't used after the call.

Top of Page

Apache Software Foundation

Copyright & License | Privacy | Contact Us | Donate | Thanks

Apache, OpenOffice, OpenOffice.org and the seagull logo are registered trademarks of The Apache Software Foundation. The Apache feather logo is a trademark of The Apache Software Foundation. Other names appearing on the site may be trademarks of their respective owners.