merge the formfield patch from ooo-build
[ooovba.git] / helpcontent2 / source / text / swriter / guide / fields.xhp
bloba1bcdfbadc3d485230f6e728dba4b031efba162c
1 <?xml version="1.0" encoding="UTF-8"?>
2 <helpdocument version="1.0">
4 <!--
5 ***********************************************************************
7 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
8 *
9 * Copyright 2008 by Sun Microsystems, Inc.
11 * OpenOffice.org - a multi-platform office productivity suite
13 * $RCSfile: soffice2xmlhelp.xsl,v $
14 * $Revision: 1.10 $
16 * This file is part of OpenOffice.org.
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.
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).
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.
33 ************************************************************************
34 -->
37 <meta>
38 <topic id="textswriterguidefieldsxml" indexer="include" status="PUBLISH">
39 <title xml-lang="en-US" id="tit">About Fields</title>
40 <filename>/text/swriter/guide/fields.xhp</filename>
41 </topic>
42 </meta>
43 <body>
44 <bookmark xml-lang="en-US" branch="index" id="bm_id3145576"><bookmark_value>fields;updating/viewing</bookmark_value>
45 <bookmark_value>updating;fields</bookmark_value>
46 <bookmark_value>Help tips;fields</bookmark_value>
47 <bookmark_value>properties;fields</bookmark_value>
48 <bookmark_value>disabling;field highlighting</bookmark_value>
49 <bookmark_value>changing;field shadings</bookmark_value>
50 <bookmark_value>viewing;fields</bookmark_value>
51 </bookmark><comment>mw changed "fields;..."</comment>
52 <paragraph xml-lang="en-US" id="hd_id3145576" role="heading" level="1" l10n="U" oldref="3"><variable id="fields"><link href="text/swriter/guide/fields.xhp" name="About Fields">About Fields</link>
53 </variable></paragraph>
54 <paragraph xml-lang="en-US" id="par_id3154246" role="paragraph" l10n="U" oldref="4">Fields are used for data that changes in a document, such as the current date or the total number of pages in a document.</paragraph>
55 <paragraph xml-lang="en-US" id="hd_id3154262" role="heading" level="2" l10n="U" oldref="5">Viewing Fields</paragraph>
56 <paragraph xml-lang="en-US" id="par_id3150509" role="paragraph" l10n="U" oldref="6">Fields consist of a field name and the field content. To switch the field display between the field name or the field content, choose <link href="text/swriter/01/03090000.xhp" name="View - Fields"><emph>View - Field Names</emph></link>.</paragraph>
57 <paragraph xml-lang="en-US" id="par_id3150536" role="paragraph" l10n="U" oldref="195">To display or hide field highlighting in a document, choose <emph>View - Field Shadings</emph>. To permanently disable this feature, choose <emph>Tools - Options - $[officename] - Appearance</emph>, and clear the check box in front of <emph>Field shadings</emph>.</paragraph>
58 <paragraph xml-lang="en-US" id="par_id3152885" role="paragraph" l10n="U" oldref="7">To change the color of field shadings, choose <link href="text/shared/optionen/01012000.xhp" name="Tools - Options - $[officename] - Appearance"><item type="menuitem">Tools - Options - $[officename] - Appearance</item></link>, locate the <item type="menuitem">Field shadings</item> option, and then select a different color in the <item type="menuitem">Color setting</item>
59 <emph/>box.</paragraph>
60 <paragraph xml-lang="en-US" id="hd_id3153166" role="heading" level="2" l10n="U" oldref="8">Field Properties</paragraph>
61 <paragraph xml-lang="en-US" id="par_id3153180" role="paragraph" l10n="U" oldref="181">Most field types in a document, including database fields, store and display variable values.</paragraph>
62 <paragraph xml-lang="en-US" id="par_id3155533" role="paragraph" l10n="U" oldref="182">The following field types execute an action when you click the field:</paragraph>
63 <table id="tbl_id3155548">
64 <tablerow>
65 <tablecell>
66 <paragraph xml-lang="en-US" id="par_id3155582" role="tablehead" l10n="U" oldref="183">Field Type</paragraph>
67 </tablecell>
68 <tablecell>
69 <paragraph xml-lang="en-US" id="par_id3147760" role="tablehead" l10n="U" oldref="184">Property</paragraph>
70 </tablecell>
71 </tablerow>
72 <tablerow>
73 <tablecell>
74 <paragraph xml-lang="en-US" id="par_id3147789" role="tablecontent" l10n="U" oldref="185">Placeholder</paragraph>
75 </tablecell>
76 <tablecell>
77 <paragraph xml-lang="en-US" id="par_id3147812" role="tablecontent" l10n="U" oldref="186">Opens a dialog to insert the object for which the placeholder was set.</paragraph>
78 </tablecell>
79 </tablerow>
80 <tablerow>
81 <tablecell>
82 <paragraph xml-lang="en-US" id="par_id3147216" role="tablecontent" l10n="U" oldref="187">Insert Reference</paragraph>
83 </tablecell>
84 <tablecell>
85 <paragraph xml-lang="en-US" id="par_id3147239" role="tablecontent" l10n="U" oldref="188">Moves the mouse pointer to the reference.</paragraph>
86 </tablecell>
87 </tablerow>
88 <tablerow>
89 <tablecell>
90 <paragraph xml-lang="en-US" id="par_id3147267" role="tablecontent" l10n="U" oldref="189">Run macro</paragraph>
91 </tablecell>
92 <tablecell>
93 <paragraph xml-lang="en-US" id="par_id3147290" role="tablecontent" l10n="U" oldref="190">Runs a macro.</paragraph>
94 </tablecell>
95 </tablerow>
96 <tablerow>
97 <tablecell>
98 <paragraph xml-lang="en-US" id="par_id3145614" role="tablecontent" l10n="U" oldref="191">Input Field</paragraph>
99 </tablecell>
100 <tablecell>
101 <paragraph xml-lang="en-US" id="par_id3145637" role="tablecontent" l10n="U" oldref="192">Opens a dialog to edit the contents of the field.</paragraph>
102 </tablecell>
103 </tablerow>
104 </table>
106 <paragraph xml-lang="en-US" id="par_id3151244" role="note" l10n="U" oldref="10">Placeholder, hidden text, insert reference, variable, database, and user-defined fields display a help tip when you rest the mouse pointer over the field in a document. To enable this feature, ensure that the Extended Tips<emph/>option (<item type="menuitem">What's This?</item>) is selected in the <item type="menuitem">Help</item> menu.</paragraph>
107 <paragraph xml-lang="en-US" id="hd_id3155937" role="heading" level="2" l10n="U"
108 oldref="11">Updating Fields</paragraph>
109 <paragraph xml-lang="en-US" id="par_id3155963" role="paragraph" l10n="U" oldref="12">To update all of the fields in a document, press F9, or choose <emph>Edit - Select All</emph>, and then press F9.</paragraph>
110 <paragraph xml-lang="en-US" id="par_id3155984" role="paragraph" l10n="U" oldref="13">To update a field that was inserted from a database, select the field, and then press F9.</paragraph>
111 <embed href="text/shared/00/00000004.xhp#related"/>
112 <embed href="text/swriter/guide/fields_userdata.xhp#fields_userdata"/>
113 <embed href="text/swriter/guide/fields_enter.xhp#fields_enter"/>
114 <embed href="text/swriter/guide/fields_date.xhp#fields_date"/>
115 <embed href="text/swriter/guide/conditional_text.xhp#conditional_text"/>
116 <embed href="text/swriter/guide/conditional_text2.xhp#conditional_text2"/>
117 <embed href="text/swriter/guide/pagenumbers.xhp#pagenumbers"/>
118 </body>
119 </helpdocument>