This service specifies a radio button 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 BindableDatabaseRadioButton must support exchanging
boolean values. The following mapping between external values and control states apply:
true will be mapped to the button 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 value binding associated with a BindableDatabaseRadioButton
supports exchanging string values, and the ::com::sun::star::form::component::RadioButton::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
selected.
::com::sun::star::form::component::RadioButton::RefValue is transferred to
possible external value bindings as soon as the radio button is selected. With the member
SecondaryRefValue, clients of the radio button can also associate a value with
the not selected state of the control.