:: com :: sun :: star :: beans ::

interface XTolerantMultiPropertySet

Methods' Summary
setPropertyValuesTolerant sets the values to the properties with the specified names.  
getPropertyValuesTolerant retrieve the values of the specified properties  
getDirectPropertyValuesTolerant retrieve only those values of the specified properties which are direct values.  
Methods' Details
setPropertyValuesTolerant
sequence< SetPropertyTolerantFailed >
setPropertyValuesTolerant( [in] sequence< string >  aPropertyNames,
[in] sequence< any >  aValues )
raises( ::com::sun::star::lang::IllegalArgumentException );

Description
sets the values to the properties with the specified names.
Parameter aPropertyNames
specifies the names of the properties. The property names must be sorted ascending.

If the names are not sorted the behaviour of the method is undefined!

Parameter aPropertyValues
specifies the values of the properties. The order of the values has to be the same as in the aPropertyNames parameter int order to match the property name with its value.
Returns
An empty sequence if all properties are successfull set. Otherwise for every property value that could not successfully be set an entry of the SetPropertyTolerantFailed will be present in this sequence. The order of the properties is also alphabetically ascending.
Throws
IllegalArgumentException if the number of property names and values do not match.
getPropertyValuesTolerant
sequence< GetPropertyTolerantResult >
getPropertyValuesTolerant( [in] sequence< string >  aPropertyNames );

Description
retrieve the values of the specified properties

The count and order of the values in the returned sequence will be the same as the order of the names in the argument.

Parameter aPropertyNames
specifies the names of the properties. The property names must be sorted ascending.

If the names are not sorted the behaviour of the method is undefined!

Returns
a sequence of type GetPropertyTolerantResult for each of the properties listed in aPropertyNames.
getDirectPropertyValuesTolerant
sequence< GetDirectPropertyTolerantResult >
getDirectPropertyValuesTolerant( [in] sequence< string >  aPropertyNames );

Description
retrieve only those values of the specified properties which are direct values.

Since the count of returned elements may be different from the number of supplied property names the returned elements will also state the name of the property.

Parameter aPropertyNames
specifies the names of the properties. The property names must be sorted ascending.

If the names are not sorted the behaviour of the method is undefined!

Returns
a sequence of type GetDirectPropertyTolerantResult but only for those properties supplied whoms state is DIRECT_VALUE.
Top of Page