:: com :: sun :: star :: form :: component ::

service DatabaseComboBox
Description
This service specifies a combo box which is data-aware, and can be bound to a database field.

Like most other data aware controls, such a combo box will display the actual content of the field it is bound to. In addition, as a combo box contains a list where the user can choose items to fill into the control, this list can be filled with different data from a database, too.


Included Services
ComboBox
(referenced entity's summary:)
specifies a component which allows the input of text or selection of text from a list of text values.
::com::sun::star::form::DataAwareControlModel
(referenced entity's summary:)
is an abstract service for specialized ::com::sun::star::form::FormControlModel s which are data aware and thus can be bound to a data source.
Properties' Summary
boolean
ConvertEmptyToNull
determines if an empty text should be treated as a NULL value.  
string
ListSource
describes the source of items in the combo box' list.  
::com::sun::star::form::ListSourceType
ListSourceType
specifies the kind of list source.  
Properties' Details
ConvertEmptyToNull
boolean ConvertEmptyToNull;
Description
determines if an empty text should be treated as a NULL value.

When the user enters text into a combo box, and after this, the control content is to be committed into the database field the control is bound to, a decision must be made how to deal with empty strings.
This is controlled by ConvertEmptyToNull .

If the property is set to true , and an empty text is to be commited, this is converted into NULL , else it is written as empty string.

ListSource
string ListSource;
Description
describes the source of items in the combo box' list.

The concrete meaning of this property depends on the value of ListSourceType

ListSourceType
::com::sun::star::form::ListSourceType ListSourceType;
Description
specifies the kind of list source.

Note: A value of ::com::sun::star::form::ListSourceType::VALUELIST is not valid for a combo box. It won't be rejected when setting it, but controls will usually ignore it and leave the list empty.


 
Top of Page