This service specifies a check box which is data-aware and thus can be bound to a
database field, and additionally supports binding to arbitrary external values.
The XValueBinding instance which
can be associated with a BindableDatabaseCheckBox must support exchanging
boolean values. The following mapping between external values and control states apply:
true will be mapped to the box being checked, and vice versa
false will be mapped to it being unchecked, and vice versa
NULL will be mapped to it being in indetermined state, if the box currently supports
this, or being unchecked else. The indetermined of the check box will always be
mapped to NULL when writing the external value.
If the value binding associated with a BindableDatabaseCheckBox
supports exchanging string values, and the ::com::sun::star::form::component::CheckBox::RefValue
is not empty, then the radio button will exchange it's value as string:
A string equal to the reference value will be mapped to the button being checked, and vice versa
A string not equal to the reference value will be mapped to the button being unchecked, and vice versa
NULL will be mapped to it being in indetermined state
specifies a value which is to be associated with the control when it's not
checked.
::com::sun::star::form::component::CheckBox::RefValue is transferred to
possible external value bindings as soon as the check box is checked. With the member
SecondaryRefValue, clients of the check box can also associate a value with
the not checked state of the control.
