Language

The Free and Open Productivity Suite
Released: Apache OpenOffice 4.1.15

API

SDK

Tips ‘n’ Tricks

Miscellaneous


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

unpublished interface XFastPropertyState
Usage Restrictions
not published
Description
makes it possible to query information about the state of one or more properties.

The state contains the information if:

  • a value is available or void
  • the value is stored in the object itself, or if a default value is to be used
  • and if the value cannot be determined, due to ambiguity (multi selection with multiple values).

Methods' Summary
getFastPropertyState  
getFastPropertyStates  
setFastPropertyToDefault Sets the property to default value.  
getFastPropertyDefault  
Methods' Details
getFastPropertyState
PropertyState
getFastPropertyState( [in] long  nHandle )
raises( UnknownPropertyException );

Returns
the state of the property.
Parameter aPropertyName
specifies the name of the property.
Throws
UnknownPropertyException if the property does not exist.
getFastPropertyStates
sequence< PropertyState >
getFastPropertyStates( [in] sequence< long >  aHandles )
raises( UnknownPropertyException );

Returns
a sequence of the states of the properties which are specified by their names.

The order of the states is correlating to the order of the given property names.

Parameter aPropertyNames
contains the sequence of property names.
Throws
UnknownPropertyException if one property does not exist.
setFastPropertyToDefault
void
setFastPropertyToDefault( [in] long  nHandle )
raises( UnknownPropertyException );

Description
Sets the property to default value.

The value depends on the implementation of this interface. If it is a bound property, you must change the value before the change events are fired. If it is a constrained property, you must fire the vetoable event before you change the property value.

Parameter aPropertyname
specifies the name of the property.
Throws
UnknownPropertyException if the property does not exist.
getFastPropertyDefault
any
getFastPropertyDefault( [in] long  nHandle )
raises( UnknownPropertyException,
::com::sun::star::lang::WrappedTargetException );

Returns
the default value of the property with the name PropertyName.

If no default exists, is not known or is void, then the return type is ::void.

Parameter aPropertyName
specifies the name of the property.
Throws
UnknownPropertyException if the property does not exist.
Throws
::com::sun::star::lang::WrappedTargetException if the implementation has an internal reason for the exception. In this case the original exception is wrapped into that ::com::sun::star::lang::WrappedTargetException.
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.