(incubating) | The Free and Open Productivity Suite
Announcing Apache OpenOffice 3.4

Developer's Guide

API

SDK

Tips 'n' Tricks

Miscellaneous

Content for OpenOffice.org version 3.3.

:: com :: sun :: star :: form :: binding ::

unpublished service BindableDatabaseRadioButton
Usage Restrictions
not published
Description
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

See also
XValueBinding::supportsType, ::com::sun::star::awt::UnoControlRadioButtonModel::State, ::com::sun::star::form::component::RadioButton::RefValue

Included Services - Summary
::com::sun::star::form::component::DatabaseRadioButton
(referenced entity's summary:)
This service specifies a radio button which is data-aware, and can be bound to a database field.
BindableDataAwareControlModel

specifies the interaction between an internal binding to a database column, and an external value binding.

Properties' Summary
string
SecondaryRefValue
specifies a value which is to be associated with the control when it's not selected.  
Included Services - Details
::com::sun::star::form::component::DatabaseRadioButton
(referenced entity's summary:)
This service specifies a radio button which is data-aware, and can be bound to a database field.
BindableDataAwareControlModel
Description
specifies the interaction between an internal binding to a database column, and an external value binding.

Properties' Details
SecondaryRefValue
string SecondaryRefValue;
Description
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.


 
Top of Page

Apache Feather

Copyright & License | Privacy | Contact Us

Apache and the Apache feather logos are trademarks of The Apache Software Foundation. OpenOffice.org and the seagull logo are registered trademarks of The Apache Software Foundation. Other names appearing on the site may be trademarks of their respective owners.

Apache OpenOffice is an effort undergoing incubation at The Apache Software Foundation (ASF), sponsored by the Apache Incubator. Incubation is required of all newly accepted projects until a further review indicates that the infrastructure, communications, and decision making process have stabilized in a manner consistent with other successful ASF projects. While incubation status is not necessarily a reflection of the completeness or stability of the code, it does indicate that the project has yet to be fully endorsed by the ASF.