1*cdf0e10cSrcweir<?xml version="1.0" encoding="UTF-8"?> 2*cdf0e10cSrcweir<helpdocument version="1.0"> 3*cdf0e10cSrcweir 4*cdf0e10cSrcweir<!-- 5*cdf0e10cSrcweir*********************************************************************** 6*cdf0e10cSrcweir * 7*cdf0e10cSrcweir * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. 8*cdf0e10cSrcweir * 9*cdf0e10cSrcweir * Copyright 2000, 2010 Oracle and/or its affiliates. 10*cdf0e10cSrcweir * 11*cdf0e10cSrcweir * OpenOffice.org - a multi-platform office productivity suite 12*cdf0e10cSrcweir * 13*cdf0e10cSrcweir * This file is part of OpenOffice.org. 14*cdf0e10cSrcweir * 15*cdf0e10cSrcweir * OpenOffice.org is free software: you can redistribute it and/or modify 16*cdf0e10cSrcweir * it under the terms of the GNU Lesser General Public License version 3 17*cdf0e10cSrcweir * only, as published by the Free Software Foundation. 18*cdf0e10cSrcweir * 19*cdf0e10cSrcweir * OpenOffice.org is distributed in the hope that it will be useful, 20*cdf0e10cSrcweir * but WITHOUT ANY WARRANTY; without even the implied warranty of 21*cdf0e10cSrcweir * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 22*cdf0e10cSrcweir * GNU Lesser General Public License version 3 for more details 23*cdf0e10cSrcweir * (a copy is included in the LICENSE file that accompanied this code). 24*cdf0e10cSrcweir * 25*cdf0e10cSrcweir * You should have received a copy of the GNU Lesser General Public License 26*cdf0e10cSrcweir * version 3 along with OpenOffice.org. If not, see 27*cdf0e10cSrcweir * <http://www.openoffice.org/license.html> 28*cdf0e10cSrcweir * for a copy of the LGPLv3 License. 29*cdf0e10cSrcweir * 30*cdf0e10cSrcweir ************************************************************************ 31*cdf0e10cSrcweir --> 32*cdf0e10cSrcweir 33*cdf0e10cSrcweir 34*cdf0e10cSrcweir<meta> 35*cdf0e10cSrcweir<topic id="textswriter0104090005xml" indexer="include"> 36*cdf0e10cSrcweir<title id="tit" xml-lang="en-US">Variables</title> 37*cdf0e10cSrcweir<filename>/text/swriter/01/04090005.xhp</filename> 38*cdf0e10cSrcweir</topic> 39*cdf0e10cSrcweir</meta> 40*cdf0e10cSrcweir<body> 41*cdf0e10cSrcweir<section id="variablen"> 42*cdf0e10cSrcweir<bookmark xml-lang="en-US" branch="index" id="bm_id8526261"><bookmark_value>user-defined fields, restriction</bookmark_value> 43*cdf0e10cSrcweir</bookmark> 44*cdf0e10cSrcweir<bookmark xml-lang="en-US" branch="hid/SW_HID_FLD_VAR" id="bm_id3151266" localize="false"/> 45*cdf0e10cSrcweir<paragraph role="heading" id="hd_id3153716" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/swriter/01/04090005.xhp" name="Variables">Variables</link></paragraph> 46*cdf0e10cSrcweir<paragraph role="paragraph" id="par_id3150764" xml-lang="en-US" l10n="U" oldref="2">Variable fields let you add dynamic content to your document. For example, you can use a variable to reset the page numbering.</paragraph> 47*cdf0e10cSrcweir</section> 48*cdf0e10cSrcweir<section id="howtoget"> 49*cdf0e10cSrcweir<embed href="text/swriter/00/00000404.xhp#feldvariablen"/> 50*cdf0e10cSrcweir</section> 51*cdf0e10cSrcweir<paragraph role="warning" id="par_id3149759" xml-lang="en-US" l10n="U" oldref="3">User-defined fields are only available in the current document.</paragraph> 52*cdf0e10cSrcweir<bookmark xml-lang="en-US" branch="hid/sw:ListBox:TP_FLD_VAR:LB_VARTYPE" id="bm_id3154692" localize="false"/> 53*cdf0e10cSrcweir<paragraph role="paragraph" id="par_id0903200802243625" xml-lang="en-US" l10n="NEW"><ahelp hid="." visibility="hidden">Lists the available field types. To add a field to your document, click a field type, click a field in the <emph>Select </emph>list, and then click <emph>Insert</emph>.</ahelp></paragraph> 54*cdf0e10cSrcweir<embed href="text/swriter/01/04090001.xhp#feldtyp"/> 55*cdf0e10cSrcweir<table id="tbl_id3145416"> 56*cdf0e10cSrcweir<tablerow> 57*cdf0e10cSrcweir<tablecell> 58*cdf0e10cSrcweir<paragraph role="tablehead" id="par_id3150703" xml-lang="en-US" l10n="U" oldref="4">Type</paragraph> 59*cdf0e10cSrcweir</tablecell> 60*cdf0e10cSrcweir<tablecell> 61*cdf0e10cSrcweir<paragraph role="tablehead" id="par_id3154096" xml-lang="en-US" l10n="U" oldref="5">Description</paragraph> 62*cdf0e10cSrcweir</tablecell> 63*cdf0e10cSrcweir</tablerow> 64*cdf0e10cSrcweir<tablerow> 65*cdf0e10cSrcweir<tablecell> 66*cdf0e10cSrcweir<paragraph role="tablecontent" id="par_id3149803" xml-lang="en-US" l10n="U" oldref="6">Set Variable</paragraph> 67*cdf0e10cSrcweir</tablecell> 68*cdf0e10cSrcweir<tablecell> 69*cdf0e10cSrcweir<paragraph role="tablecontent" id="par_id3150996" xml-lang="en-US" l10n="U" oldref="7">Defines a variable and its value. You can change the value of a variable by clicking in front of the variable field, and then choosing <emph>Edit - Field</emph>.</paragraph> 70*cdf0e10cSrcweir</tablecell> 71*cdf0e10cSrcweir</tablerow> 72*cdf0e10cSrcweir<tablerow> 73*cdf0e10cSrcweir<tablecell> 74*cdf0e10cSrcweir<paragraph role="tablecontent" id="par_id3154571" xml-lang="en-US" l10n="U" oldref="8">Show Variable</paragraph> 75*cdf0e10cSrcweir</tablecell> 76*cdf0e10cSrcweir<tablecell> 77*cdf0e10cSrcweir<paragraph role="tablecontent" id="par_id3153669" xml-lang="en-US" l10n="U" oldref="9">Inserts the current value of the variable that you click in the <emph>Selection </emph>list.</paragraph> 78*cdf0e10cSrcweir</tablecell> 79*cdf0e10cSrcweir</tablerow> 80*cdf0e10cSrcweir<tablerow> 81*cdf0e10cSrcweir<tablecell> 82*cdf0e10cSrcweir<paragraph role="tablecontent" id="par_id3147531" xml-lang="en-US" l10n="U" oldref="10">DDE field</paragraph> 83*cdf0e10cSrcweir</tablecell> 84*cdf0e10cSrcweir<tablecell> 85*cdf0e10cSrcweir<paragraph role="tablecontent" id="par_id3149684" xml-lang="en-US" l10n="U" oldref="11">Inserts a <link href="text/shared/00/00000005.xhp#dde" name="DDE">DDE</link> link into the document, that you can update as often as you want through the assigned name.</paragraph> 86*cdf0e10cSrcweir</tablecell> 87*cdf0e10cSrcweir</tablerow> 88*cdf0e10cSrcweir<tablerow> 89*cdf0e10cSrcweir<tablecell> 90*cdf0e10cSrcweir<paragraph role="tablecontent" id="par_id3159196" xml-lang="en-US" l10n="U" oldref="12">Insert Formula</paragraph> 91*cdf0e10cSrcweir</tablecell> 92*cdf0e10cSrcweir<tablecell> 93*cdf0e10cSrcweir<paragraph role="tablecontent" id="par_id3151322" xml-lang="en-US" l10n="U" oldref="13">Inserts a fixed number, or the result of a formula.</paragraph> 94*cdf0e10cSrcweir</tablecell> 95*cdf0e10cSrcweir</tablerow> 96*cdf0e10cSrcweir<tablerow> 97*cdf0e10cSrcweir<tablecell> 98*cdf0e10cSrcweir<paragraph role="tablecontent" id="par_id3149494" xml-lang="en-US" l10n="U" oldref="14">Input field</paragraph> 99*cdf0e10cSrcweir</tablecell> 100*cdf0e10cSrcweir<tablecell> 101*cdf0e10cSrcweir<paragraph role="tablecontent" id="par_id3154829" xml-lang="en-US" l10n="U" oldref="15">Inserts a new value for a variable or a User Field.</paragraph> 102*cdf0e10cSrcweir<paragraph role="tablecontent" id="par_id3149098" xml-lang="en-US" l10n="U" oldref="37">The value of a variable in an Input field is only valid from where the field is inserted and onwards. To change the value of the variable later in the document, insert another Input field of the same name, but with a different value. However, the value of a User Field is changed globally.</paragraph> 103*cdf0e10cSrcweir<paragraph role="tablecontent" id="par_id3151255" xml-lang="en-US" l10n="U" oldref="38">The variables are displayed in the <emph>Selection</emph> field. When you click the <emph>Insert</emph> button, the dialog<link href="text/swriter/01/04090100.xhp" name="Input Field"><emph>Input Field</emph></link> appears, where you can enter the new value or additional text as a remark.</paragraph> 104*cdf0e10cSrcweir</tablecell> 105*cdf0e10cSrcweir</tablerow> 106*cdf0e10cSrcweir<tablerow> 107*cdf0e10cSrcweir<tablecell> 108*cdf0e10cSrcweir<paragraph role="tablecontent" id="par_id3149034" xml-lang="en-US" l10n="U" oldref="16">Number range</paragraph> 109*cdf0e10cSrcweir</tablecell> 110*cdf0e10cSrcweir<tablecell> 111*cdf0e10cSrcweir<paragraph role="tablecontent" id="par_id3152772" xml-lang="en-US" l10n="U" oldref="17">Inserts automatic numbering for tables, graphics, or text frames.</paragraph> 112*cdf0e10cSrcweir</tablecell> 113*cdf0e10cSrcweir</tablerow> 114*cdf0e10cSrcweir<tablerow> 115*cdf0e10cSrcweir<tablecell> 116*cdf0e10cSrcweir<paragraph role="tablecontent" id="par_id3147073" xml-lang="en-US" l10n="U" oldref="18">Set page variable</paragraph> 117*cdf0e10cSrcweir</tablecell> 118*cdf0e10cSrcweir<tablecell> 119*cdf0e10cSrcweir<paragraph role="tablecontent" id="par_id3154389" xml-lang="en-US" l10n="U" oldref="19">Inserts a reference point in the document, after which the page count restarts. Select "on" to enable the reference point, and "off" to disable it. You can also enter an offset to start the page count at a different number.</paragraph> 120*cdf0e10cSrcweir</tablecell> 121*cdf0e10cSrcweir</tablerow> 122*cdf0e10cSrcweir<tablerow> 123*cdf0e10cSrcweir<tablecell> 124*cdf0e10cSrcweir<paragraph role="tablecontent" id="par_id3156267" xml-lang="en-US" l10n="U" oldref="20">Show Page Variable</paragraph> 125*cdf0e10cSrcweir</tablecell> 126*cdf0e10cSrcweir<tablecell> 127*cdf0e10cSrcweir<paragraph role="tablecontent" id="par_id3150588" xml-lang="en-US" l10n="U" oldref="21">Displays the number of pages from the "Set page variable" reference point to this field.</paragraph> 128*cdf0e10cSrcweir</tablecell> 129*cdf0e10cSrcweir</tablerow> 130*cdf0e10cSrcweir<tablerow> 131*cdf0e10cSrcweir<tablecell> 132*cdf0e10cSrcweir<paragraph role="tablecontent" id="par_id3145779" xml-lang="en-US" l10n="U" oldref="22">User Field</paragraph> 133*cdf0e10cSrcweir</tablecell> 134*cdf0e10cSrcweir<tablecell> 135*cdf0e10cSrcweir<paragraph role="tablecontent" id="par_id3151377" xml-lang="en-US" l10n="U" oldref="23">Inserts a custom global variable. You can use the User Field to define a variable for a condition statement. When you change a User Field, all instances of the variable in the document are updated.</paragraph> 136*cdf0e10cSrcweir</tablecell> 137*cdf0e10cSrcweir</tablerow> 138*cdf0e10cSrcweir</table> 139*cdf0e10cSrcweir<embed href="text/swriter/01/04090001.xhp#hinweis"/> 140*cdf0e10cSrcweir<bookmark xml-lang="en-US" branch="hid/sw:ListBox:TP_FLD_VAR:LB_VARNUMFORMAT" id="bm_id3148875" localize="false"/> 141*cdf0e10cSrcweir<paragraph role="paragraph" id="par_id0903200802243892" xml-lang="en-US" l10n="NEW"><ahelp hid="." visibility="hidden">Click the format that you want to apply to the selected field, or click "Additional formats" to define a custom format.</ahelp></paragraph> 142*cdf0e10cSrcweir<embed href="text/swriter/01/04090001.xhp#format"/> 143*cdf0e10cSrcweir<paragraph role="paragraph" id="par_id3148886" xml-lang="en-US" l10n="U" oldref="25">For user-defined fields, click the format that you want to apply in the <emph>Format </emph>list, or click "Additional formats" to define a custom format.</paragraph> 144*cdf0e10cSrcweir<bookmark xml-lang="en-US" branch="hid/sw:Edit:TP_FLD_VAR:ED_VARNAME" id="bm_id3150108" localize="false"/> 145*cdf0e10cSrcweir<paragraph role="paragraph" id="par_id0903200802243880" xml-lang="en-US" l10n="NEW"><ahelp hid="." visibility="hidden">Type the name of the user-defined field that you want to create.</ahelp></paragraph> 146*cdf0e10cSrcweir<embed href="text/swriter/01/04090002.xhp#name"/> 147*cdf0e10cSrcweir<bookmark xml-lang="en-US" branch="hid/sw:Edit:TP_FLD_VAR:ED_VARVALUE" id="bm_id3150119" localize="false"/> 148*cdf0e10cSrcweir<paragraph role="paragraph" id="par_id0903200802243951" xml-lang="en-US" l10n="NEW"><ahelp hid="." visibility="hidden">Enter the contents that you want to add to a user-defined field.</ahelp></paragraph> 149*cdf0e10cSrcweir<embed href="text/swriter/01/04090001.xhp#wert"/> 150*cdf0e10cSrcweir<bookmark xml-lang="en-US" branch="hid/sw:ListBox:TP_FLD_VAR:LB_VARFORMAT" id="bm_id3155871" localize="false"/> 151*cdf0e10cSrcweir<paragraph role="paragraph" id="par_id3155860" xml-lang="en-US" l10n="U" oldref="26"><ahelp hid="SW_LISTBOX_TP_FLD_VAR_LB_VARFORMAT">In the <emph>Format</emph> list, define if the value is inserted as text or a number.</ahelp></paragraph> 152*cdf0e10cSrcweir<bookmark xml-lang="en-US" branch="hid/sw:ListBox:TP_FLD_VAR:LB_VARSELECTION" id="bm_id3150684" localize="false"/> 153*cdf0e10cSrcweir<paragraph role="heading" id="hd_id3888363" xml-lang="en-US" level="2" l10n="NEW">Selection<comment>on "Document" and "DocInformation" tab page this is called "Select", on the other tab pages "Selection"</comment></paragraph> 154*cdf0e10cSrcweir<paragraph role="paragraph" id="par_id7453535" xml-lang="en-US" l10n="NEW"><ahelp hid="SW:LISTBOX:TP_FLD_DOK:LB_DOKSELECTION">Lists the available fields for the field type selected in the <emph>Type </emph>list. To insert a field, click the field, and then click <emph>Insert</emph>.</ahelp></paragraph> 155*cdf0e10cSrcweir<paragraph role="tip" id="par_id3326822" xml-lang="en-US" l10n="NEW">To quickly insert a field from the list, hold down <switchinline select="sys"><caseinline select="MAC">Command 156*cdf0e10cSrcweir</caseinline><defaultinline>Ctrl</defaultinline></switchinline> and double-click the field.</paragraph> 157*cdf0e10cSrcweir<paragraph role="paragraph" id="par_id3150696" xml-lang="en-US" l10n="U" oldref="36">In an HTML document, two additional fields are available for the "Set variable" field type: HTML_ON and HTML_OFF. The text that you type in the <emph>Value </emph>box is converted to an opening HTML <link href="text/shared/00/00000002.xhp#tags" name="tag">tag</link> (<Value>) or to a closing HTML (</Value>) tag when the file is saved as an HTML document, depending on the option that you select.</paragraph> 158*cdf0e10cSrcweir<paragraph role="tip" id="par_id3149555" xml-lang="en-US" l10n="U" oldref="46">If you double-click an entry while holding the Ctrl key or select the desired variable and press the spacebar, it is immediately inserted into your document.</paragraph> 159*cdf0e10cSrcweir<paragraph role="heading" id="hd_id3155969" xml-lang="en-US" level="2" l10n="U" oldref="27">Formula</paragraph> 160*cdf0e10cSrcweir<paragraph role="paragraph" id="par_id3155982" xml-lang="en-US" l10n="U" oldref="28">This option is only available if the "Insert formula" field type is selected.</paragraph> 161*cdf0e10cSrcweir<embed href="text/swriter/01/04090003.xhp#hinweis"/> 162*cdf0e10cSrcweir<embed href="text/swriter/01/04090001.xhp#korrektur"/> 163*cdf0e10cSrcweir<section id="unsichtbar"> 164*cdf0e10cSrcweir<bookmark xml-lang="en-US" branch="hid/sw:CheckBox:TP_FLD_VAR:CB_VARINVISIBLE" id="bm_id3156226" localize="false"/> 165*cdf0e10cSrcweir<paragraph role="heading" id="hd_id3149229" xml-lang="en-US" level="2" l10n="U" oldref="29">Invisible</paragraph> 166*cdf0e10cSrcweir<paragraph role="paragraph" id="par_id3156233" xml-lang="en-US" l10n="U" oldref="30"><ahelp hid="SW_CHECKBOX_TP_FLD_VAR_CB_VARINVISIBLE">Hides the field contents in the document.</ahelp> The field is inserted as a thin gray mark in the document. This option is only available for the "Set Variable" and "User Field" field types.</paragraph> 167*cdf0e10cSrcweir</section> 168*cdf0e10cSrcweir<paragraph role="heading" id="hd_id3146326" xml-lang="en-US" level="2" l10n="U" oldref="39">Chapter numbering</paragraph> 169*cdf0e10cSrcweir<paragraph role="paragraph" id="par_id3146340" xml-lang="en-US" l10n="U" oldref="40">Sets the options for resetting chapter numbers.</paragraph> 170*cdf0e10cSrcweir<bookmark xml-lang="en-US" branch="hid/sw:ListBox:TP_FLD_VAR:LB_VARCHAPTERLEVEL" id="bm_id3149829" localize="false"/> 171*cdf0e10cSrcweir<paragraph role="heading" id="hd_id3147456" xml-lang="en-US" level="3" l10n="U" oldref="41">Level</paragraph> 172*cdf0e10cSrcweir<paragraph role="paragraph" id="par_id3149836" xml-lang="en-US" l10n="U" oldref="42"><ahelp hid="SW_LISTBOX_TP_FLD_VAR_LB_VARCHAPTERLEVEL">Choose the heading or chapter level at which to restart numbering in the document.</ahelp></paragraph> 173*cdf0e10cSrcweir<bookmark xml-lang="en-US" branch="hid/sw:Edit:TP_FLD_VAR:ED_VARSEPARATOR" id="bm_id3147605" localize="false"/> 174*cdf0e10cSrcweir<paragraph role="heading" id="hd_id3147594" xml-lang="en-US" level="3" l10n="U" oldref="43">Separator</paragraph> 175*cdf0e10cSrcweir<paragraph role="paragraph" id="par_id3148846" xml-lang="en-US" l10n="U" oldref="44"><ahelp hid="SW_EDIT_TP_FLD_VAR_ED_VARSEPARATOR">Type the character that you want to use as a separator between the heading or chapter levels.</ahelp></paragraph> 176*cdf0e10cSrcweir<section id="uebernehmen"> 177*cdf0e10cSrcweir<bookmark xml-lang="en-US" branch="hid/SW_HID_FLDVAR_APPLY" id="bm_id3147069" localize="false"/> 178*cdf0e10cSrcweir<paragraph role="heading" id="hd_id3147057" xml-lang="en-US" level="2" l10n="U" oldref="31">Apply</paragraph> 179*cdf0e10cSrcweir<paragraph role="paragraph" id="par_id3155562" xml-lang="en-US" l10n="U" oldref="32"><ahelp hid="HID_FLDVAR_APPLY">Adds the user-defined field to the <emph>Selection</emph> list.</ahelp></paragraph> 180*cdf0e10cSrcweir<embed href="text/swriter/02/14040000.xhp#syuebernehmen"/> 181*cdf0e10cSrcweir</section> 182*cdf0e10cSrcweir<section id="loeschen"> 183*cdf0e10cSrcweir<bookmark xml-lang="en-US" branch="hid/SW_HID_FLDVAR_DELETE" id="bm_id3151092" localize="false"/> 184*cdf0e10cSrcweir<paragraph role="heading" id="hd_id3151080" xml-lang="en-US" level="2" l10n="U" oldref="33">Delete</paragraph> 185*cdf0e10cSrcweir<paragraph role="paragraph" id="par_id3154769" xml-lang="en-US" l10n="U" oldref="34"><ahelp hid="HID_FLDVAR_DELETE">Removes the user-defined field from the selection list. You can only remove fields that are not used in the current document.</ahelp> To remove a field that is used in the current document from the list, first delete all instances of the field in the document, and then remove it from the list.</paragraph> 186*cdf0e10cSrcweir<table id="tbl_id3154080"> 187*cdf0e10cSrcweir<tablerow> 188*cdf0e10cSrcweir<tablecell> 189*cdf0e10cSrcweir<paragraph role="paragraph" id="par_id3145318" xml-lang="en-US" l10n="E"> 190*cdf0e10cSrcweir<image id="img_id3153293" src="svx/res/nu02.png" width="0.423cm" height="0.423cm"><alt id="alt_id3153293" xml-lang="en-US">Icon</alt> 191*cdf0e10cSrcweir </image></paragraph> 192*cdf0e10cSrcweir</tablecell> 193*cdf0e10cSrcweir<tablecell> 194*cdf0e10cSrcweir<paragraph role="paragraph" id="par_id3150169" xml-lang="en-US" l10n="U" oldref="35">Delete</paragraph> 195*cdf0e10cSrcweir</tablecell> 196*cdf0e10cSrcweir</tablerow> 197*cdf0e10cSrcweir</table> 198*cdf0e10cSrcweir 199*cdf0e10cSrcweir</section> 200*cdf0e10cSrcweir</body> 201*cdf0e10cSrcweir</helpdocument> 202