Language

The Free and Open Productivity Suite
Released: Apache OpenOffice 4.1.15

API

SDK

Tips ‘n’ Tricks

Miscellaneous


:: 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 - Summary
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::FormControlModels 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.  
Included Services - Details
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::FormControlModels which are data aware and thus can be bound to a data 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

Apache Software Foundation

Copyright & License | Privacy | Contact Us | Donate | Thanks

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