1<?xml version="1.0" encoding="UTF-8"?>
2<helpdocument version="1.0">
3
4<!--***********************************************************
5 *
6 * Licensed to the Apache Software Foundation (ASF) under one
7 * or more contributor license agreements.  See the NOTICE file
8 * distributed with this work for additional information
9 * regarding copyright ownership.  The ASF licenses this file
10 * to you under the Apache License, Version 2.0 (the
11 * "License"); you may not use this file except in compliance
12 * with the License.  You may obtain a copy of the License at
13 *
14 *   http://www.apache.org/licenses/LICENSE-2.0
15 *
16 * Unless required by applicable law or agreed to in writing,
17 * software distributed under the License is distributed on an
18 * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
19 * KIND, either express or implied.  See the License for the
20 * specific language governing permissions and limitations
21 * under the License.
22 *
23 ***********************************************************-->
24
25
26
27
28<meta>
29      <topic id="textswriterguidefieldsxml" indexer="include" status="PUBLISH">
30         <title xml-lang="en-US" id="tit">About Fields</title>
31         <filename>/text/swriter/guide/fields.xhp</filename>
32      </topic>
33   </meta>
34   <body>
35<bookmark xml-lang="en-US" branch="index" id="bm_id3145576"><bookmark_value>fields;updating/viewing</bookmark_value>
36      <bookmark_value>updating;fields</bookmark_value>
37      <bookmark_value>Help tips;fields</bookmark_value>
38      <bookmark_value>properties;fields</bookmark_value>
39      <bookmark_value>disabling;field highlighting</bookmark_value>
40      <bookmark_value>changing;field shadings</bookmark_value>
41      <bookmark_value>viewing;fields</bookmark_value>
42</bookmark><comment>mw changed "fields;..."</comment>
43<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>
44</variable></paragraph>
45      <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>
46      <paragraph xml-lang="en-US" id="hd_id3154262" role="heading" level="2" l10n="U" oldref="5">Viewing Fields</paragraph>
47      <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>
48      <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><switchinline select="sys"><caseinline select="MAC">%PRODUCTNAME - Preferences</caseinline><defaultinline>Tools - Options</defaultinline></switchinline> - $[officename] - Appearance</emph>, and clear the check box in front of <emph>Field shadings</emph>.</paragraph>
49      <paragraph xml-lang="en-US" id="par_id3152885" role="paragraph" l10n="U" oldref="7">To change the color of field shadings, choose <emph><switchinline select="sys"><caseinline select="MAC">%PRODUCTNAME - Preferences</caseinline><defaultinline>Tools - Options</defaultinline></switchinline> - <link href="text/shared/optionen/01012000.xhp" name="$[officename] - Appearance"><item type="menuitem">$[officename] - Appearance</item></link></emph>, locate the <item type="menuitem">Field shadings</item> option, and then select a different color in the <item type="menuitem">Color setting</item> box.</paragraph>
50      <paragraph xml-lang="en-US" id="hd_id3153166" role="heading" level="2" l10n="U" oldref="8">Field Properties</paragraph>
51      <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>
52      <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>
53      <table id="tbl_id3155548">
54         <tablerow>
55            <tablecell>
56               <paragraph xml-lang="en-US" id="par_id3155582" role="tablehead" l10n="U" oldref="183">Field Type</paragraph>
57            </tablecell>
58            <tablecell>
59               <paragraph xml-lang="en-US" id="par_id3147760" role="tablehead" l10n="U" oldref="184">Property</paragraph>
60            </tablecell>
61         </tablerow>
62         <tablerow>
63            <tablecell>
64               <paragraph xml-lang="en-US" id="par_id3147789" role="tablecontent" l10n="U" oldref="185">Placeholder</paragraph>
65            </tablecell>
66            <tablecell>
67               <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>
68            </tablecell>
69         </tablerow>
70         <tablerow>
71            <tablecell>
72               <paragraph xml-lang="en-US" id="par_id3147216" role="tablecontent" l10n="U" oldref="187">Insert Reference</paragraph>
73            </tablecell>
74            <tablecell>
75               <paragraph xml-lang="en-US" id="par_id3147239" role="tablecontent" l10n="U" oldref="188">Moves the mouse pointer to the reference.</paragraph>
76            </tablecell>
77         </tablerow>
78         <tablerow>
79            <tablecell>
80               <paragraph xml-lang="en-US" id="par_id3147267" role="tablecontent" l10n="U" oldref="189">Run macro</paragraph>
81            </tablecell>
82            <tablecell>
83               <paragraph xml-lang="en-US" id="par_id3147290" role="tablecontent" l10n="U" oldref="190">Runs a macro.</paragraph>
84            </tablecell>
85         </tablerow>
86         <tablerow>
87            <tablecell>
88               <paragraph xml-lang="en-US" id="par_id3145614" role="tablecontent" l10n="U" oldref="191">Input Field</paragraph>
89            </tablecell>
90            <tablecell>
91               <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>
92            </tablecell>
93         </tablerow>
94      </table>
95
96      <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 option (<item type="menuitem">What's This?</item>) is selected in the <item type="menuitem">Help</item> menu.</paragraph>
97      <paragraph xml-lang="en-US" id="hd_id3155937" role="heading" level="2" l10n="U"
98                 oldref="11">Updating Fields</paragraph>
99      <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>
100      <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>
101      <embed href="text/shared/00/00000004.xhp#related"/>
102      <embed href="text/swriter/guide/fields_userdata.xhp#fields_userdata"/>
103      <embed href="text/swriter/guide/fields_enter.xhp#fields_enter"/>
104      <embed href="text/swriter/guide/fields_date.xhp#fields_date"/>
105      <embed href="text/swriter/guide/conditional_text.xhp#conditional_text"/>
106      <embed href="text/swriter/guide/conditional_text2.xhp#conditional_text2"/>
107      <embed href="text/swriter/guide/pagenumbers.xhp#pagenumbers"/>
108   </body>
109</helpdocument>