diff options
author | Vladimir Glazounov <vg@openoffice.org> | 2008-01-24 12:50:50 +0000 |
---|---|---|
committer | Vladimir Glazounov <vg@openoffice.org> | 2008-01-24 12:50:50 +0000 |
commit | c6cfc1d946bb2ba0547b766cbab8df0433a18560 (patch) | |
tree | dc5ebf0f75782ab49aa2d2a93378233ab8e91df4 /helpcontent2/source/text/scalc/01/04060109.xhp | |
parent | 96a3ea5b362609fb228aef36b317d4eb46b10df8 (diff) |
INTEGRATION: CWS hcshared15 (1.15.6); FILE MERGED
2008/01/11 14:00:17 ufi 1.15.6.3: new makefiles und zwischenstand
2008/01/04 11:42:54 ufi 1.15.6.2: Zwischenstand
2007/12/18 12:12:14 ufi 1.15.6.1: saving
Diffstat (limited to 'helpcontent2/source/text/scalc/01/04060109.xhp')
-rw-r--r-- | helpcontent2/source/text/scalc/01/04060109.xhp | 293 |
1 files changed, 181 insertions, 112 deletions
diff --git a/helpcontent2/source/text/scalc/01/04060109.xhp b/helpcontent2/source/text/scalc/01/04060109.xhp index 0ad9310cd1..466bf6987d 100644 --- a/helpcontent2/source/text/scalc/01/04060109.xhp +++ b/helpcontent2/source/text/scalc/01/04060109.xhp @@ -7,9 +7,9 @@ * * $RCSfile: 04060109.xhp,v $fileonly,v $ * - * $Revision: 1.15 $ + * $Revision: 1.16 $ * - * last change: $Author: ihi $ $Date: 2007-11-23 16:24:37 $ + * last change: $Author: vg $ $Date: 2008-01-24 13:50:50 $ * * The Contents of this file are made available subject to * the terms of GNU Lesser General Public License Version 2.1. @@ -60,22 +60,23 @@ <bookmark xml-lang="en-US" branch="hid/HID_FUNC_ADRESSE" id="bm_id3147546" localize="false"/><paragraph role="heading" id="hd_id3146968" xml-lang="en-US" level="2" l10n="U" oldref="3">ADDRESS</paragraph> <paragraph role="paragraph" id="par_id3155762" xml-lang="en-US" l10n="CHG" oldref="4"><ahelp hid="HID_FUNC_ADRESSE">Returns a cell address (reference) as text, according to the specified row and column numbers.</ahelp> You can determine whether the address is interpreted as an absolute address (for example, $A$1) or as a relative address (as A1) or in a mixed form (A$1 or $A1). You can also specify the name of the sheet.</paragraph> <paragraph role="heading" id="hd_id3151196" xml-lang="en-US" level="3" l10n="U" oldref="5">Syntax</paragraph> -<paragraph role="code" id="par_id3154707" xml-lang="en-US" l10n="U" oldref="6">ADDRESS(row; column; abs;sheet)</paragraph> +<paragraph role="code" id="par_id3154707" xml-lang="en-US" l10n="U" oldref="6">ADDRESS(Row; Column; Abs; "Sheet")</paragraph> <paragraph role="paragraph" id="par_id3147505" xml-lang="en-US" l10n="U" oldref="7"> -<emph>row</emph> represents the row number for the cell reference</paragraph> +<emph>Row</emph> represents the row number for the cell reference</paragraph> <paragraph role="paragraph" id="par_id3145323" xml-lang="en-US" l10n="U" oldref="8"> -<emph>column</emph> represents the column number for the cell reference (the number, not the letter)</paragraph> +<emph>Column</emph> represents the column number for the cell reference (the number, not the letter)</paragraph> <paragraph role="paragraph" id="par_id3153074" xml-lang="en-US" l10n="U" oldref="9"> -<emph>abs</emph> determines the type of reference:</paragraph> +<emph>Abs</emph> determines the type of reference:</paragraph> <paragraph role="paragraph" id="par_id3153298" xml-lang="en-US" l10n="CHG" oldref="10">1: absolute ($A$1)</paragraph> <paragraph role="paragraph" id="par_id3150431" xml-lang="en-US" l10n="U" oldref="11">2: row reference type is absolute; column reference is relative (A$1)</paragraph> <paragraph role="paragraph" id="par_id3146096" xml-lang="en-US" l10n="U" oldref="12">3: row (relative); column (absolute) ($A1)</paragraph> <paragraph role="paragraph" id="par_id3153334" xml-lang="en-US" l10n="U" oldref="13">4: relative (A1)</paragraph> <paragraph role="paragraph" id="par_id3153962" xml-lang="en-US" l10n="U" oldref="14"> -<emph>sheet</emph> represents the name of the sheet. It must be placed in double quotes.</paragraph> +<emph>Sheet</emph> represents the name of the sheet. It must be placed in double quotes.</paragraph> <paragraph role="heading" id="hd_id3147299" xml-lang="en-US" level="3" l10n="U" oldref="15">Example:</paragraph> -<paragraph role="paragraph" id="par_id3148744" xml-lang="en-US" l10n="U" oldref="16">ADDRESS(1; 1; 2; "Sheet2") returns the following: Sheet2.A$1</paragraph> -<paragraph role="paragraph" id="par_id3159260" xml-lang="en-US" l10n="U" oldref="17">If the cell A1 in sheet 2 contains the value -6, you can refer indirectly to the referenced cell using a function in B2 by entering =ABS(INDIRECT(B2)). The result is the absolute value of the cell reference specified in B2, which in this case is 6.</paragraph> +<paragraph role="paragraph" id="par_id3148744" xml-lang="en-US" l10n="U" oldref="16"> +<item type="input">=ADDRESS(1;1;2;"Sheet2")</item> returns the following: Sheet2.A$1</paragraph> +<paragraph role="paragraph" id="par_id3159260" xml-lang="en-US" l10n="U" oldref="17">If the cell A1 in sheet 2 contains the value <item type="input">-6</item>, you can refer indirectly to the referenced cell using a function in B2 by entering <item type="input">=ABS(INDIRECT(B2))</item>. The result is the absolute value of the cell reference specified in B2, which in this case is 6.</paragraph> </section> <section id="Section2"> <bookmark xml-lang="en-US" branch="index" id="bm_id3150372"><bookmark_value>AREAS function</bookmark_value> @@ -86,8 +87,10 @@ <paragraph role="code" id="par_id3155907" xml-lang="en-US" l10n="U" oldref="22">AREAS(Reference)</paragraph> <paragraph role="paragraph" id="par_id3153118" xml-lang="en-US" l10n="U" oldref="23">Reference represents the reference to a cell or cell range.</paragraph> <paragraph role="heading" id="hd_id3148891" xml-lang="en-US" level="3" l10n="U" oldref="24">Example</paragraph> -<paragraph role="paragraph" id="par_id3149946" xml-lang="en-US" l10n="U" oldref="25">=AREAS(A1:B3;F2;G1) returns 3, as it is a reference to three cells and/or areas.</paragraph> -<paragraph role="paragraph" id="par_id3146820" xml-lang="en-US" l10n="U" oldref="26">=AREAS(All) returns 1 if you have defined an area named All under <emph>Data - Define Range</emph>.</paragraph> +<paragraph role="paragraph" id="par_id3149946" xml-lang="en-US" l10n="U" oldref="25"> +<item type="input">=AREAS(A1:B3;F2;G1)</item> returns 3, as it is a reference to three cells and/or areas.</paragraph> +<paragraph role="paragraph" id="par_id3146820" xml-lang="en-US" l10n="U" oldref="26"> +<item type="input">=AREAS(All)</item> returns 1 if you have defined an area named All under <emph>Data - Define Range</emph>.</paragraph> </section> <section id="Section3"> <bookmark xml-lang="en-US" branch="index" id="bm_id3148727"><bookmark_value>DDE function</bookmark_value> @@ -95,7 +98,7 @@ <bookmark xml-lang="en-US" branch="hid/HID_FUNC_DDE" id="bm_id3154680" localize="false"/><paragraph role="heading" id="hd_id3148727" xml-lang="en-US" level="2" l10n="U" oldref="28">DDE</paragraph> <paragraph role="paragraph" id="par_id3149434" xml-lang="en-US" l10n="U" oldref="29"><ahelp hid="HID_FUNC_DDE">Returns the result of a DDE-based link.</ahelp> If the contents of the linked range or section changes, the returned value will also change. You must reload the spreadsheet or choose <emph>Edit - Links</emph> to see the updated links. Cross-platform links, for example from a <item type="productname">%PRODUCTNAME</item> installation running on a Windows machine to a document created on a Linux machine, are not allowed.</paragraph> <paragraph role="heading" id="hd_id3150700" xml-lang="en-US" level="3" l10n="U" oldref="30">Syntax</paragraph> -<paragraph role="code" id="par_id3148886" xml-lang="en-US" l10n="U" oldref="31">DDE(server;file;range;mode)</paragraph> +<paragraph role="code" id="par_id3148886" xml-lang="en-US" l10n="U" oldref="31">DDE("Server"; "File"; "Range"; Mode)</paragraph> <paragraph role="paragraph" id="par_id3154842" xml-lang="en-US" l10n="U" oldref="32"> <emph>Server</emph> is the name of a server application. <item type="productname">%PRODUCTNAME</item> applications have the server name "Soffice".</paragraph> <paragraph role="paragraph" id="par_id3153034" xml-lang="en-US" l10n="U" oldref="33"> @@ -144,9 +147,9 @@ </table> <paragraph role="heading" id="hd_id3149546" xml-lang="en-US" level="3" l10n="U" oldref="35">Example</paragraph> <paragraph role="paragraph" id="par_id3148734" xml-lang="en-US" l10n="U" oldref="36"> -<item type="keycode">=DDE("soffice";"c:\office\document\data1.sxc";"sheet1.A1")</item> reads the contents of cell A1 in sheet1 of the <item type="productname">%PRODUCTNAME</item> Calc spreadsheet data1.sxc.</paragraph> +<item type="input">=DDE("soffice";"c:\office\document\data1.sxc";"sheet1.A1")</item> reads the contents of cell A1 in sheet1 of the <item type="productname">%PRODUCTNAME</item> Calc spreadsheet data1.sxc.</paragraph> <paragraph role="paragraph" id="par_id3153081" xml-lang="en-US" l10n="U" oldref="37"> -<item type="keycode">=DDE("soffice";"c:\office\document\motto.sxw";"Today's motto")</item> returns a motto in the cell containing this formula. First, you must enter a line in the motto.sxw document containing the motto text and define it as the first line of a section named <item type="literal">Today's Motto</item> (in <item type="productname">%PRODUCTNAME</item> Writer under <emph>Insert - Section</emph>). If the motto is modified (and saved) in the <item type="productname">%PRODUCTNAME</item> Writer document, the motto is updated in all <item type="productname">%PRODUCTNAME</item> Calc cells in which this DDE link is defined.</paragraph> +<item type="input">=DDE("soffice";"c:\office\document\motto.sxw";"Today's motto")</item> returns a motto in the cell containing this formula. First, you must enter a line in the motto.sxw document containing the motto text and define it as the first line of a section named <item type="literal">Today's Motto</item> (in <item type="productname">%PRODUCTNAME</item> Writer under <emph>Insert - Section</emph>). If the motto is modified (and saved) in the <item type="productname">%PRODUCTNAME</item> Writer document, the motto is updated in all <item type="productname">%PRODUCTNAME</item> Calc cells in which this DDE link is defined.</paragraph> </section> <section id="Section4"> <bookmark xml-lang="en-US" branch="index" id="bm_id3153114"><bookmark_value>ERRORTYPE function</bookmark_value> @@ -160,31 +163,41 @@ <paragraph role="paragraph" id="par_id3150132" xml-lang="en-US" l10n="U" oldref="43"> <emph>Reference</emph> contains the address of the cell in which the error occurs.</paragraph> <paragraph role="heading" id="hd_id3145248" xml-lang="en-US" level="3" l10n="U" oldref="44">Example</paragraph> -<paragraph role="paragraph" id="par_id3146904" xml-lang="en-US" l10n="U" oldref="45">If cell A1 displays Err:518, the function =ERRORTYPE(A1) returns the number 518.</paragraph> +<paragraph role="paragraph" id="par_id3146904" xml-lang="en-US" l10n="U" oldref="45">If cell A1 displays Err:518, the function <item type="input">=ERRORTYPE(A1)</item> returns the number 518.</paragraph> </section> <section id="Section5"> <bookmark xml-lang="en-US" branch="index" id="bm_id3151221"><bookmark_value>INDEX function</bookmark_value> </bookmark> <bookmark xml-lang="en-US" branch="hid/HID_FUNC_INDEX" id="bm_id3157989" localize="false"/><paragraph role="heading" id="hd_id3151221" xml-lang="en-US" level="2" l10n="U" oldref="47">INDEX</paragraph> -<paragraph role="paragraph" id="par_id3150268" xml-lang="en-US" l10n="U" oldref="48"><ahelp hid="HID_FUNC_INDEX">INDEX returns the content of a cell, specified by row and column number or an optional range name.</ahelp><comment>UFI: will change with i4904; see http://so-web.germany.sun.com/iBIS/servlet/edit.ControlPanel?tid=i57108</comment></paragraph> +<paragraph role="paragraph" id="par_id3150268" xml-lang="en-US" l10n="CHG" oldref="48"><ahelp hid="HID_FUNC_INDEX">INDEX returns a sub range, specified by row and column number, or an optional range index.</ahelp><comment>UFI: will change with i4904; see http://so-web.germany.sun.com/iBIS/servlet/edit.ControlPanel?tid=i57108</comment><comment>changed by i83070</comment></paragraph> <paragraph role="heading" id="hd_id3156063" xml-lang="en-US" level="3" l10n="U" oldref="49">Syntax</paragraph> -<paragraph role="code" id="par_id3149007" xml-lang="en-US" l10n="U" oldref="50">INDEX(reference;row;column;range)</paragraph> -<paragraph role="paragraph" id="par_id3153260" xml-lang="en-US" l10n="U" oldref="51"> -<emph>reference</emph> is a cell reference, entered either directly or by specifying a range name. If the reference consists of multiple ranges, you must enclose the reference or range name in parentheses.</paragraph> -<paragraph role="paragraph" id="par_id3145302" xml-lang="en-US" l10n="U" oldref="52"> -<emph>row</emph> (optional) represents the row number of the reference range, for which to return a value.</paragraph> -<paragraph role="paragraph" id="par_id3154628" xml-lang="en-US" l10n="U" oldref="53"> -<emph>column</emph> (optional) represents the column number of the reference range, for which to return a value.</paragraph> +<paragraph role="code" id="par_id3149007" xml-lang="en-US" l10n="U" oldref="50">INDEX(Reference; Row; Column; Range)</paragraph> +<paragraph role="paragraph" id="par_id3153260" xml-lang="en-US" l10n="CHG" oldref="51"> +<emph>Reference</emph> is a reference, entered either directly or by specifying a range name. If the reference consists of multiple ranges, you must enclose the reference or range name in parentheses.</paragraph> +<paragraph role="paragraph" id="par_id3145302" xml-lang="en-US" l10n="CHG" oldref="52"> +<emph>Row</emph> (optional) represents the row index of the reference range, for which to return a value. In case of zero (no specific row) all referenced rows are returned.</paragraph> +<paragraph role="paragraph" id="par_id3154628" xml-lang="en-US" l10n="CHG" oldref="53"> +<emph>Column</emph> (optional) represents the column index of the reference range, for which to return a value. In case of zero (no specific column) all referenced columns are returned.</paragraph> <paragraph role="paragraph" id="par_id3155514" xml-lang="en-US" l10n="U" oldref="54"> -<emph>range</emph> (optional) represents the index of the subrange if referring to a multiple range.</paragraph> +<emph>Range</emph> (optional) represents the index of the subrange if referring to a multiple range.</paragraph> <paragraph role="paragraph" id="par_idN10A2E" xml-lang="en-US" l10n="NEW"> <embedvar href="text/scalc/00/00000004.xhp#optional"/> </paragraph> <paragraph role="heading" id="hd_id3145264" xml-lang="en-US" level="3" l10n="U" oldref="55">Example</paragraph> -<paragraph role="paragraph" id="par_id3159112" xml-lang="en-US" l10n="U" oldref="56">=INDEX(Prices;4;1) returns the value from row 4 and column 1 of the database range defined in <emph>Data - Define</emph> as <emph>Prices</emph>.</paragraph> -<paragraph role="paragraph" id="par_id3150691" xml-lang="en-US" l10n="U" oldref="57">=INDEX(SumX;4;1) returns the value from the range <emph>SumX</emph> in row 4 and column 1 as defined in <emph>Insert - Names - Define</emph>.</paragraph> -<paragraph role="paragraph" id="par_id3158419" xml-lang="en-US" l10n="U" oldref="58">=INDEX((multi);4;1) indicates the value contained in row 4 and column 1 of the (multiple) range, which you named under <emph>Insert - Names - Set</emph> as <emph>multi</emph>. The multiple range may consist of several rectangular ranges, each with a row 4 and column 1. If you now want to call the second block of this multiple range enter the number 2 as the <emph>range</emph> parameter.</paragraph> -<paragraph role="paragraph" id="par_id3148595" xml-lang="en-US" l10n="U" oldref="59">=INDEX(A1:B6;1;1) indicates the value in the upper-left of the A1:B6 range.</paragraph> +<paragraph role="paragraph" id="par_id3159112" xml-lang="en-US" l10n="U" oldref="56"> +<item type="input">=INDEX(Prices;4;1)</item> returns the value from row 4 and column 1 of the database range defined in <emph>Data - Define</emph> as <emph>Prices</emph>.</paragraph> +<paragraph role="paragraph" id="par_id3150691" xml-lang="en-US" l10n="U" oldref="57"> +<item type="input">=INDEX(SumX;4;1)</item> returns the value from the range <emph>SumX</emph> in row 4 and column 1 as defined in <emph>Insert - Names - Define</emph>.</paragraph> +<paragraph role="paragraph" id="par_id4109012" xml-lang="en-US" l10n="NEW"> +<item type="input">=INDEX(A1:B6;1)</item> returns a reference to the first row of A1:B6.</paragraph> +<paragraph role="paragraph" id="par_id9272133" xml-lang="en-US" l10n="NEW"> +<item type="input">=INDEX(A1:B6;0;1)</item> returns a reference to the first column of A1:B6.</paragraph> +<paragraph role="paragraph" id="par_id3158419" xml-lang="en-US" l10n="U" oldref="58"> +<item type="input">=INDEX((multi);4;1)</item> indicates the value contained in row 4 and column 1 of the (multiple) range, which you named under <emph>Insert - Names - Set</emph> as <emph>multi</emph>. The multiple range may consist of several rectangular ranges, each with a row 4 and column 1. If you now want to call the second block of this multiple range enter the number <item type="input">2</item> as the <emph>range</emph> parameter.</paragraph> +<paragraph role="paragraph" id="par_id3148595" xml-lang="en-US" l10n="U" oldref="59"> +<item type="input">=INDEX(A1:B6;1;1)</item> indicates the value in the upper-left of the A1:B6 range.</paragraph> +<paragraph role="paragraph" id="par_id9960020" xml-lang="en-US" l10n="NEW"> +<item type="input">=INDEX((multi);0;0;2)</item> returns a reference to the second range of the multiple range.</paragraph> </section> <section id="Section6"> <bookmark xml-lang="en-US" branch="index" id="bm_id3153181"><bookmark_value>INDIRECT function</bookmark_value> @@ -192,13 +205,16 @@ <bookmark xml-lang="en-US" branch="hid/HID_FUNC_INDIREKT" id="bm_id3153922" localize="false"/><paragraph role="heading" id="hd_id3153181" xml-lang="en-US" level="2" l10n="U" oldref="62">INDIRECT</paragraph> <paragraph role="paragraph" id="par_id3147169" xml-lang="en-US" l10n="U" oldref="63"><ahelp hid="HID_FUNC_INDIREKT">Returns the <emph>reference</emph> specified by a text string.</ahelp> This function can also be used to return the area of a corresponding string.</paragraph> <paragraph role="heading" id="hd_id3153717" xml-lang="en-US" level="3" l10n="U" oldref="64">Syntax</paragraph> -<paragraph role="code" id="par_id3149824" xml-lang="en-US" l10n="U" oldref="65">INDIRECT(ref)</paragraph> +<paragraph role="code" id="par_id3149824" xml-lang="en-US" l10n="U" oldref="65">INDIRECT(Ref)</paragraph> <paragraph role="paragraph" id="par_id3154317" xml-lang="en-US" l10n="U" oldref="66"> -<emph>ref</emph> represents a reference to a cell or an area (in text form) for which to return the contents.</paragraph> +<emph>Ref</emph> represents a reference to a cell or an area (in text form) for which to return the contents.</paragraph> <paragraph role="note" id="par_idN10CAE" xml-lang="en-US" l10n="NEW">If you open an Excel spreadsheet that uses indirect addresses calculated from string functions, the sheet addresses will not be translated automatically. For example, the Excel address in INDIRECT("filename!sheetname"&B1) is not converted into the Calc address in INDIRECT("filename.sheetname"&B1).<comment>UFI: for #i34465#</comment></paragraph> +<paragraph role="note" id="par_id7687917" xml-lang="en-US" l10n="NEW">INDIRECT cannot resolve range names as in INDIRECT("RangeName").<comment>i83070</comment></paragraph> <paragraph role="heading" id="hd_id3150389" xml-lang="en-US" level="3" l10n="U" oldref="67">Example</paragraph> -<paragraph role="paragraph" id="par_id3150608" xml-lang="en-US" l10n="U" oldref="68">=INDIRECT(A1) equals 100 if A1 contains C108 as a reference and cell C108 contains a value of 100.</paragraph> -<paragraph role="paragraph" id="par_id3083286" xml-lang="en-US" l10n="U" oldref="181">=SUM(INDIRECT("a1:" & ADDRESS(1;3))) totals the cells in the area of A1 up to the cell, whose address is defined by row 1 and column 3. Therefore, area A1:C1 is totaled.</paragraph> +<paragraph role="paragraph" id="par_id3150608" xml-lang="en-US" l10n="U" oldref="68"> +<item type="input">=INDIRECT(A1)</item> equals 100 if A1 contains C108 as a reference and cell C108 contains a value of <item type="input">100</item>.</paragraph> +<paragraph role="paragraph" id="par_id3083286" xml-lang="en-US" l10n="CHG" oldref="181"> +<item type="input">=SUM(INDIRECT("a1:" & ADDRESS(1;3)))</item> totals the cells in the area of A1 up to the cell with the address defined by row 1 and column 3. This means that area A1:C1 is totaled.</paragraph> </section> <section id="Section21"> <bookmark xml-lang="en-US" branch="index" id="bm_id3691824"><bookmark_value>INFO function</bookmark_value> @@ -206,12 +222,12 @@ <bookmark xml-lang="en-US" branch="hid/HID_FUNC_INFO" id="bm_id5369426" localize="false"/><paragraph role="heading" id="hd_id5787224" xml-lang="en-US" level="2" l10n="NEW">INFO</paragraph> <paragraph role="paragraph" id="par_id1507309" xml-lang="en-US" l10n="NEW">Returns specific information about the current working environment. The function receives a single text argument and returns data depending on that parameter.</paragraph> <paragraph role="heading" id="hd_id7693411" xml-lang="en-US" level="3" l10n="NEW">Syntax</paragraph> -<paragraph role="code" id="par_id3928952" xml-lang="en-US" l10n="NEW">INFO(type)</paragraph> -<paragraph role="paragraph" id="par_id5206762" xml-lang="en-US" l10n="NEW">The following table lists the values for the text parameter <item type="literal">type</item> and the return values of the INFO function.</paragraph> +<paragraph role="code" id="par_id3928952" xml-lang="en-US" l10n="NEW">INFO("Type")</paragraph> +<paragraph role="paragraph" id="par_id5206762" xml-lang="en-US" l10n="NEW">The following table lists the values for the text parameter "<item type="literal">Type"</item> and the return values of the INFO function.</paragraph> <table id="tbl_id1342204"> <tablerow> <tablecell colspan="" rowspan=""> -<paragraph role="tablehead" id="par_id5735953" xml-lang="en-US" l10n="NEW">Value for "type"<comment>Do not translate the text values in this column below</comment></paragraph> +<paragraph role="tablehead" id="par_id5735953" xml-lang="en-US" l10n="NEW">Value for "Type"<comment>Do not translate the text values in this column below</comment></paragraph> </tablecell> <tablecell colspan="" rowspan=""> <paragraph role="tablehead" id="par_id8360850" xml-lang="en-US" l10n="NEW">Return value</paragraph> @@ -258,10 +274,12 @@ </tablecell> </tablerow> </table> -<paragraph role="note" id="par_id1161534" xml-lang="en-US" l10n="NEW">Other spreadsheet applications may accept localized values for the "type" parameter, but %PRODUCTNAME Calc will only accept the English values.</paragraph> +<paragraph role="note" id="par_id1161534" xml-lang="en-US" l10n="NEW">Other spreadsheet applications may accept localized values for the <item type="literal">Type</item> parameter, but %PRODUCTNAME Calc will only accept the English values.</paragraph> <paragraph role="heading" id="hd_id5459456" xml-lang="en-US" level="3" l10n="NEW">Example</paragraph> -<paragraph role="paragraph" id="par_id3994567" xml-lang="en-US" l10n="NEW">=INFO("release") returns the product release number of the %PRODUCTNAME in use.<comment>Do not translate "release"</comment></paragraph> -<paragraph role="paragraph" id="par_id2873622" xml-lang="en-US" l10n="NEW">=INFO(D5) with cell D5 containing a text string <item type="literal">system</item> returns the operation system type.<comment>Do not translate the hlp_literal system</comment></paragraph> +<paragraph role="paragraph" id="par_id3994567" xml-lang="en-US" l10n="NEW"> +<item type="input">=INFO("release")</item> returns the product release number of the %PRODUCTNAME in use.<comment>Do not translate "release"</comment></paragraph> +<paragraph role="paragraph" id="par_id2873622" xml-lang="en-US" l10n="NEW"> +<item type="input">=INFO(D5)</item> with cell D5 containing a text string <item type="input">system</item> returns the operation system type.<comment>Do not translate the hlp_literal system</comment></paragraph> </section> <section id="Section7"> <bookmark xml-lang="en-US" branch="index" id="bm_id3154818"><bookmark_value>COLUMN function</bookmark_value> @@ -269,17 +287,23 @@ <bookmark xml-lang="en-US" branch="hid/HID_FUNC_SPALTE" id="bm_id3156378" localize="false"/><paragraph role="heading" id="hd_id3154818" xml-lang="en-US" level="2" l10n="U" oldref="70">COLUMN</paragraph> <paragraph role="paragraph" id="par_id3149711" xml-lang="en-US" l10n="U" oldref="193"><ahelp hid="HID_FUNC_SPALTE">Returns the column number of a cell reference.</ahelp> If the reference is a cell the column number of the cell is returned; if the parameter is a cell area, the corresponding column numbers are returned in a single-row <link href="text/scalc/01/04060107.xhp#wasmatrix" name="array">array</link> if the formula is entered <link href="text/scalc/01/04060107.xhp#somatrixformel" name="as an array formula">as an array formula</link>. If the COLUMN function with an area reference parameter is not used for an array formula, only the column number of the first cell within the area is determined.</paragraph> <paragraph role="heading" id="hd_id3149283" xml-lang="en-US" level="3" l10n="U" oldref="72">Syntax</paragraph> -<paragraph role="code" id="par_id3149447" xml-lang="en-US" l10n="U" oldref="73">COLUMN(reference)</paragraph> +<paragraph role="code" id="par_id3149447" xml-lang="en-US" l10n="U" oldref="73">COLUMN(Reference)</paragraph> <paragraph role="paragraph" id="par_id3156310" xml-lang="en-US" l10n="U" oldref="74"> <emph>Reference</emph> is the reference to a cell or cell area whose first column number is to be found.</paragraph> <paragraph role="paragraph" id="par_id3155837" xml-lang="en-US" l10n="U" oldref="194">If no reference is entered, the column number of the cell in which the formula is entered is found. <item type="productname">%PRODUCTNAME</item> Calc automatically sets the reference to the current cell.</paragraph> <paragraph role="heading" id="hd_id3152932" xml-lang="en-US" level="3" l10n="U" oldref="75">Example</paragraph> -<paragraph role="paragraph" id="par_id3147571" xml-lang="en-US" l10n="U" oldref="76">=COLUMN(A1) equals 1. Column A is the first column in the table.</paragraph> -<paragraph role="paragraph" id="par_id3147079" xml-lang="en-US" l10n="U" oldref="77">=COLUMN(C3:E3) equals 3. Column C is the third column in the table.</paragraph> -<paragraph role="paragraph" id="par_id3146861" xml-lang="en-US" l10n="U" oldref="195">=COLUMN(D3:G10) returns 4 because column D is the fourth column in the table and the COLUMN function is not used as an array formula. (In this case, the first value of the array is always used as the result.)</paragraph> -<paragraph role="paragraph" id="par_id3156320" xml-lang="en-US" l10n="U" oldref="196">{=COLUMN(B2:B7)} and =COLUMN(B2:B7) both return 2 because the reference only contains column B as the second column in the table. Because single-column areas have only one column number, it does not make a difference whether or not the formula is used as an array formula.</paragraph> -<paragraph role="paragraph" id="par_id3150872" xml-lang="en-US" l10n="U" oldref="197">=COLUMN() returns 3 if the formula was entered in column C.</paragraph> -<paragraph role="paragraph" id="par_id3153277" xml-lang="en-US" l10n="U" oldref="198">{=COLUMN(Rabbit)} returns the single-row array (3, 4) if "Rabbit" is the named area (C1:D3).</paragraph> +<paragraph role="paragraph" id="par_id3147571" xml-lang="en-US" l10n="U" oldref="76"> +<item type="input">=COLUMN(A1)</item> equals 1. Column A is the first column in the table.</paragraph> +<paragraph role="paragraph" id="par_id3147079" xml-lang="en-US" l10n="U" oldref="77"> +<item type="input">=COLUMN(C3:E3)</item> equals 3. Column C is the third column in the table.</paragraph> +<paragraph role="paragraph" id="par_id3146861" xml-lang="en-US" l10n="U" oldref="195"> +<item type="input">=COLUMN(D3:G10)</item> returns 4 because column D is the fourth column in the table and the COLUMN function is not used as an array formula. (In this case, the first value of the array is always used as the result.)</paragraph> +<paragraph role="paragraph" id="par_id3156320" xml-lang="en-US" l10n="U" oldref="196"> +<item type="input">{=COLUMN(B2:B7)}</item> and <item type="input">=COLUMN(B2:B7)</item> both return 2 because the reference only contains column B as the second column in the table. Because single-column areas have only one column number, it does not make a difference whether or not the formula is used as an array formula.</paragraph> +<paragraph role="paragraph" id="par_id3150872" xml-lang="en-US" l10n="U" oldref="197"> +<item type="input">=COLUMN()</item> returns 3 if the formula was entered in column C.</paragraph> +<paragraph role="paragraph" id="par_id3153277" xml-lang="en-US" l10n="U" oldref="198"> +<item type="input">{=COLUMN(Rabbit)}</item> returns the single-row array (3, 4) if "Rabbit" is the named area (C1:D3).</paragraph> </section> <section id="Section8"> <bookmark xml-lang="en-US" branch="index" id="bm_id3154643"><bookmark_value>COLUMNS function</bookmark_value> @@ -287,35 +311,40 @@ <bookmark xml-lang="en-US" branch="hid/HID_FUNC_SPALTEN" id="bm_id3156134" localize="false"/><paragraph role="heading" id="hd_id3154643" xml-lang="en-US" level="2" l10n="U" oldref="79">COLUMNS</paragraph> <paragraph role="paragraph" id="par_id3151182" xml-lang="en-US" l10n="U" oldref="80"><ahelp hid="HID_FUNC_SPALTEN">Returns the number of columns in the given reference.</ahelp></paragraph> <paragraph role="heading" id="hd_id3149141" xml-lang="en-US" level="3" l10n="U" oldref="81">Syntax</paragraph> -<paragraph role="code" id="par_id3154047" xml-lang="en-US" l10n="U" oldref="82">COLUMNS(array)</paragraph> +<paragraph role="code" id="par_id3154047" xml-lang="en-US" l10n="U" oldref="82">COLUMNS(Array)</paragraph> <paragraph role="paragraph" id="par_id3154745" xml-lang="en-US" l10n="U" oldref="83"> -<emph>array</emph> is the reference to a cell range whose total number of columns is to be found. The argument can also be a single cell.</paragraph> +<emph>Array</emph> is the reference to a cell range whose total number of columns is to be found. The argument can also be a single cell.</paragraph> <paragraph role="heading" id="hd_id3153622" xml-lang="en-US" level="3" l10n="U" oldref="84">Example</paragraph> -<paragraph role="paragraph" id="par_id3149577" xml-lang="en-US" l10n="U" oldref="200">=COLUMNS(B5) returns 1 because a cell only contains one column.</paragraph> -<paragraph role="paragraph" id="par_id3145649" xml-lang="en-US" l10n="U" oldref="85">=COLUMNS(A1:C5) equals 3. The reference comprises three columns.</paragraph> -<paragraph role="paragraph" id="par_id3155846" xml-lang="en-US" l10n="U" oldref="201">=COLUMNS(Rabbit) returns 2 if "Rabbit" is the named range (C1:D3).</paragraph> +<paragraph role="paragraph" id="par_id3149577" xml-lang="en-US" l10n="U" oldref="200"> +<item type="input">=COLUMNS(B5)</item> returns 1 because a cell only contains one column.</paragraph> +<paragraph role="paragraph" id="par_id3145649" xml-lang="en-US" l10n="U" oldref="85"> +<item type="input">=COLUMNS(A1:C5)</item> equals 3. The reference comprises three columns.</paragraph> +<paragraph role="paragraph" id="par_id3155846" xml-lang="en-US" l10n="U" oldref="201"> +<item type="input">=COLUMNS(Rabbit)</item> returns 2 if <item type="literal">Rabbit</item> is the named range (C1:D3).</paragraph> </section> <section id="Section9"> <bookmark xml-lang="en-US" branch="index" id="bm_id3153152"><bookmark_value>vertical search function</bookmark_value> <bookmark_value>VLOOKUP function</bookmark_value> </bookmark> <bookmark xml-lang="en-US" branch="hid/HID_FUNC_SVERWEIS" id="bm_id3152809" localize="false"/><paragraph role="heading" id="hd_id3153152" xml-lang="en-US" level="2" l10n="U" oldref="87">VLOOKUP</paragraph> -<paragraph role="paragraph" id="par_id3149984" xml-lang="en-US" l10n="CHG" oldref="88"><ahelp hid="HID_FUNC_SVERWEIS">Vertical search with reference to adjacent cells to the right.</ahelp> This function checks if a specific value is contained in the first column of an array. The function then returns the value in the same row of the column named by <emph>index</emph>. If the <emph>Sort order</emph> parameter is omitted or set to TRUE, it is assumed that the data is sorted in ascending order. In this case, if the exact <emph>search criterion</emph> is not found, the last value that is smaller than the criterion will be returned. If <emph>Sort order</emph> is set to FALSE or zero, an exact match must be found, otherwise the error <emph>Error: Value Not Available</emph> will be the result. Thus with a value of zero the data does not need to be sorted in ascending order.</paragraph> +<paragraph role="paragraph" id="par_id3149984" xml-lang="en-US" l10n="CHG" oldref="88"><ahelp hid="HID_FUNC_SVERWEIS">Vertical search with reference to adjacent cells to the right.</ahelp> This function checks if a specific value is contained in the first column of an array. The function then returns the value in the same row of the column named by <item type="literal">Index</item>. If the <item type="literal">SortOrder</item> parameter is omitted or set to TRUE or one, it is assumed that the data is sorted in ascending order. In this case, if the exact <item type="literal">SearchCriterion</item> is not found, the last value that is smaller than the criterion will be returned. If <item type="literal">SortOrder</item> is set to FALSE or zero, an exact match must be found, otherwise the error <emph>Error: Value Not Available</emph> will be the result. Thus with a value of zero the data does not need to be sorted in ascending order.</paragraph> <embed href="text/shared/00/00000001.xhp#regulaer"/> <paragraph role="heading" id="hd_id3146898" xml-lang="en-US" level="3" l10n="U" oldref="89">Syntax</paragraph> -<paragraph role="code" id="par_id3150156" xml-lang="en-US" l10n="U" oldref="90">=VLOOKUP(Search criterion;array;index;Sort order)</paragraph> +<paragraph role="code" id="par_id3150156" xml-lang="en-US" l10n="U" oldref="90">=VLOOKUP(SearchCriterion; Array; Index; SortOrder)</paragraph> <paragraph role="paragraph" id="par_id3149289" xml-lang="en-US" l10n="U" oldref="91"> -<emph>Search criterion</emph> is the value searched for in the first column of the array.</paragraph> +<emph>SearchCriterion</emph> is the value searched for in the first column of the array.</paragraph> <paragraph role="paragraph" id="par_id3153884" xml-lang="en-US" l10n="U" oldref="92"> -<emph>array</emph> is the reference, which is to comprise at least two columns.</paragraph> +<emph>Array</emph> is the reference, which is to comprise at least two columns.</paragraph> <paragraph role="paragraph" id="par_id3156005" xml-lang="en-US" l10n="U" oldref="93"> -<emph>index</emph> is the number of the column in the array that contains the value to be returned. The first column has the number 1.</paragraph> +<emph>Index</emph> is the number of the column in the array that contains the value to be returned. The first column has the number 1.</paragraph> <paragraph role="paragraph" id="par_id3151208" xml-lang="en-US" l10n="U" oldref="94"> -<emph>Sort order</emph> is an optional parameter that indicates whether the first column in the array is sorted in ascending order. Enter the Boolean value FALSE if the first column is not sorted in ascending order. Sorted columns can be searched much faster and the function always returns a value, even if the search value was not matched exactly, if it is between the lowest and highest value of the sorted list. In unsorted lists, the search value must be matched exactly. Otherwise the function will return this message: <emph>Error: Value Not Available</emph>.</paragraph> +<emph>SortOrder</emph> is an optional parameter that indicates whether the first column in the array is sorted in ascending order. Enter the Boolean value FALSE or zero if the first column is not sorted in ascending order. Sorted columns can be searched much faster and the function always returns a value, even if the search value was not matched exactly, if it is between the lowest and highest value of the sorted list. In unsorted lists, the search value must be matched exactly. Otherwise the function will return this message: <emph>Error: Value Not Available</emph>.</paragraph> <paragraph role="heading" id="hd_id3147487" xml-lang="en-US" level="3" l10n="U" oldref="95">Example</paragraph> -<paragraph role="paragraph" id="par_id3154129" xml-lang="en-US" l10n="U" oldref="96">You want to enter the number of a dish on the menu in cell A1, and the name of the dish is to appear as text in the neighboring cell (B1) immediately. The Number to Name assignment is contained in the D1:E100 array. D1 contains 100, E1 contains the name <emph>Vegetable Soup</emph>, and so forth, for 100 menu items. The numbers in column D are sorted in ascending order; thus, the optional <emph>Sort order</emph> parameter is not necessary.</paragraph> +<paragraph role="paragraph" id="par_id3154129" xml-lang="en-US" l10n="U" oldref="96">You want to enter the number of a dish on the menu in cell A1, and the name of the dish is to appear as text in the neighboring cell (B1) immediately. The Number to Name assignment is contained in the D1:E100 array. D1 contains <item type="input">100</item>, E1 contains the name <item type="input">Vegetable Soup</item>, and so forth, for 100 menu items. The numbers in column D are sorted in ascending order; thus, the optional <item type="literal">SortOrder</item> parameter is not necessary.</paragraph> <paragraph role="paragraph" id="par_id3145663" xml-lang="en-US" l10n="U" oldref="97">Enter the following formula in B1:</paragraph> -<paragraph role="paragraph" id="par_id3151172" xml-lang="en-US" l10n="U" oldref="98">=VLOOKUP(A1; D1:E100; 2)</paragraph> +<paragraph role="paragraph" id="par_id3151172" xml-lang="en-US" l10n="U" oldref="98"> +<item type="input">=VLOOKUP(A1;D1:E100;2)</item> +</paragraph> <paragraph role="paragraph" id="par_id3149200" xml-lang="en-US" l10n="U" oldref="99">As soon as you enter a number in A1 B1 will show the corresponding text contained in the second column of reference D1:E100. Entering a nonexistent number displays the text with the next number down. To prevent this, enter FALSE as the last parameter in the formula so that an error message is generated when a nonexistent number is entered.</paragraph> </section> <section id="Section10"> @@ -329,7 +358,8 @@ <paragraph role="paragraph" id="par_id3154588" xml-lang="en-US" l10n="U" oldref="219"> <emph>Reference</emph> is optional and is the reference to a cell, an area, or a sheet name string.</paragraph> <paragraph role="heading" id="hd_id3155399" xml-lang="en-US" level="3" l10n="U" oldref="220">Example</paragraph> -<paragraph role="paragraph" id="par_id3146988" xml-lang="en-US" l10n="U" oldref="221">=SHEET(Sheet2.A1) returns 2 if Sheet2 is the second sheet in the spreadsheet document.</paragraph> +<paragraph role="paragraph" id="par_id3146988" xml-lang="en-US" l10n="U" oldref="221"> +<item type="input">=SHEET(Sheet2.A1)</item> returns 2 if Sheet2 is the second sheet in the spreadsheet document.</paragraph> </section> <section id="Section11"> <bookmark xml-lang="en-US" branch="index" id="bm_id3148829"><bookmark_value>number of sheets; function</bookmark_value> @@ -342,7 +372,8 @@ <paragraph role="paragraph" id="par_id3153060" xml-lang="en-US" l10n="U" oldref="226"> <emph>Reference</emph> is the reference to a sheet or an area. This parameter is optional.</paragraph> <paragraph role="heading" id="hd_id3149766" xml-lang="en-US" level="3" l10n="U" oldref="227">Example</paragraph> -<paragraph role="paragraph" id="par_id3150507" xml-lang="en-US" l10n="U" oldref="228">=SHEETS(Sheet1.A1:Sheet3.G12) returns 3 if Sheet1, Sheet2, and Sheet3 exist in the sequence indicated.</paragraph> +<paragraph role="paragraph" id="par_id3150507" xml-lang="en-US" l10n="U" oldref="228"> +<item type="input">=SHEETS(Sheet1.A1:Sheet3.G12)</item> returns 3 if Sheet1, Sheet2, and Sheet3 exist in the sequence indicated.</paragraph> </section> <section id="Section12"> <bookmark xml-lang="en-US" branch="index" id="bm_id3158407"><bookmark_value>MATCH function</bookmark_value> @@ -350,18 +381,19 @@ <bookmark xml-lang="en-US" branch="hid/HID_FUNC_VERGLEICH" id="bm_id3154210" localize="false"/><paragraph role="heading" id="hd_id3158407" xml-lang="en-US" level="2" l10n="U" oldref="101">MATCH</paragraph> <paragraph role="paragraph" id="par_id3154896" xml-lang="en-US" l10n="U" oldref="102"><ahelp hid="HID_FUNC_VERGLEICH">Returns the relative position of an item in an array that matches a specified value.</ahelp> The function returns the position of the value found in the lookup_array as a number.</paragraph> <paragraph role="heading" id="hd_id3153834" xml-lang="en-US" level="3" l10n="U" oldref="103">Syntax</paragraph> -<paragraph role="code" id="par_id3159152" xml-lang="en-US" l10n="U" oldref="104">MATCH(search criterion;lookup_array;type)</paragraph> +<paragraph role="code" id="par_id3159152" xml-lang="en-US" l10n="U" oldref="104">MATCH(SearchCriterion; LookupArray; Type)</paragraph> <paragraph role="paragraph" id="par_id3149336" xml-lang="en-US" l10n="U" oldref="105"> -<emph>Search Criterion</emph> is the value which is to be searched for in the single-row or single-column array.</paragraph> +<emph>SearchCriterion</emph> is the value which is to be searched for in the single-row or single-column array.</paragraph> <paragraph role="paragraph" id="par_id3159167" xml-lang="en-US" l10n="U" oldref="106"> -<emph>lookup_array</emph> is the reference searched. A lookup array can be a single row or column, or part of a single row or column.</paragraph> +<emph>LookupArray</emph> is the reference searched. A lookup array can be a single row or column, or part of a single row or column.</paragraph> <paragraph role="paragraph" id="par_id3147239" xml-lang="en-US" l10n="U" oldref="107"> <emph>Type</emph> may take the values 1, 0, or -1. If Type = 1 or if this optional parameter is missing, it is assumed that the first column of the search array is sorted in ascending order. If Type = -1 it is assumed that the column in sorted in descending order. This corresponds to the same function in Microsoft Excel.</paragraph> -<paragraph role="paragraph" id="par_id3154265" xml-lang="en-US" l10n="U" oldref="231">If Type = 0, only exact matches are found. If the search criterion is found more than once, the function returns the first one found. Only if Type = 0 can you search for regular expressions.</paragraph> -<paragraph role="paragraph" id="par_id3147528" xml-lang="en-US" l10n="U" oldref="232">If Type = 1 or the third parameter is missing, the last value that is smaller or equal to the search criterion is returned. This applies even when the search array is not sorted. For Type = -1, the first value that is larger or equal is returned.</paragraph> +<paragraph role="paragraph" id="par_id3154265" xml-lang="en-US" l10n="CHG" oldref="231">If Type = 0, only exact matches are found. If the search criterion is found more than once, the function returns the index of the first matching value. Only if Type = 0 can you search for regular expressions.</paragraph> +<paragraph role="paragraph" id="par_id3147528" xml-lang="en-US" l10n="CHG" oldref="232">If Type = 1 or the third parameter is missing, the index of the last value that is smaller or equal to the search criterion is returned. This applies even when the search array is not sorted. For Type = -1, the first value that is larger or equal is returned.</paragraph> <embed href="text/shared/00/00000001.xhp#regulaer"/> <paragraph role="heading" id="hd_id3155119" xml-lang="en-US" level="3" l10n="U" oldref="108">Example</paragraph> -<paragraph role="paragraph" id="par_id3155343" xml-lang="en-US" l10n="U" oldref="109">=MATCH(200; D1:D100) searches the area D1:D100, which is sorted by column D, for the value 200. As soon as this value is reached, the number of the row in which it was found is returned. If a higher value is found during the search in the column, the number of the previous row is returned.</paragraph> +<paragraph role="paragraph" id="par_id3155343" xml-lang="en-US" l10n="U" oldref="109"> +<item type="input">=MATCH(200;D1:D100)</item> searches the area D1:D100, which is sorted by column D, for the value 200. As soon as this value is reached, the number of the row in which it was found is returned. If a higher value is found during the search in the column, the number of the previous row is returned.</paragraph> </section> <section id="Section13"> <bookmark xml-lang="en-US" branch="index" id="bm_id3158430"><bookmark_value>OFFSET function</bookmark_value> @@ -369,41 +401,54 @@ <bookmark xml-lang="en-US" branch="hid/HID_FUNC_VERSCHIEBUNG" id="bm_id3148926" localize="false"/><paragraph role="heading" id="hd_id3158430" xml-lang="en-US" level="2" l10n="U" oldref="111">OFFSET</paragraph> <paragraph role="paragraph" id="par_id3149167" xml-lang="en-US" l10n="U" oldref="112"><ahelp hid="HID_FUNC_VERSCHIEBUNG">Returns the value of a cell offset by a certain number of rows and columns from a given reference point.</ahelp></paragraph> <paragraph role="heading" id="hd_id3146952" xml-lang="en-US" level="3" l10n="U" oldref="113">Syntax</paragraph> -<paragraph role="code" id="par_id3159194" xml-lang="en-US" l10n="U" oldref="114">OFFSET(reference;rows;columns;height;width)</paragraph> -<paragraph role="paragraph" id="par_id3152360" xml-lang="en-US" l10n="U" oldref="115"> -<emph>Reference</emph> is the cell from which the function searches for the new reference.</paragraph> -<paragraph role="paragraph" id="par_id3156032" xml-lang="en-US" l10n="U" oldref="116"> -<emph>Rows</emph> is the number of cells by which the reference was corrected up (negative value) or down.</paragraph> -<paragraph role="paragraph" id="par_id3166458" xml-lang="en-US" l10n="U" oldref="117"> -<emph>Columns</emph> is the number of columns by which the reference was corrected to the left (negative value) or to the right.</paragraph> -<paragraph role="paragraph" id="par_id3150708" xml-lang="en-US" l10n="U" oldref="118"> -<emph>Height</emph> is the optional vertical height for an area that starts at the new reference position.</paragraph> -<paragraph role="paragraph" id="par_id3147278" xml-lang="en-US" l10n="U" oldref="119"> -<emph>Width</emph> is the optional horizontal width for an area that starts at the new reference position.</paragraph> +<paragraph role="code" id="par_id3159194" xml-lang="en-US" l10n="U" oldref="114">OFFSET(Reference; Rows; Columns; Height; Width)</paragraph> +<paragraph role="paragraph" id="par_id3152360" xml-lang="en-US" l10n="CHG" oldref="115"> +<emph>Reference</emph> is the reference from which the function searches for the new reference.</paragraph> +<paragraph role="paragraph" id="par_id3156032" xml-lang="en-US" l10n="CHG" oldref="116"> +<emph>Rows</emph> is the number of rows by which the reference was corrected up (negative value) or down.</paragraph> +<paragraph role="paragraph" id="par_id3166458" xml-lang="en-US" l10n="CHG" oldref="117"> +<emph>Columns</emph> (optional) is the number of columns by which the reference was corrected to the left (negative value) or to the right.</paragraph> +<paragraph role="paragraph" id="par_id3150708" xml-lang="en-US" l10n="CHG" oldref="118"> +<emph>Height</emph> (optional) is the vertical height for an area that starts at the new reference position.</paragraph> +<paragraph role="paragraph" id="par_id3147278" xml-lang="en-US" l10n="CHG" oldref="119"> +<emph>Width</emph> (optional) is the horizontal width for an area that starts at the new reference position.</paragraph> +<paragraph role="paragraph" id="par_id8662373" xml-lang="en-US" l10n="NEW">Arguments <emph>Rows</emph> and <emph>Columns</emph> must not lead to zero or negative start row or column</paragraph> +<paragraph role="paragraph" id="par_id9051484" xml-lang="en-US" l10n="NEW">Arguments <emph>Height</emph> and <emph>Width</emph> must not lead to zero or negative count of rows or columns.</paragraph> <paragraph role="paragraph" id="par_idN1104B" xml-lang="en-US" l10n="NEW"> <embedvar href="text/scalc/00/00000004.xhp#optional"/> </paragraph> <paragraph role="heading" id="hd_id3155586" xml-lang="en-US" level="3" l10n="U" oldref="120">Example</paragraph> -<paragraph role="paragraph" id="par_id3149744" xml-lang="en-US" l10n="CHG" oldref="121">=OFFSET(A1; 2; 2) returns the value in cell C3 (A1 moved by two rows and two columns down). If C3 contains the value 100 this function returns the value 100.</paragraph> -<paragraph role="paragraph" id="par_id3153739" xml-lang="en-US" l10n="U" oldref="122">=SUM(OFFSET(A1; 2; 2; 5; 6)) determines the total of the area that starts in cell C3 and has a height of 5 rows and a width of 6 columns (area=C3:H7).</paragraph> +<paragraph role="paragraph" id="par_id3149744" xml-lang="en-US" l10n="CHG" oldref="121"> +<item type="input">=OFFSET(A1;2;2)</item> returns the value in cell C3 (A1 moved by two rows and two columns down). If C3 contains the value <item type="input">100</item> this function returns the value 100.</paragraph> +<paragraph role="paragraph" id="par_id7439802" xml-lang="en-US" l10n="NEW"> +<item type="input">=OFFSET(B2:C3;1;1)</item> returns a reference to B2:C3 moved down by 1 row and one column to the right (C3:D4).</paragraph> +<paragraph role="paragraph" id="par_id3009430" xml-lang="en-US" l10n="NEW"> +<item type="input">=OFFSET(B2:C3;-1;-1)</item> returns a reference to B2:C3 moved up by 1 row and one column to the left (A1:B2).</paragraph> +<paragraph role="paragraph" id="par_id2629169" xml-lang="en-US" l10n="NEW"> +<item type="input">=OFFSET(B2:C3;0;0;3;4)</item> returns a reference to B2:C3 resized to 3 rows and 4 columns (B2:E4).</paragraph> +<paragraph role="paragraph" id="par_id6668599" xml-lang="en-US" l10n="NEW"> +<item type="input">=OFFSET(B2:C3;1;0;3;4)</item> returns a reference to B2:C3 moved down by one row resized to 3 rows and 4 columns (B2:E4).</paragraph> +<paragraph role="paragraph" id="par_id3153739" xml-lang="en-US" l10n="U" oldref="122"> +<item type="input">=SUM(OFFSET(A1;2;2;5;6))</item> determines the total of the area that starts in cell C3 and has a height of 5 rows and a width of 6 columns (area=C3:H7).</paragraph> </section> <section id="Section14"> <bookmark xml-lang="en-US" branch="index" id="bm_id3159273"><bookmark_value>LOOKUP function</bookmark_value> </bookmark> <bookmark xml-lang="en-US" branch="hid/HID_FUNC_VERWEIS" id="bm_id3152877" localize="false"/><paragraph role="heading" id="hd_id3159273" xml-lang="en-US" level="2" l10n="U" oldref="123">LOOKUP</paragraph> -<paragraph role="paragraph" id="par_id3153389" xml-lang="en-US" l10n="CHG" oldref="124"><ahelp hid="HID_FUNC_VERWEIS">Returns the contents of a cell either from a one-row or one-column range.</ahelp> Optionally, the assigned value (of the same index) is returned in a different column and row. As opposed to <link href="text/scalc/01/04060109.xhp" name="VLOOKUP">VLOOKUP</link> and <link href="text/scalc/01/04060109.xhp" name="HLOOKUP">HLOOKUP</link>, search and result vector may be at different positions; they do not have to be adjacent. Additionally, the search vector for the LOOKUP must be sorted, otherwise the search will not return any usable results.</paragraph> +<paragraph role="paragraph" id="par_id3153389" xml-lang="en-US" l10n="CHG" oldref="124"><ahelp hid="HID_FUNC_VERWEIS">Returns the contents of a cell either from a one-row or one-column range.</ahelp> Optionally, the assigned value (of the same index) is returned in a different column and row. As opposed to <link href="text/scalc/01/04060109.xhp" name="VLOOKUP">VLOOKUP</link> and <link href="text/scalc/01/04060109.xhp" name="HLOOKUP">HLOOKUP</link>, search and result vector may be at different positions; they do not have to be adjacent. Additionally, the search vector for the LOOKUP must be sorted ascending, otherwise the search will not return any usable results.</paragraph> <paragraph role="note" id="par_id4484084" xml-lang="en-US" l10n="NEW">If LOOKUP cannot find the search criterion, it matches the largest value in the search vector that is less than or equal to the search criterion.</paragraph> <embed href="text/shared/00/00000001.xhp#regulaer"/> <paragraph role="heading" id="hd_id3152947" xml-lang="en-US" level="3" l10n="U" oldref="125">Syntax</paragraph> -<paragraph role="code" id="par_id3154104" xml-lang="en-US" l10n="U" oldref="126">LOOKUP(Search criterion;Search vector;result_vector)</paragraph> +<paragraph role="code" id="par_id3154104" xml-lang="en-US" l10n="U" oldref="126">LOOKUP(SearchCriterion; SearchVector; ResultVector)</paragraph> <paragraph role="paragraph" id="par_id3150646" xml-lang="en-US" l10n="U" oldref="127"> -<emph>Search criterion</emph> is the value to be searched for; entered either directly or as a reference.</paragraph> +<emph>SearchCriterion</emph> is the value to be searched for; entered either directly or as a reference.</paragraph> <paragraph role="paragraph" id="par_id3154854" xml-lang="en-US" l10n="U" oldref="128"> -<emph>Search vector</emph> is the single-row or single-column area to be searched.</paragraph> +<emph>SearchVector</emph> is the single-row or single-column area to be searched.</paragraph> <paragraph role="paragraph" id="par_id3149925" xml-lang="en-US" l10n="U" oldref="129"> -<emph>result_vector</emph> is another single-row or single-column range from which the result of the function is taken. The result is the cell of the result vector with the same index as the instance found in the search vector.</paragraph> +<emph>ResultVector</emph> is another single-row or single-column range from which the result of the function is taken. The result is the cell of the result vector with the same index as the instance found in the search vector.</paragraph> <paragraph role="heading" id="hd_id3148624" xml-lang="en-US" level="3" l10n="U" oldref="130">Example</paragraph> -<paragraph role="paragraph" id="par_id3149809" xml-lang="en-US" l10n="U" oldref="131">=LOOKUP(A1; D1:D100;F1:F100) searches the corresponding cell in range D1:D100 for the number you entered in A1. For the instance found, the index is determined, for example, the 12th cell in this range. Then, the contents of the 12th cell are returned as the value of the function (in the result vector).</paragraph> +<paragraph role="paragraph" id="par_id3149809" xml-lang="en-US" l10n="U" oldref="131"> +<item type="input">=LOOKUP(A1;D1:D100;F1:F100)</item> searches the corresponding cell in range D1:D100 for the number you entered in A1. For the instance found, the index is determined, for example, the 12th cell in this range. Then, the contents of the 12th cell are returned as the value of the function (in the result vector).</paragraph> </section> <section id="Section15"> <bookmark xml-lang="en-US" branch="index" id="bm_id3149425"><bookmark_value>STYLE function</bookmark_value> @@ -411,18 +456,24 @@ <bookmark xml-lang="en-US" branch="hid/HID_FUNC_VORLAGE" id="bm_id3154342" localize="false"/><paragraph role="heading" id="hd_id3149425" xml-lang="en-US" level="2" l10n="U" oldref="133">STYLE</paragraph> <paragraph role="paragraph" id="par_id3150826" xml-lang="en-US" l10n="U" oldref="134"><ahelp hid="HID_FUNC_VORLAGE">Applies a style to the cell containing the formula.</ahelp> After a set amount of time, another style can be applied. This function always returns the value 0, allowing you to add it to another function without changing the value. Together with the CURRENT function you can apply a color to a cell regardless of the value. For example: =...+STYLE(IF(CURRENT()>3;"red";"green")) applies the style "red" to the cell if the value is greater than 3, otherwise the style "green" is applied. Both cell formats have to be defined beforehand.</paragraph> <paragraph role="heading" id="hd_id3145373" xml-lang="en-US" level="3" l10n="U" oldref="135">Syntax</paragraph> -<paragraph role="code" id="par_id3149302" xml-lang="en-US" l10n="U" oldref="136">STYLE(style;time;style2)</paragraph> +<paragraph role="code" id="par_id3149302" xml-lang="en-US" l10n="U" oldref="136">STYLE("Style"; Time; "Style2")</paragraph> <paragraph role="paragraph" id="par_id3150596" xml-lang="en-US" l10n="U" oldref="137"> <emph>Style</emph> is the name of a cell style assigned to the cell. Style names must be entered in quotation marks.</paragraph> <paragraph role="paragraph" id="par_id3156149" xml-lang="en-US" l10n="U" oldref="138"> <emph>Time</emph> is an optional time range in seconds. If this parameter is missing the style will not be changed after a certain amount of time has passed.</paragraph> <paragraph role="paragraph" id="par_id3149520" xml-lang="en-US" l10n="U" oldref="139"> -<emph>Style2</emph> is the optional name of a cell style assigned to the cell after a certain amount of time has passed. If this parameter is missing "Standard" is assumed.</paragraph> +<emph>Style2</emph> is the optional name of a cell style assigned to the cell after a certain amount of time has passed. If this parameter is missing "Default" is assumed.</paragraph> <paragraph role="paragraph" id="par_idN111CA" xml-lang="en-US" l10n="NEW"> <embedvar href="text/scalc/00/00000004.xhp#optional"/> </paragraph> <paragraph role="heading" id="hd_id3159254" xml-lang="en-US" level="3" l10n="U" oldref="140">Example</paragraph> -<paragraph role="paragraph" id="par_id3151374" xml-lang="en-US" l10n="U" oldref="141">=STYLE("Invisible";60;"Default") formats the cell in transparent format for 60 seconds after the document was recalculated or loaded, then the Default format is assigned. Both cell formats have to be defined beforehand.</paragraph> +<paragraph role="paragraph" id="par_id3151374" xml-lang="en-US" l10n="U" oldref="141"> +<item type="input">=STYLE("Invisible";60;"Default")</item> formats the cell in transparent format for 60 seconds after the document was recalculated or loaded, then the Default format is assigned. Both cell formats have to be defined beforehand.</paragraph> +<paragraph role="paragraph" id="par_id8056886" xml-lang="en-US" l10n="NEW">Since STYLE() has a numeric return value of zero, this return value gets appended to a string. This can be avoided using T() as in the following example </paragraph> +<paragraph role="paragraph" id="par_id3668935" xml-lang="en-US" l10n="NEW"> +<item type="input">="Text"&T(STYLE("myStyle"))</item> +</paragraph> +<paragraph role="paragraph" id="par_id3042085" xml-lang="en-US" l10n="NEW">See also CURRENT() for another example.</paragraph> </section> <section id="Section16"> <bookmark xml-lang="en-US" branch="index" id="bm_id3150430"><bookmark_value>CHOOSE function</bookmark_value> @@ -430,13 +481,14 @@ <bookmark xml-lang="en-US" branch="hid/HID_FUNC_WAHL" id="bm_id3153947" localize="false"/><paragraph role="heading" id="hd_id3150430" xml-lang="en-US" level="2" l10n="U" oldref="142">CHOOSE</paragraph> <paragraph role="paragraph" id="par_id3143270" xml-lang="en-US" l10n="U" oldref="143"><ahelp hid="HID_FUNC_WAHL">Uses an index to return a value from a list of up to 30 values.</ahelp></paragraph> <paragraph role="heading" id="hd_id3153533" xml-lang="en-US" level="3" l10n="U" oldref="144">Syntax</paragraph> -<paragraph role="code" id="par_id3155425" xml-lang="en-US" l10n="U" oldref="145">CHOOSE(Index; value1;...value30)</paragraph> +<paragraph role="code" id="par_id3155425" xml-lang="en-US" l10n="U" oldref="145">CHOOSE(Index; Value1; ...; Value30)</paragraph> <paragraph role="paragraph" id="par_id3144755" xml-lang="en-US" l10n="U" oldref="146"> <emph>Index</emph> is a reference or number between 1 and 30 indicating which value is to be taken from the list.</paragraph> <paragraph role="paragraph" id="par_id3149939" xml-lang="en-US" l10n="U" oldref="147"> <emph>Value1...Value30</emph> is the list of values entered as a reference to a cell or as individual values.</paragraph> <paragraph role="heading" id="hd_id3151253" xml-lang="en-US" level="3" l10n="U" oldref="148">Example</paragraph> -<paragraph role="paragraph" id="par_id3150625" xml-lang="en-US" l10n="U" oldref="149">=CHOOSE(A1; B1; B2; B3; "Today"; "Yesterday"; "Tomorrow"), for example, returns the contents of cell B2 for A1 = 2; for A1 = 4, the function returns the text "Today".</paragraph> +<paragraph role="paragraph" id="par_id3150625" xml-lang="en-US" l10n="U" oldref="149"> +<item type="input">=CHOOSE(A1;B1;B2;B3;"Today";"Yesterday";"Tomorrow")</item>, for example, returns the contents of cell B2 for A1 = 2; for A1 = 4, the function returns the text "Today".</paragraph> </section> <section id="Section17"> <bookmark xml-lang="en-US" branch="index" id="bm_id3151001"><bookmark_value>HLOOKUP function</bookmark_value> @@ -445,7 +497,7 @@ <paragraph role="paragraph" id="par_id3148688" xml-lang="en-US" l10n="U" oldref="152"><ahelp hid="HID_FUNC_WVERWEIS">Searches for a value and reference to the cells below the selected area.</ahelp> This function verifies if the first row of an array contains a certain value. The function returns then the value in a row of the array, named in the <emph>Index</emph>, in the same column.</paragraph> <embed href="text/shared/00/00000001.xhp#regulaer"/> <paragraph role="heading" id="hd_id3154661" xml-lang="en-US" level="3" l10n="U" oldref="153">Syntax</paragraph> -<paragraph role="code" id="par_id3146070" xml-lang="en-US" l10n="U" oldref="154">=HLOOKUP(search_criteria;array;Index;sorted)</paragraph> +<paragraph role="code" id="par_id3146070" xml-lang="en-US" l10n="U" oldref="154">HLOOKUP(SearchCriteria; Array; Index; Sorted)</paragraph> <paragraph role="paragraph" id="par_id3148672" xml-lang="en-US" l10n="U" oldref="155">See also:<link href="text/scalc/01/04060109.xhp" name="VLOOKUP">VLOOKUP</link> (columns and rows are exchanged)</paragraph> </section> <section id="Section18"> @@ -454,17 +506,23 @@ <bookmark xml-lang="en-US" branch="hid/HID_FUNC_ZEILE" id="bm_id3147333" localize="false"/><paragraph role="heading" id="hd_id3147321" xml-lang="en-US" level="2" l10n="U" oldref="157">ROW</paragraph> <paragraph role="paragraph" id="par_id3154564" xml-lang="en-US" l10n="U" oldref="203"><ahelp hid="HID_FUNC_ZEILE">Returns the row number of a cell reference.</ahelp> If the reference is a cell, it returns the row number of the cell. If the reference is a cell range, it returns the corresponding row numbers in a one-column <link href="text/scalc/01/04060107.xhp#wasmatrix" name="Array">Array</link> if the formula is entered <link href="text/scalc/01/04060107.xhp#somatrixformel" name="as an array formula">as an array formula</link>. If the ROW function with a range reference is not used in an array formula, only the row number of the first range cell will be returned.</paragraph> <paragraph role="heading" id="hd_id3158439" xml-lang="en-US" level="3" l10n="U" oldref="159">Syntax</paragraph> -<paragraph role="code" id="par_id3154916" xml-lang="en-US" l10n="U" oldref="160">ROW(reference)</paragraph> +<paragraph role="code" id="par_id3154916" xml-lang="en-US" l10n="U" oldref="160">ROW(Reference)</paragraph> <paragraph role="paragraph" id="par_id3156336" xml-lang="en-US" l10n="U" oldref="161"> <emph>Reference</emph> is a cell, an area, or the name of an area.</paragraph> <paragraph role="paragraph" id="par_id3151109" xml-lang="en-US" l10n="U" oldref="204">If you do not indicate a reference, the row number of the cell in which the formula is entered will be found. <item type="productname">%PRODUCTNAME</item> Calc automatically sets the reference to the current cell.</paragraph> <paragraph role="heading" id="hd_id3155609" xml-lang="en-US" level="3" l10n="U" oldref="162">Example</paragraph> -<paragraph role="paragraph" id="par_id3154830" xml-lang="en-US" l10n="U" oldref="205">=ROW(B3) returns 3 because the reference refers to the third row in the table.</paragraph> -<paragraph role="paragraph" id="par_id3147094" xml-lang="en-US" l10n="U" oldref="206">{=ROW(D5:D8)} returns the single-column array (5, 6, 7, 8) because the reference specified contains rows 5 through 8.</paragraph> -<paragraph role="paragraph" id="par_id3153701" xml-lang="en-US" l10n="U" oldref="207">=ROW(D5:D8) returns 5 because the ROW function is not used as array formula and only the number of the first row of the reference is returned.</paragraph> -<paragraph role="paragraph" id="par_id3150996" xml-lang="en-US" l10n="U" oldref="208">{=ROW(A1:E1)} and =ROW(A1:E1) both return 1 because the reference only contains row 1 as the first column in the table. (Because single-row areas only have one row number it does not make any difference whether or not the formula is used as an array formula.)</paragraph> -<paragraph role="paragraph" id="par_id3153671" xml-lang="en-US" l10n="U" oldref="209">=ROW() returns 3 if the formula was entered in row 3.</paragraph> -<paragraph role="paragraph" id="par_id3153790" xml-lang="en-US" l10n="U" oldref="210">{=ROW(Rabbit)} returns the single-column array (1, 2, 3) if "Rabbit" is the named area (C1:D3).</paragraph> +<paragraph role="paragraph" id="par_id3154830" xml-lang="en-US" l10n="U" oldref="205"> +<item type="input">=ROW(B3)</item> returns 3 because the reference refers to the third row in the table.</paragraph> +<paragraph role="paragraph" id="par_id3147094" xml-lang="en-US" l10n="U" oldref="206"> +<item type="input">{=ROW(D5:D8)}</item> returns the single-column array (5, 6, 7, 8) because the reference specified contains rows 5 through 8.</paragraph> +<paragraph role="paragraph" id="par_id3153701" xml-lang="en-US" l10n="U" oldref="207"> +<item type="input">=ROW(D5:D8)</item> returns 5 because the ROW function is not used as array formula and only the number of the first row of the reference is returned.</paragraph> +<paragraph role="paragraph" id="par_id3150996" xml-lang="en-US" l10n="U" oldref="208"> +<item type="input">{=ROW(A1:E1)}</item> and <item type="input">=ROW(A1:E1)</item> both return 1 because the reference only contains row 1 as the first column in the table. (Because single-row areas only have one row number it does not make any difference whether or not the formula is used as an array formula.)</paragraph> +<paragraph role="paragraph" id="par_id3153671" xml-lang="en-US" l10n="U" oldref="209"> +<item type="input">=ROW()</item> returns 3 if the formula was entered in row 3.</paragraph> +<paragraph role="paragraph" id="par_id3153790" xml-lang="en-US" l10n="U" oldref="210"> +<item type="input">{=ROW(Rabbit)}</item> returns the single-column array (1, 2, 3) if "Rabbit" is the named area (C1:D3).</paragraph> </section> <section id="Section19"> <bookmark xml-lang="en-US" branch="index" id="bm_id3145772"><bookmark_value>ROWS function</bookmark_value> @@ -472,13 +530,16 @@ <bookmark xml-lang="en-US" branch="hid/HID_FUNC_ZEILEN" id="bm_id3150667" localize="false"/><paragraph role="heading" id="hd_id3145772" xml-lang="en-US" level="2" l10n="U" oldref="166">ROWS</paragraph> <paragraph role="paragraph" id="par_id3148971" xml-lang="en-US" l10n="U" oldref="167"><ahelp hid="HID_FUNC_ZEILEN">Returns the number of rows in a reference or array.</ahelp></paragraph> <paragraph role="heading" id="hd_id3156051" xml-lang="en-US" level="3" l10n="U" oldref="168">Syntax</paragraph> -<paragraph role="code" id="par_id3154357" xml-lang="en-US" l10n="U" oldref="169">ROWS(array)</paragraph> +<paragraph role="code" id="par_id3154357" xml-lang="en-US" l10n="U" oldref="169">ROWS(Array)</paragraph> <paragraph role="paragraph" id="par_id3155942" xml-lang="en-US" l10n="U" oldref="170"> -<emph>array</emph> is the reference or named area whose total number of rows is to be determined.</paragraph> +<emph>Array</emph> is the reference or named area whose total number of rows is to be determined.</paragraph> <paragraph role="heading" id="hd_id3155869" xml-lang="en-US" level="3" l10n="U" oldref="171">Example</paragraph> -<paragraph role="paragraph" id="par_id3154725" xml-lang="en-US" l10n="U" oldref="212">=Rows(B5) returns 1 because a cell only contains one row.</paragraph> -<paragraph role="paragraph" id="par_id3150102" xml-lang="en-US" l10n="U" oldref="172">=ROWS(A10:B12) returns 3.</paragraph> -<paragraph role="paragraph" id="par_id3155143" xml-lang="en-US" l10n="U" oldref="213">=ROWS(Rabbit) returns 3 if "Rabbit" is the named area (C1:D3).</paragraph> +<paragraph role="paragraph" id="par_id3154725" xml-lang="en-US" l10n="U" oldref="212"> +<item type="input">=Rows(B5)</item> returns 1 because a cell only contains one row.</paragraph> +<paragraph role="paragraph" id="par_id3150102" xml-lang="en-US" l10n="U" oldref="172"> +<item type="input">=ROWS(A10:B12)</item> returns 3.</paragraph> +<paragraph role="paragraph" id="par_id3155143" xml-lang="en-US" l10n="U" oldref="213"> +<item type="input">=ROWS(Rabbit)</item> returns 3 if "Rabbit" is the named area (C1:D3).</paragraph> </section> <section id="Section20"> <bookmark xml-lang="en-US" branch="hid/HID_FUNC_HYPERLINK" id="bm_id8036439" localize="false"/> @@ -489,14 +550,22 @@ <paragraph role="paragraph" id="par_idN11800" xml-lang="en-US" l10n="NEW">If you use the optional <emph>cell text</emph> parameter, the formula locates the URL, and then displays the text.</paragraph> <paragraph role="tip" id="par_idN11803" xml-lang="en-US" l10n="NEW">To open a hyperlinked cell with the keyboard, select the cell, press F2 to enter the Edit mode, move the cursor in front of the hyperlink, press Shift+F10, and then choose <emph>Open Hyperlink</emph>.</paragraph> <paragraph role="heading" id="par_idN1180A" xml-lang="en-US" level="3" l10n="NEW">Syntax</paragraph> -<paragraph role="code" id="par_idN1180E" xml-lang="en-US" l10n="NEW">HYPERLINK (URL) or HYPERLINK (URL;cell text)</paragraph> +<paragraph role="code" id="par_idN1180E" xml-lang="en-US" l10n="NEW">HYPERLINK("URL") or HYPERLINK("URL"; "CellText")</paragraph> <paragraph role="paragraph" id="par_idN11811" xml-lang="en-US" l10n="NEW"> -<emph>URL</emph> specifies the link target. The optional <emph>cell text</emph> parameter is the text that is displayed in the cell and the result of the function. If the <emph>cell text</emph> parameter is not specified, the <emph>URL</emph> is displayed in the cell text and in the result of the function.</paragraph> +<emph>URL</emph> specifies the link target. The optional <emph>CellText</emph> parameter is the text that is displayed in the cell and the result of the function. If the <emph>CellText</emph> parameter is not specified, the <emph>URL</emph> is displayed in the cell text and in the result of the function.</paragraph> <paragraph role="heading" id="par_idN11823" xml-lang="en-US" level="3" l10n="NEW">Example</paragraph> -<paragraph role="paragraph" id="par_idN11827" xml-lang="en-US" l10n="NEW">=HYPERLINK("http://www.example.org") displays the text "http://www.example.org" in the cell and executes the hyperlink http://www.example.org when clicked.</paragraph> -<paragraph role="paragraph" id="par_idN1182A" xml-lang="en-US" l10n="NEW">=HYPERLINK("http://www.example.org";"Click here") displays the text "Click here" in the cell and executes the hyperlink http://www.example.org when clicked.</paragraph> -<paragraph role="paragraph" id="par_idN1182D" xml-lang="en-US" l10n="NEW">=HYPERLINK($B4) where cell B4 contains "http://www.example.org". The function adds "http://www.example.org" to the URL of the hyperlink cell and returns the same text which is used as formula result.</paragraph> -<paragraph role="paragraph" id="par_idN11830" xml-lang="en-US" l10n="NEW">=HYPERLINK("http://www.";"Click ") & "example.org" displays the text "Click example.org" in the cell and executes the hyperlink http://www.example.org when clicked.</paragraph> +<paragraph role="paragraph" id="par_idN11827" xml-lang="en-US" l10n="NEW"> +<item type="input">=HYPERLINK("http://www.example.org")</item> displays the text "http://www.example.org" in the cell and executes the hyperlink http://www.example.org when clicked.</paragraph> +<paragraph role="paragraph" id="par_idN1182A" xml-lang="en-US" l10n="NEW"> +<item type="input">=HYPERLINK("http://www.example.org";"Click here")</item> displays the text "Click here" in the cell and executes the hyperlink http://www.example.org when clicked.</paragraph> +<paragraph role="paragraph" id="par_idN1182D" xml-lang="en-US" l10n="NEW"> +<item type="input">=HYPERLINK($B4)</item> where cell B4 contains <item type="input">http://www.example.org</item>. The function adds http://www.example.org to the URL of the hyperlink cell and returns the same text which is used as formula result.</paragraph> +<paragraph role="paragraph" id="par_idN11830" xml-lang="en-US" l10n="NEW"> +<item type="input">=HYPERLINK("http://www.";"Click ") & "example.org"</item> displays the text Click example.org in the cell and executes the hyperlink http://www.example.org when clicked.</paragraph> +<paragraph role="paragraph" id="par_id8859523" xml-lang="en-US" l10n="NEW"> +<item type="input">=HYPERLINK("#Sheet1.A1";"Go to top")</item> displays the text Go to top and jumps to cell Sheet1.A1 in this document.</paragraph> +<paragraph role="paragraph" id="par_id2958769" xml-lang="en-US" l10n="NEW"> +<item type="input">=HYPERLINK("file:///C:/writer.odt#Specification";"Go to Writer bookmark")</item> displays the text Go to Writer bookmark, loads the specified text document and jumps to bookmark "Specification".</paragraph> </section> <section id="getpivotdata"> <bookmark xml-lang="en-US" branch="index" id="bm_id7682424"><bookmark_value>GETPIVOTDATA function</bookmark_value> @@ -505,12 +574,12 @@ <paragraph role="paragraph" id="par_id3593859" xml-lang="en-US" l10n="NEW"><ahelp hid=".">The GETPIVOTDATA function returns a result value from a DataPilot table. The value is addressed using field and item names, so it remains valid if the layout of the DataPilot table changes.</ahelp></paragraph> <paragraph role="heading" id="hd_id9741508" xml-lang="en-US" level="3" l10n="NEW">Syntax</paragraph> <paragraph role="paragraph" id="par_id909451" xml-lang="en-US" l10n="NEW">Two different syntax definitions can be used:</paragraph> -<paragraph role="code" id="par_id1665089" xml-lang="en-US" l10n="NEW">GETPIVOTDATA(Target Field; DataPilot; [ Field 1; Item 1; ... ])</paragraph> +<paragraph role="code" id="par_id1665089" xml-lang="en-US" l10n="NEW">GETPIVOTDATA(TargetField; DataPilot; [ Field 1; Item 1; ... ])</paragraph> <paragraph role="code" id="par_id4997100" xml-lang="en-US" l10n="NEW">GETPIVOTDATA(DataPilot; Constraints)</paragraph> <paragraph role="paragraph" id="par_id1672109" xml-lang="en-US" l10n="NEW">The second syntax is assumed if exactly two parameters are given, of which the first parameter is a cell or cell range reference. The first syntax is assumed in all other cases. The Function Wizard shows the first syntax.</paragraph> <paragraph role="heading" id="hd_id9464094" xml-lang="en-US" level="3" l10n="NEW">First Syntax</paragraph> <paragraph role="paragraph" id="par_id9302346" xml-lang="en-US" l10n="NEW"> -<emph>Target Field</emph> is a string that selects one of the DataPilot table's data fields. The string can be the name of the source column, or the data field name as shown in the table (like "Sum - Sales").</paragraph> +<emph>TargetField</emph> is a string that selects one of the DataPilot table's data fields. The string can be the name of the source column, or the data field name as shown in the table (like "Sum - Sales").</paragraph> <paragraph role="paragraph" id="par_id8296151" xml-lang="en-US" l10n="NEW"> <emph>DataPilot</emph> is a reference to a cell or cell range that is positioned within a DataPilot table or contains a DataPilot table. If the cell range contains several DataPilot tables, the table that was created last is used.</paragraph> <paragraph role="paragraph" id="par_id4809411" xml-lang="en-US" l10n="NEW">If no <emph>Field n / Item n</emph> pairs are given, the grand total is returned. Otherwise, each pair adds a constraint that the result must satisfy. <emph>Field n</emph> is the name of a field from the DataPilot table. <emph>Item n</emph> is the name of an item from that field.</paragraph> @@ -525,6 +594,6 @@ <emph>Constraints</emph> is a space-separated list. Entries can be quoted (single quotes). The whole string must be enclosed in quotes (double quotes), unless you reference the string from another cell.</paragraph> <paragraph role="paragraph" id="par_id4076357" xml-lang="en-US" l10n="NEW">One of the entries can be the data field name. The data field name can be left out if the DataPilot table contains only one data field, otherwise it must be present. </paragraph> <paragraph role="paragraph" id="par_id8231757" xml-lang="en-US" l10n="CHG">Each of the other entries specifies a constraint in the form <item type="literal">Field[Item]</item> (with literal characters [ and ]), or only <item type="literal">Item</item> if the item name is unique within all fields that are used in the DataPilot table.<comment>i82342</comment></paragraph> -<paragraph role="paragraph" id="par_id3168736" xml-lang="en-US" l10n="NEW">A function name can be added in the form <emph>Field[Item;Function]</emph>, which will cause the constraint to match only subtotal values which use that function. The possible function names are Sum, Count, Average, Max, Min, Product, CountNums, StDev, StDevp, Var, and Varp, case-insensitive.</paragraph><comment>UFI: Example from spec doc is quite difficult to localize. Try to find other one</comment></section> +<paragraph role="paragraph" id="par_id3168736" xml-lang="en-US" l10n="CHG">A function name can be added in the form <emph>Field[Item;Function]</emph>, which will cause the constraint to match only subtotal values which use that function. The possible function names are Sum, Count, Average, Max, Min, Product, Count (Numbers only), StDev (Sample), StDevP (Population), Var (Sample), and VarP (Population), case-insensitive.</paragraph><comment>UFI: Example from spec doc is quite difficult to localize. Try to find other one</comment></section> </sort></body> </helpdocument> |