| blob | 7affd3f45b30915e5e938e2884dd7562c6889aff |
4 <!--
5 ***********************************************************************
6 *
7 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
8 *
9 * Copyright 2008 by Sun Microsystems, Inc.
10 *
11 * OpenOffice.org - a multi-platform office productivity suite
12 *
13 * $RCSfile: 01170900.xhp,v $
14 * $Revision: 1.9.4.1 $
15 *
16 * This file is part of OpenOffice.org.
17 *
18 * OpenOffice.org is free software: you can redistribute it and/or modify
19 * it under the terms of the GNU Lesser General Public License version 3
20 * only, as published by the Free Software Foundation.
21 *
22 * OpenOffice.org is distributed in the hope that it will be useful,
23 * but WITHOUT ANY WARRANTY; without even the implied warranty of
24 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
25 * GNU Lesser General Public License version 3 for more details
26 * (a copy is included in the LICENSE file that accompanied this code).
27 *
28 * You should have received a copy of the GNU Lesser General Public License
29 * version 3 along with OpenOffice.org. If not, see
30 * <http://www.openoffice.org/license.html>
31 * for a copy of the LGPLv3 License.
32 *
33 ************************************************************************
34 -->
37 <meta>
41 </topic>
42 </meta>
43 <body>
44 <bookmark xml-lang="en-US" branch="index" id="bm_id3159233"><bookmark_value>forms; Combo Box/List Box Wizard</bookmark_value>
45 </bookmark>
46 <paragraph role="heading" id="hd_id3154094" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/shared/02/01170900.xhp" name="Combo Box/List Box Wizard">Combo Box/List Box Wizard</link></paragraph>
47 <paragraph role="paragraph" id="par_id3152363" xml-lang="en-US" l10n="U" oldref="2">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.</paragraph>
50 </section>
51 <paragraph role="note" id="par_id3145211" xml-lang="en-US" l10n="CHG" oldref="21">You can use the <link href="text/shared/02/01171100.xhp" name="Wizards On/Off"><emph>Wizards On/Off</emph></link> icon to keep the wizard from starting automatically.</paragraph>
52 <paragraph role="paragraph" id="par_id3155391" xml-lang="en-US" l10n="U" oldref="22">The wizards for combo boxes and list boxes differ from each other in their final step. This is because the nature of control fields:</paragraph>
55 </paragraph>
56 <paragraph role="paragraph" id="par_id3166410" xml-lang="en-US" l10n="U" oldref="24">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.</paragraph>
57 <paragraph role="paragraph" id="par_id3166460" xml-lang="en-US" l10n="U" oldref="25">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 <emph>List Box Wizard</emph> 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.</paragraph>
58 <paragraph role="paragraph" id="par_id3145673" xml-lang="en-US" l10n="U" oldref="31">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.</paragraph>
59 <paragraph role="paragraph" id="par_id3154860" xml-lang="en-US" l10n="U" oldref="26">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 <emph>Field links</emph> page the Wizard will ask you about all the settings required for this link.</paragraph>
62 </paragraph>
63 <paragraph role="paragraph" id="par_id3158430" xml-lang="en-US" l10n="U" oldref="28">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.</paragraph>
64 <paragraph role="paragraph" id="par_id3154046" xml-lang="en-US" l10n="U" oldref="29">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 <emph>Field Link</emph> table does not appear here.</paragraph>
65 <paragraph role="paragraph" id="par_id3146949" xml-lang="en-US" l10n="U" oldref="30">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 <emph>Combo Box Wizard</emph> has the <emph>Data Processing</emph> 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.</paragraph>
74 </body>
75 </helpdocument>