1*b1cdbd2cSJim Jagielski<?xml version="1.0" encoding="UTF-8"?> 2*b1cdbd2cSJim Jagielski 3*b1cdbd2cSJim Jagielski 4*b1cdbd2cSJim Jagielski<!--*********************************************************** 5*b1cdbd2cSJim Jagielski * 6*b1cdbd2cSJim Jagielski * Licensed to the Apache Software Foundation (ASF) under one 7*b1cdbd2cSJim Jagielski * or more contributor license agreements. See the NOTICE file 8*b1cdbd2cSJim Jagielski * distributed with this work for additional information 9*b1cdbd2cSJim Jagielski * regarding copyright ownership. The ASF licenses this file 10*b1cdbd2cSJim Jagielski * to you under the Apache License, Version 2.0 (the 11*b1cdbd2cSJim Jagielski * "License"); you may not use this file except in compliance 12*b1cdbd2cSJim Jagielski * with the License. You may obtain a copy of the License at 13*b1cdbd2cSJim Jagielski * 14*b1cdbd2cSJim Jagielski * http://www.apache.org/licenses/LICENSE-2.0 15*b1cdbd2cSJim Jagielski * 16*b1cdbd2cSJim Jagielski * Unless required by applicable law or agreed to in writing, 17*b1cdbd2cSJim Jagielski * software distributed under the License is distributed on an 18*b1cdbd2cSJim Jagielski * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY 19*b1cdbd2cSJim Jagielski * KIND, either express or implied. See the License for the 20*b1cdbd2cSJim Jagielski * specific language governing permissions and limitations 21*b1cdbd2cSJim Jagielski * under the License. 22*b1cdbd2cSJim Jagielski * 23*b1cdbd2cSJim Jagielski ***********************************************************--> 24*b1cdbd2cSJim Jagielski 25*b1cdbd2cSJim Jagielski 26*b1cdbd2cSJim Jagielski 27*b1cdbd2cSJim Jagielski<helpdocument version="1.0"> 28*b1cdbd2cSJim Jagielski<meta> 29*b1cdbd2cSJim Jagielski<topic id="textswriter0104020100xml" indexer="include" status="PUBLISH"> 30*b1cdbd2cSJim Jagielski<title id="tit" xml-lang="en-US">Section</title> 31*b1cdbd2cSJim Jagielski<filename>/text/swriter/01/04020100.xhp</filename> 32*b1cdbd2cSJim Jagielski</topic> 33*b1cdbd2cSJim Jagielski<history> 34*b1cdbd2cSJim Jagielski<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> 35*b1cdbd2cSJim Jagielski<lastedited date="2005-05-09T15:56:18">converted from old format - fpe</lastedited> 36*b1cdbd2cSJim Jagielski</history> 37*b1cdbd2cSJim Jagielski</meta> 38*b1cdbd2cSJim Jagielski<body> 39*b1cdbd2cSJim Jagielski<section id="bereich"> 40*b1cdbd2cSJim Jagielski<bookmark xml-lang="en-US" branch="index" id="bm_id5941038"><bookmark_value>sections;inserting sections by DDE</bookmark_value> 41*b1cdbd2cSJim Jagielski<bookmark_value>DDE; command for inserting sections</bookmark_value> 42*b1cdbd2cSJim Jagielski</bookmark> 43*b1cdbd2cSJim Jagielski<paragraph role="heading" id="hd_id3157557" xml-lang="en-US" level="1" l10n="U" oldref="37"><link href="text/swriter/01/04020100.xhp" name="Section">Section</link></paragraph> 44*b1cdbd2cSJim Jagielski<paragraph role="paragraph" id="par_id3154644" xml-lang="en-US" l10n="U" oldref="38">Sets the properties of the section.</paragraph> 45*b1cdbd2cSJim Jagielski</section> 46*b1cdbd2cSJim Jagielski<section id="howtoget"> 47*b1cdbd2cSJim Jagielski <embed href="text/swriter/00/00000404.xhp#bereicheinbereich"/> 48*b1cdbd2cSJim Jagielski</section> 49*b1cdbd2cSJim Jagielski<bookmark xml-lang="en-US" branch="hid/sw:ComboBox:TP_INSERT_SECTION:ED_RNAME" id="bm_id3145413" localize="false"/> 50*b1cdbd2cSJim Jagielski<bookmark xml-lang="en-US" branch="hid/sw:Edit:MD_EDIT_REGION:ED_RANAME" id="bm_id8467970" localize="false"/> 51*b1cdbd2cSJim Jagielski<paragraph role="heading" id="hd_id3151170" xml-lang="en-US" level="2" l10n="U" oldref="6">New Section</paragraph> 52*b1cdbd2cSJim Jagielski<paragraph role="paragraph" id="par_id3145420" xml-lang="en-US" l10n="U" oldref="7"><ahelp hid="SW:COMBOBOX:TP_INSERT_SECTION:ED_RNAME">Type a name for the new section.</ahelp> By default, $[officename] automatically assigns the name "Section X" to new sections, where X is a consecutive number.</paragraph> 53*b1cdbd2cSJim Jagielski<paragraph role="heading" id="hd_id3154102" xml-lang="en-US" level="2" l10n="U" oldref="8">Link</paragraph> 54*b1cdbd2cSJim Jagielski<bookmark xml-lang="en-US" branch="hid/sw:TriStateBox:MD_EDIT_REGION:CB_FILE" id="bm_id3153532" localize="false"/> 55*b1cdbd2cSJim Jagielski<bookmark xml-lang="en-US" branch="hid/sw:CheckBox:TP_INSERT_SECTION:CB_FILE" id="bm_id3153536" localize="false"/> 56*b1cdbd2cSJim Jagielski<paragraph role="heading" id="hd_id3149806" xml-lang="en-US" level="3" l10n="U" oldref="20">Link</paragraph> 57*b1cdbd2cSJim Jagielski<paragraph role="paragraph" id="par_id3154472" xml-lang="en-US" l10n="U" oldref="21"><ahelp hid="SW:CHECKBOX:TP_INSERT_SECTION:CB_FILE">Inserts the contents of another document or section from another document in the current section.</ahelp></paragraph> 58*b1cdbd2cSJim Jagielski<bookmark xml-lang="en-US" branch="hid/sw:CheckBox:TP_INSERT_SECTION:CB_DDE" id="bm_id3154569" localize="false"/> 59*b1cdbd2cSJim Jagielski<bookmark xml-lang="en-US" branch="hid/sw:CheckBox:MD_EDIT_REGION:CB_DDE" id="bm_id3154573" localize="false"/> 60*b1cdbd2cSJim Jagielski<switch select="sys"> 61*b1cdbd2cSJim Jagielski<case select="WIN"> 62*b1cdbd2cSJim Jagielski<paragraph role="heading" id="hd_id3153672" xml-lang="en-US" level="3" l10n="U" oldref="26">DDE<comment>UFI: WIN only, while fixing #109638#</comment></paragraph> 63*b1cdbd2cSJim Jagielski<paragraph role="paragraph" id="par_id3151310" xml-lang="en-US" l10n="U" oldref="27"><ahelp hid="SW:CHECKBOX:MD_EDIT_REGION:CB_DDE">Creates a <emph>DDE </emph>link. Select this check box, and then enter the <emph>DDE </emph>command that you want to use. The <emph>DDE</emph> option is only available if the <emph>Link</emph> check box is selected.</ahelp></paragraph> 64*b1cdbd2cSJim Jagielski<paragraph role="paragraph" id="par_id3143280" xml-lang="en-US" l10n="U" oldref="34">The general syntax for a DDE command is: "<Server> <Topic> <Item>", where server is the DDE name for the application that contains the data. Topic refers to the location of the Item (usually the file name), and Item represents the actual object.</paragraph> 65*b1cdbd2cSJim Jagielski<paragraph role="paragraph" id="par_id3149098" xml-lang="en-US" l10n="U" oldref="35">For example, to insert a section named "Section1" from a $[officename] text document abc.sxw as a DDE link, use the command: "soffice x:\abc.sxw Section1". To insert the contents of the first cell from a MS Excel spreadsheet file called "abc.xls", use the command: "excel x:\[abc.xls]Sheet1 z1s1". You can also copy the elements that you want to insert as a DDE link, and then <emph>Edit - Paste Special</emph>. You can then view the DDE command for the link, by selecting the contents and choosing <emph>Edit - Fields</emph>.</paragraph> 66*b1cdbd2cSJim Jagielski</case> 67*b1cdbd2cSJim Jagielski</switch> 68*b1cdbd2cSJim Jagielski<bookmark xml-lang="en-US" branch="hid/sw:Edit:TP_INSERT_SECTION:ED_FILE" id="bm_id3149038" localize="false"/> 69*b1cdbd2cSJim Jagielski<bookmark xml-lang="en-US" branch="hid/sw:Edit:MD_EDIT_REGION:ED_FILE" id="bm_id3149042" localize="false"/> 70*b1cdbd2cSJim Jagielski<paragraph role="heading" id="hd_id3153640" xml-lang="en-US" level="3" l10n="U" oldref="28">File name<switchinline select="sys"><caseinline select="WIN"> / DDE command 71*b1cdbd2cSJim Jagielski</caseinline></switchinline></paragraph> 72*b1cdbd2cSJim Jagielski<paragraph role="paragraph" id="par_id3145754" xml-lang="en-US" l10n="U" oldref="29"><ahelp hid="SW:EDIT:MD_EDIT_REGION:ED_FILE">Enter the path and the filename for the file that you want to insert, or click the browse button (<emph>...</emph>) to locate the file.</ahelp><switchinline select="sys"><caseinline select="WIN">If the <emph>DDE </emph>check box is selected, enter the DDE command that you want to use. 73*b1cdbd2cSJim Jagielski</caseinline></switchinline></paragraph> 74*b1cdbd2cSJim Jagielski<bookmark xml-lang="en-US" branch="hid/sw:PushButton:TP_INSERT_SECTION:PB_FILE" id="bm_id3155148" localize="false"/> 75*b1cdbd2cSJim Jagielski<bookmark xml-lang="en-US" branch="hid/sw:PushButton:MD_EDIT_REGION:PB_FILE" id="bm_id3156266" localize="false"/> 76*b1cdbd2cSJim Jagielski<paragraph role="heading" id="hd_id3155136" xml-lang="en-US" level="3" l10n="U" oldref="39">...</paragraph> 77*b1cdbd2cSJim Jagielski<paragraph role="paragraph" id="par_id3156274" xml-lang="en-US" l10n="U" oldref="40"><ahelp hid="SW:PUSHBUTTON:MD_EDIT_REGION:PB_FILE">Locate the file that you want to insert as a link, and then click <emph>Insert</emph>.</ahelp></paragraph> 78*b1cdbd2cSJim Jagielski<bookmark xml-lang="en-US" branch="hid/sw:ComboBox:TP_INSERT_SECTION:LB_SUBREG" id="bm_id3145781" localize="false"/> 79*b1cdbd2cSJim Jagielski<bookmark xml-lang="en-US" branch="hid/sw:ComboBox:MD_EDIT_REGION:LB_SUBREG" id="bm_id3145785" localize="false"/> 80*b1cdbd2cSJim Jagielski<paragraph role="heading" id="hd_id3149180" xml-lang="en-US" level="3" l10n="U" oldref="23">Section</paragraph> 81*b1cdbd2cSJim Jagielski<paragraph role="paragraph" id="par_id3155910" xml-lang="en-US" l10n="U" oldref="24"><ahelp hid="SW:COMBOBOX:MD_EDIT_REGION:LB_SUBREG">Select the section in the file that you want to insert as a link.</ahelp></paragraph> 82*b1cdbd2cSJim Jagielski<paragraph role="paragraph" id="par_id3151373" xml-lang="en-US" l10n="U" oldref="25">When you open a document that contains linked sections, you are prompted to update the links.</paragraph> 83*b1cdbd2cSJim Jagielski<paragraph role="heading" id="hd_id3150687" xml-lang="en-US" level="2" l10n="U" oldref="43">Write Protection</paragraph> 84*b1cdbd2cSJim Jagielski<bookmark xml-lang="en-US" branch="hid/sw:CheckBox:TP_INSERT_SECTION:CB_PROTECT" id="bm_id3155864" localize="false"/> 85*b1cdbd2cSJim Jagielski<bookmark xml-lang="en-US" branch="hid/sw:TriStateBox:MD_EDIT_REGION:CB_PROTECT" id="bm_id3155868" localize="false"/> 86*b1cdbd2cSJim Jagielski<paragraph role="heading" id="hd_id3150700" xml-lang="en-US" level="3" l10n="U" oldref="10">Protected</paragraph> 87*b1cdbd2cSJim Jagielski<paragraph role="paragraph" id="par_id3150110" xml-lang="en-US" l10n="U" oldref="11"><ahelp hid="SW:TRISTATEBOX:MD_EDIT_REGION:CB_PROTECT">Prevents the selected section from being edited.</ahelp></paragraph> 88*b1cdbd2cSJim Jagielski<bookmark xml-lang="en-US" branch="hid/sw:CheckBox:TP_INSERT_SECTION:CB_PASSWD" id="bm_id3145273" localize="false"/> 89*b1cdbd2cSJim Jagielski<paragraph role="heading" id="hd_id3145261" xml-lang="en-US" level="3" l10n="U" oldref="44">With password</paragraph> 90*b1cdbd2cSJim Jagielski<paragraph role="paragraph" id="par_id3149555" xml-lang="en-US" l10n="U" oldref="45"><ahelp hid="SW_CHECKBOX_TP_INSERT_SECTION_CB_PASSWD">Protects the selected section with a password. The password must have a minimum of 5 characters.</ahelp></paragraph> 91*b1cdbd2cSJim Jagielski<bookmark xml-lang="en-US" branch="hid/sw:PushButton:MD_EDIT_REGION:PB_PASSWD" id="bm_id3150561" localize="false"/> 92*b1cdbd2cSJim Jagielski<bookmark xml-lang="en-US" branch="hid/sw:PushButton:TP_INSERT_SECTION:PB_PASSWD" id="bm_id3147735" localize="false"/> 93*b1cdbd2cSJim Jagielski<paragraph role="heading" id="hd_id3150549" xml-lang="en-US" level="3" l10n="U" oldref="46">...</paragraph> 94*b1cdbd2cSJim Jagielski<paragraph role="paragraph" id="par_id3147742" xml-lang="en-US" l10n="U" oldref="47"><ahelp hid="SW_PUSHBUTTON_TP_INSERT_SECTION_PB_PASSWD">Opens a dialog where you can change the current password.</ahelp></paragraph> 95*b1cdbd2cSJim Jagielski<paragraph role="heading" id="hd_id3146333" xml-lang="en-US" level="2" l10n="U" oldref="48">Hide</paragraph> 96*b1cdbd2cSJim Jagielski<bookmark xml-lang="en-US" branch="hid/sw:CheckBox:TP_INSERT_SECTION:CB_HIDE" id="bm_id3149843" localize="false"/> 97*b1cdbd2cSJim Jagielski<bookmark xml-lang="en-US" branch="hid/sw:TriStateBox:MD_EDIT_REGION:CB_HIDE" id="bm_id3149847" localize="false"/> 98*b1cdbd2cSJim Jagielski<paragraph role="heading" id="hd_id3149830" xml-lang="en-US" level="3" l10n="U" oldref="12">Hide</paragraph> 99*b1cdbd2cSJim Jagielski<paragraph role="paragraph" id="par_id3148849" xml-lang="en-US" l10n="U" oldref="13"><ahelp hid="SW:TRISTATEBOX:MD_EDIT_REGION:CB_HIDE">Hides and prevents the selected section from being printed.</ahelp> The components of a hidden sections appear gray in the Navigator. When you rest your mouse pointer over a hidden component in the Navigator, the Help tip "hidden" is displayed.</paragraph> 100*b1cdbd2cSJim Jagielski<paragraph role="note" id="par_id3155074" xml-lang="en-US" l10n="U" oldref="50">You cannot hide a section if it is the only content on a page, or in a header, footer, footnote, frame, or table cell.</paragraph> 101*b1cdbd2cSJim Jagielski<bookmark xml-lang="en-US" branch="hid/sw:Edit:TP_INSERT_SECTION:ED_CONDITION" id="bm_id3154334" localize="false"/> 102*b1cdbd2cSJim Jagielski<bookmark xml-lang="en-US" branch="hid/sw:Edit:MD_EDIT_REGION:ED_CONDITION" id="bm_id3154338" localize="false"/> 103*b1cdbd2cSJim Jagielski<paragraph role="heading" id="hd_id3154323" xml-lang="en-US" level="3" l10n="U" oldref="16">With condition</paragraph> 104*b1cdbd2cSJim Jagielski<paragraph role="paragraph" id="par_id3154343" xml-lang="en-US" l10n="U" oldref="17"><ahelp hid="SW:EDIT:MD_EDIT_REGION:ED_CONDITION">Enter the condition that must be met to hide the section.</ahelp> A condition is a <link href="text/swriter/01/04090200.xhp" name="logical expression">logical expression</link>, such as "SALUTATION EQ Mr.". For example, if you use the <link href="text/swriter/guide/form_letters_main.xhp" name="mail merge">mail merge</link> form letter feature to define a database field called "Salutation" that contains "Mr.", "Ms.", or "Sir or Madam", you can then specify that a section will only be printed if the salutation is "Mr.".</paragraph> 105*b1cdbd2cSJim Jagielski<paragraph role="paragraph" id="par_id3150086" xml-lang="en-US" l10n="U" oldref="18">Another example would be to create the field variable "x" and set its value to 1. Then specify a condition based on this variable for hiding a section, such as: "x eq 1". If you want to display the section, set the value of the variable "x" to "0".</paragraph> 106*b1cdbd2cSJim Jagielski<paragraph role="heading" id="par_idN108DF" xml-lang="en-US" level="2" l10n="NEW">Properties</paragraph> 107*b1cdbd2cSJim Jagielski<paragraph role="paragraph" id="par_idN108E3" xml-lang="en-US" l10n="NEW">You see this area of the dialog when the current document is an XForms document.</paragraph> 108*b1cdbd2cSJim Jagielski<paragraph role="heading" id="par_idN108E6" xml-lang="en-US" level="3" l10n="NEW">Editable in read-only document</paragraph> 109*b1cdbd2cSJim Jagielski<paragraph role="paragraph" id="par_idN108EA" xml-lang="en-US" l10n="NEW">Select to allow editing of the section's contents even if the document is opened in read-only mode.</paragraph> 110*b1cdbd2cSJim Jagielski<embed href="text/shared/00/00000004.xhp#related"/> 111*b1cdbd2cSJim Jagielski<paragraph role="paragraph" id="par_id3150032" xml-lang="en-US" l10n="U" oldref="19"><link href="text/swriter/01/04090000.xhp" name="Field commands">Field commands</link></paragraph> 112*b1cdbd2cSJim Jagielski<paragraph role="paragraph" id="par_id3158420" xml-lang="en-US" l10n="U" oldref="51"><link href="text/swriter/01/04090200.xhp" name="Syntax for conditions">Syntax for conditions</link></paragraph> 113*b1cdbd2cSJim Jagielski</body> 114*b1cdbd2cSJim Jagielski</helpdocument> 115