:: drafts :: com :: sun :: star :: form ::

service ValueBinding
Description
defines a component which allows access to a single value

Read/Write access to the value represented by this component is supported, as well as (optionally) active broadcasting of value changes


Exported Interfaces
::com::sun::star::beans::XPropertySet
Description
allows access to the properties of the binding
XValueBinding
Description
allows read and write access to the value represented by this binding
::com::sun::star::util::XModifyBroadcaster
[ OPTIONAL ]
Description
allows other components to be notified when the value represented by the ValueBinding instance changes.

This interface is optional, since a binding may not support actively notifying changes in it's value. Note, however, that in case this interface is not supported, the bound component cannot react on value changes, and will thus override any values which are set by an instance other than itself.

::com::sun::star::lang::XComponent
Description
allows life time control for the component

An ValueBinding may be known to one ore more components supporting the XBindableValue interface, which all work with this binding. However, they will not own the ValueBinding . The ownership is with another instance, which may also decide to obsolete the ValueBinding for whatever reasons (e.g. because the data model which the binding reflected died). For this reason, a ValueBinding must offer a possibility to be obsoleted by it's owner, and to notify this obsoletion to other interested parties, such as XBindableValue s.

Properties' Summary
ReadOnly determines whether the value is currently readonly
Properties' Details
ReadOnly
[ readonly bound ] boolean ReadOnly;
Description
determines whether the value is currently readonly

For instance, you could imagine a ValueBinding which represents a cell in a spreadsheet document, and whose value is readonly as long as the spreadsheet is locked.


 
Top of Page