summaryrefslogtreecommitdiff
path: root/source/text/scalc/guide/rename_table.xhp
blob: dd03da71ec5cf3a52bc1af0c637f9859c514ac9f (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
<?xml version="1.0" encoding="UTF-8"?>
<helpdocument version="1.0">
<!--
 * This file is part of the LibreOffice project.
 *
 * This Source Code Form is subject to the terms of the Mozilla Public
 * License, v. 2.0. If a copy of the MPL was not distributed with this
 * file, You can obtain one at http://mozilla.org/MPL/2.0/.
 *
 * This file incorporates work covered by the following license notice:
 *
 *   Licensed to the Apache Software Foundation (ASF) under one or more
 *   contributor license agreements. See the NOTICE file distributed
 *   with this work for additional information regarding copyright
 *   ownership. The ASF licenses this file to you under the Apache
 *   License, Version 2.0 (the "License"); you may not use this file
 *   except in compliance with the License. You may obtain a copy of
 *   the License at http://www.apache.org/licenses/LICENSE-2.0 .
 -->

<meta>
      <topic id="textscalcguiderename_tablexml" indexer="include">
         <title xml-lang="en-US" id="tit">Renaming Sheets</title>
         <filename>/text/scalc/guide/rename_table.xhp</filename>
      </topic>
   </meta>
   <body>
<bookmark xml-lang="en-US" branch="index" id="bm_id3150398"><bookmark_value>renaming;sheets</bookmark_value>
      <bookmark_value>sheet tabs;renaming</bookmark_value>
      <bookmark_value>tables;renaming</bookmark_value>
      <bookmark_value>names; sheets</bookmark_value>
</bookmark>
<h1 xml-lang="en-US" id="hd_id3150398"><variable id="rename_table"><link href="text/scalc/guide/rename_table.xhp" name="Renaming Sheets">Renaming Sheets</link>
</variable></h1>
<paragraph role="paragraph" id="par_id701519308848244" xml-lang="en-US">Setting sheet names is an important feature to produce readable and understandable spreadsheets documents.</paragraph>
<tip xml-lang="en-US" id="par_id3155444">The name of a sheet is independent of the name of the spreadsheet. You enter the spreadsheet name when you save it for the first time as a file.</tip>
<paragraph role="paragraph" id="par_id471607437423400">To rename a sheet in your document:</paragraph>
      <list type="ordered">
         <listitem>
            <paragraph xml-lang="en-US" id="par_id3146976" role="listitem">Double-click the sheet tab or open its context menu and choose <menuitem>Rename Sheet</menuitem>. A dialog box appears where you can enter a new name.</paragraph>
         </listitem>
         <listitem>
            <paragraph xml-lang="en-US" id="par_id3149260" role="listitem">Enter a new name for the sheet and click <emph>OK</emph>.</paragraph>
         </listitem>
         <listitem>
            <paragraph xml-lang="en-US" id="par_id3149667" role="listitem">Alternatively, hold down the <switchinline select="sys"><caseinline select="MAC">Option key
</caseinline><defaultinline>Alt key</defaultinline></switchinline> and click on any sheet name and enter the new name directly.</paragraph>
         </listitem>
      </list>
<note xml-lang="en-US" id="par_id471519308256437">The document can contain up to 10,000 individual sheets, which must have different names.</note>
<h2 id="hd_id541607437294635">Sheet Naming Restrictions</h2>
      <paragraph xml-lang="en-US" id="par_id0909200810502833" role="paragraph">Sheet names can contain almost any character. Some naming restrictions apply, the following characters are not allowed in sheet names:</paragraph>
      <list type="unordered">
         <listitem>
            <paragraph xml-lang="en-US" id="par_id090920081050281" role="paragraph">colon <literal>:</literal></paragraph>
         </listitem>
         <listitem>
            <paragraph xml-lang="en-US" id="par_id0909200810502897" role="paragraph">back slash <literal>\</literal></paragraph>
         </listitem>
         <listitem>
            <paragraph xml-lang="en-US" id="par_id090920081050299" role="paragraph">forward slash <literal>/</literal></paragraph>
         </listitem>
         <listitem>
            <paragraph xml-lang="en-US" id="par_id0909200810502913" role="paragraph">question mark <literal>?</literal></paragraph>
         </listitem>
         <listitem>
            <paragraph xml-lang="en-US" id="par_id090920081050298" role="paragraph">asterisk <literal>*</literal></paragraph>
         </listitem>
         <listitem>
            <paragraph xml-lang="en-US" id="par_id0909200810502969" role="paragraph">left square bracket <literal>[</literal></paragraph>
         </listitem>
         <listitem>
            <paragraph xml-lang="en-US" id="par_id0909200810502910" role="paragraph">right square bracket <literal>]</literal></paragraph>
         </listitem>
         <listitem>
            <paragraph xml-lang="en-US" id="par_id0909200810502971" role="paragraph">single quote <literal>'</literal> as the first or last character of the name</paragraph>
         </listitem>
      </list>
<paragraph role="paragraph" id="par_id761607437686157">The single quote is Unicode <literal>U+0027</literal>, also known as <literal>apostrophe</literal>. Other single-quote characters, similar to <literal>apostrophe</literal>, are allowed, such as <literal>ʼ</literal> <literal>‛</literal> and <literal>‚</literal>.</paragraph>
<h2 id="hd_id251607438968588">Using a Default Prefix for Sheet Names</h2>
     <paragraph role="paragraph" id="par_id81519309108908" xml-lang="en-US">You can set a prefix for the names of new sheets you create. Choose <switchinline select="sys"><caseinline select="MAC"><menuitem>%PRODUCTNAME - Preferences</menuitem></caseinline><defaultinline><menuitem>Tools - Options</menuitem></defaultinline></switchinline><menuitem> - %PRODUCTNAME Calc - Defaults</menuitem> and enter the prefix name in <emph>Prefix name for new worksheet</emph>.</paragraph>
<h2 id="hd_id821607437571713">Referencing Sheet Names with Special Characters</h2>
      <paragraph xml-lang="en-US" id="par_id090920081050307" role="paragraph">In cell references, a sheet name must be enclosed in single quotes <literal>'</literal> when the name contains other characters than alphanumeric or underscore. A single quote contained within a name has to be escaped by doubling it (two single quotes).</paragraph>
      <paragraph role="paragraph" id="par_id321519307869857" xml-lang="en-US">For example, you want to reference the <literal>cell A1</literal> on a sheet named <literal>This year's sheet</literal>.</paragraph>
      
      <paragraph xml-lang="en-US" id="par_id0909200810503054" role="paragraph"> The reference must be enclosed in single quotes, and the one single quote inside the name must be doubled: <literal>'This year''s sheet'.A1</literal></paragraph>
      <section id="relatedtopics">
         <embed href="text/scalc/guide/multitables.xhp#multitables"/>
      </section>
   </body>
</helpdocument>