<?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="textscalcguideaddress_autoxml" indexer="include" status="PUBLISH">
    <title id="tit">Recognizing Names as Addressing</title>
    <filename>/text/scalc/guide/address_auto.xhp</filename>
  </topic>
</meta>

<body>
<bookmark branch="index" id="bm_id3148797">
  <bookmark_value>automatic addressing in tables</bookmark_value>
  <bookmark_value>natural language addressing</bookmark_value>
  <bookmark_value>formulas; using row/column labels</bookmark_value>
  <bookmark_value>text in cells; as addressing</bookmark_value>
  <bookmark_value>addressing; automatic</bookmark_value>
  <bookmark_value>name recognition on/off</bookmark_value>
  <bookmark_value>row headers;using in formulas</bookmark_value>
  <bookmark_value>column headers;using in formulas</bookmark_value>
  <bookmark_value>columns; finding labels automatically</bookmark_value>
  <bookmark_value>rows; finding labels automatically</bookmark_value>
  <bookmark_value>recognizing; column and row labels</bookmark_value>
</bookmark>
<comment>mw changes "names;..." entry to "text in cells;..."</comment><comment>mw inserted three index entries from text/shared/optionen/01060500.xhp. Changed "finding;..." entry to "recognizing;..." entry. Adding (Calc) is no longer necessary in this file.</comment>

<h1 id="hd_id3148797"><variable id="address_auto"><link href="text/scalc/guide/address_auto.xhp">Recognizing Names as Addressing</link></variable></h1>
<paragraph id="par_id3152597" role="paragraph">You can use cells with text to refer to the rows or to the columns that contain the cells.</paragraph><comment>removed table as a workaround for issue 108715</comment>
<paragraph role="paragraph" id="par_id81713445694889">If the resulting cell is below or above another cell containing text, %PRODUCTNAME Calc assumes the text as a column label, else %PRODUCTNAME Calc assumes the text as a row label.</paragraph>
<paragraph id="par_id3156283" role="paragraph"><image id="img_id3154942" src="media/helpimg/names_as_addressing.png" width="380px" height="150px" localize="true"><alt id="alt_id3154942">Example spreadsheet</alt></image></paragraph>
<paragraph id="par_id3154512" role="paragraph">In the example spreadsheet, you can use the string <item type="literal">'Column One'</item> in a formula to refer to the cell range <item type="literal">B3</item> to <item type="literal">B5</item>, or <item type="literal">'Column Two'</item> for the cell range <item type="literal">C2</item> to <item type="literal">C5</item>. You can also use <item type="literal">'Row One'</item> for the cell range <item type="literal">B3</item> to <item type="literal">D3</item>, or <item type="literal">'Row Two'</item> for the cell range <item type="literal">B4</item> to <item type="literal">D4</item>. The result of a formula that uses a cell name, for example, <item type="literal">SUM('Column One')</item>, is 600.</paragraph>
<warning id="par_id3155443">Automatically finding labels is a legacy feature and deactivated by default as it can produce nondeterministic behavior depending on actual document content. To turn this function on, choose <switchinline select="sys"><caseinline select="MAC"><emph>%PRODUCTNAME - Preferences</emph></caseinline><defaultinline><emph>Tools - Options</emph></defaultinline></switchinline><emph> - %PRODUCTNAME Calc - Calculate</emph> and mark the <emph>Automatically find column and row labels</emph> check box.</warning>
<paragraph id="par_id3155444" role="paragraph">Using defined labels instead is always possible and behaves similar but in a defined way.</paragraph>
<tip id="par_id3149210">If you enter a label name in the formula yourself, enclose the name in single quotation marks ('). If a single quotation mark appears in a name, you must double it, for example, <item type="literal">'Harry''s Bar'</item>.</tip>

<section id="relatedtopics"><comment>mw changed reference to deleted Calc guide address_byname.xhp to refer to Calc guide value_with_name.xhp</comment><comment>UFI: changed embedvar links to embed links</comment>
  <paragraph role="paragraph" id="par_id671713443783478" localize="false"><embedvar href="text/scalc/guide/value_with_name.xhp#value_with_name" markup="ignore"/></paragraph>
  <paragraph role="paragraph" id="par_id21713443788358" localize="false"><embedvar href="text/scalc/01/04070400.xhp#h1" markup="ignore"/></paragraph>
  <paragraph role="paragraph" id="par_id61713443792677" localize="false"><embedvar href="text/scalc/guide/relativ_absolut_ref.xhp#relativ_absolut_ref" markup="ignore"/></paragraph>
</section>
</body>

</helpdocument>
