Combo Box/List Box Wizard

From LibreOffice Help
Jump to: navigation, search

If you insert a combo box or a list box in a document, a wizard starts automatically. This wizard allows you to interactively specify which information is shown.

Open Form Controls toolbar, click Combo Box or List Box icon and drag mouse to generate field. Database connection must exist in the form.

Note.png You can use the Wizards On/Off icon to keep the wizard from starting automatically.

The wizards for combo boxes and list boxes differ from each other in their final step. This is because the nature of control fields:

List Boxes

In the case of a list box, the user selects one entry from a list of entries. These entries are saved in a database table and cannot be modified through the list box.

As a general rule, the database table that contains the visible list entries in the form is not the table on which the form is based. The list boxes in a form work by using references; that is, references to the visible list entries are located in the form table (values table) and are also entered as such in the values table if the user selects an entry from the list and saves it. Through reference values, list boxes can display data from a table linked to the current form table. Thus the List Box Wizard allows two tables of a database to be linked, so that the control field can display a detailed list of a database field that is located in a different table from the one to which the form refers.

In the other tables the required field is searched for by using the field names (ControlSource) and then the fields will be completed accordingly. If the field name is not found, the list will remain empty. When list fields contain linked columns, the first column of the other table will be used without a query being shown first.

If an article table contains, for example, the number of a supplier, the list box can use the "Supplier number" link to display the name of the supplier from the supplier table. On the Field links page the Wizard will ask you about all the settings required for this link.

Combo Boxes

In the case of combo boxes, users can select one entry from the list entries or enter text themselves. The entries, which are offered as a list from which users can select, may originate from any database table. The entries that users select or enter so that they can be saved can be saved either in the form only, or in a database. If they are saved in a database, they will be written to the database table on which the form is based.

Combo boxes can display the data of any table. A direct link between the current form table and the table whose values are to be displayed in the combo box (list table) is not required. Combo boxes do not work with references. If the user enters or selects a value and saves it, the value actually displayed will be entered in the form table. As there is no link between the form table and the list table, the Field Link table does not appear here.

In the case of a list box, you select entries from the list, and these are saved in the list table. In the case of a combo box, you can add additional text that can be written to the current database table of the form (values table) and stored there as desired. For this function, the Combo Box Wizard has the Data Processing page as the last page, whereas in the case of list boxes this page does not exist. Here you can enter whether and where text that has been entered is to be saved in the values table.

Table Element / List Box / Combo Box Wizard: Data

Select the data source and table to which the form field corresponds. If you insert the form field in a document that is already linked to a data source, this page becomes invisible.

Combo Box / List Box Wizard: Table Selection

Specifies a table from the available database tables that contains the data field whose content should be displayed as a list entry.

Combo/List Box Wizard: Field Selection

Select the data field specified in the table on the previous page, whose contents should be displayed in the list or combo box.

List Box Wizard: Field Link

Indicates through which fields tables of values and list tables are linked.

Combo Box Wizard: Database Field

With the combination fields, you can either save the value of a field in a database or display this value in a form.

Cancel

Clicking Cancel closes a dialog without saving any changes made.

Back

View the selections in the dialog made in the previous step. The current settings remain unchanged. This button can only be activated from page two on.

Next

Click the Next button, and the wizard uses the current dialog settings and proceeds to the next step. If you are on the last step, this button becomes Create.