diff options
| author | Vladimir Glazounov <vg@openoffice.org> | 2007-09-21 08:44:18 +0000 |
|---|---|---|
| committer | Vladimir Glazounov <vg@openoffice.org> | 2007-09-21 08:44:18 +0000 |
| commit | 7404475dd3427c454f830ea9040240786be789c1 (patch) | |
| tree | 1b4fba149048dafe24cb4ee4f149a2cf224ca848 /helpcontent2/source/text/scalc/01/04060109.xhp | |
| parent | cdcb1b35822e70567f26c6675724c83766da4cd9 (diff) | |
INTEGRATION: CWS hcshared10 (1.13.12); FILE MERGED
2007/07/16 09:49:18 ufi 1.13.12.2: intermediate saving
2007/06/01 10:38:52 ufi 1.13.12.1: after i72777
Diffstat (limited to 'helpcontent2/source/text/scalc/01/04060109.xhp')
| -rw-r--r-- | helpcontent2/source/text/scalc/01/04060109.xhp | 116 |
1 files changed, 58 insertions, 58 deletions
diff --git a/helpcontent2/source/text/scalc/01/04060109.xhp b/helpcontent2/source/text/scalc/01/04060109.xhp index cc15af93dd..bd81eff10f 100644 --- a/helpcontent2/source/text/scalc/01/04060109.xhp +++ b/helpcontent2/source/text/scalc/01/04060109.xhp @@ -1,14 +1,15 @@ <?xml version="1.0" encoding="UTF-8"?> + <!-- *********************************************************************** * * OpenOffice.org - a multi-platform office productivity suite * - * $RCSfile: 04060109.xhp,v $ + * $RCSfile: 04060109.xhp,v $fileonly,v $ * - * $Revision: 1.13 $ + * $Revision: 1.14 $ * - * last change: $Author: rt $ $Date: 2007-04-02 14:54:25 $ + * last change: $Author: vg $ $Date: 2007-09-21 09:44:18 $ * * The Contents of this file are made available subject to * the terms of GNU Lesser General Public License Version 2.1. @@ -35,19 +36,14 @@ * ************************************************************************ --> - -<helpdocument version="1.0"> + + + <helpdocument version="1.0"> <meta> <topic id="textscalc0104060109xml" indexer="include" status="PUBLISH"> <title id="tit" xml-lang="en-US">Spreadsheet Functions</title> <filename>/text/scalc/01/04060109.xhp</filename> </topic> -<history> -<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> -<lastedited date="2007-02-26T16:56:44">UFI: brushed up this doc due to #i29327# -dedr: reviewed -UFI: added HYPERLINK function #i27972#; dedr. reviewed</lastedited> -</history> </meta> <body> <bookmark xml-lang="en-US" branch="index" id="bm_id3148522"><bookmark_value>spreadsheets; functions</bookmark_value> @@ -58,12 +54,10 @@ UFI: added HYPERLINK function #i27972#; dedr. reviewed</lastedited> <paragraph role="paragraph" id="par_id3144508" xml-lang="en-US" l10n="U" oldref="2"><variable id="tabelletext">This section contains descriptions of the <emph>Spreadsheet</emph> functions together with an example. </variable></paragraph> <paragraph role="paragraph" id="par_id3153012" xml-lang="en-US" l10n="E" localize="false"><link href="text/scalc/00/00000404.xhp#efefft"><embedvar href="text/scalc/00/00000004.xhp#wie"/></link></paragraph> -<sort order="asc"> -<section id="Section1"> +<sort order="asc"><section id="Section1"> <bookmark xml-lang="en-US" branch="index" id="bm_id3146968"><bookmark_value>ADDRESS function</bookmark_value> </bookmark> -<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> +<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> @@ -86,8 +80,7 @@ UFI: added HYPERLINK function #i27972#; dedr. reviewed</lastedited> <section id="Section2"> <bookmark xml-lang="en-US" branch="index" id="bm_id3150372"><bookmark_value>AREAS function</bookmark_value> </bookmark> -<bookmark xml-lang="en-US" branch="hid/HID_FUNC_BEREICHE" id="bm_id3149721" localize="false"/> -<paragraph role="heading" id="hd_id3150372" xml-lang="en-US" level="2" l10n="U" oldref="19">AREAS</paragraph> +<bookmark xml-lang="en-US" branch="hid/HID_FUNC_BEREICHE" id="bm_id3149721" localize="false"/><paragraph role="heading" id="hd_id3150372" xml-lang="en-US" level="2" l10n="U" oldref="19">AREAS</paragraph> <paragraph role="paragraph" id="par_id3150036" xml-lang="en-US" l10n="U" oldref="20"><ahelp hid="HID_FUNC_BEREICHE">Returns the number of individual ranges that belong to a multiple range.</ahelp> A range can consist of contiguous cells or a single cell.</paragraph> <paragraph role="heading" id="hd_id3145222" xml-lang="en-US" level="3" l10n="U" oldref="21">Syntax</paragraph> <paragraph role="code" id="par_id3155907" xml-lang="en-US" l10n="U" oldref="22">AREAS(Reference)</paragraph> @@ -99,8 +92,7 @@ UFI: added HYPERLINK function #i27972#; dedr. reviewed</lastedited> <section id="Section3"> <bookmark xml-lang="en-US" branch="index" id="bm_id3148727"><bookmark_value>DDE function</bookmark_value> </bookmark> -<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> +<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> @@ -150,7 +142,6 @@ UFI: added HYPERLINK function #i27972#; dedr. reviewed</lastedited> </tablecell> </tablerow> </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> @@ -160,8 +151,7 @@ UFI: added HYPERLINK function #i27972#; dedr. reviewed</lastedited> <section id="Section4"> <bookmark xml-lang="en-US" branch="index" id="bm_id3153114"><bookmark_value>ERRORTYPE function</bookmark_value> </bookmark> -<bookmark xml-lang="en-US" branch="hid/HID_FUNC_FEHLERTYP" id="bm_id3153000" localize="false"/> -<paragraph role="heading" id="hd_id3153114" xml-lang="en-US" level="2" l10n="U" oldref="38">ERRORTYPE</paragraph> +<bookmark xml-lang="en-US" branch="hid/HID_FUNC_FEHLERTYP" id="bm_id3153000" localize="false"/><paragraph role="heading" id="hd_id3153114" xml-lang="en-US" level="2" l10n="U" oldref="38">ERRORTYPE</paragraph> <paragraph role="paragraph" id="par_id3148568" xml-lang="en-US" l10n="U" oldref="39"><ahelp hid="HID_FUNC_FEHLERTYP">Returns the number corresponding to an <link href="text/scalc/05/02140000.xhp" name="error value">error value</link> occurring in a different cell.</ahelp> With the aid of this number, you can generate an error message text.</paragraph> <embed href="text/shared/00/00000001.xhp#wahr"/> <paragraph role="note" id="par_id3149877" xml-lang="en-US" l10n="U" oldref="40">The Status Bar displays the predefined error code from <item type="productname">%PRODUCTNAME</item> if you click the cell containing the error.</paragraph> @@ -175,8 +165,7 @@ UFI: added HYPERLINK function #i27972#; dedr. reviewed</lastedited> <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> +<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="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> @@ -200,8 +189,7 @@ UFI: added HYPERLINK function #i27972#; dedr. reviewed</lastedited> <section id="Section6"> <bookmark xml-lang="en-US" branch="index" id="bm_id3153181"><bookmark_value>INDIRECT function</bookmark_value> </bookmark> -<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> +<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> @@ -215,8 +203,7 @@ UFI: added HYPERLINK function #i27972#; dedr. reviewed</lastedited> <section id="Section21"> <bookmark xml-lang="en-US" branch="index" id="bm_id3691824"><bookmark_value>INFO function</bookmark_value> </bookmark> -<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> +<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> @@ -271,7 +258,6 @@ UFI: added HYPERLINK function #i27972#; dedr. reviewed</lastedited> </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="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> @@ -280,8 +266,7 @@ UFI: added HYPERLINK function #i27972#; dedr. reviewed</lastedited> <section id="Section7"> <bookmark xml-lang="en-US" branch="index" id="bm_id3154818"><bookmark_value>COLUMN function</bookmark_value> </bookmark> -<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> +<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> @@ -299,8 +284,7 @@ UFI: added HYPERLINK function #i27972#; dedr. reviewed</lastedited> <section id="Section8"> <bookmark xml-lang="en-US" branch="index" id="bm_id3154643"><bookmark_value>COLUMNS function</bookmark_value> </bookmark> -<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> +<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> @@ -315,9 +299,8 @@ UFI: added HYPERLINK function #i27972#; dedr. reviewed</lastedited> <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 next value 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> +<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> <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> @@ -339,8 +322,7 @@ UFI: added HYPERLINK function #i27972#; dedr. reviewed</lastedited> <bookmark xml-lang="en-US" branch="index" id="bm_id3153905"><bookmark_value>sheet numbers; looking up</bookmark_value> <bookmark_value>SHEET function</bookmark_value> </bookmark> -<bookmark xml-lang="en-US" branch="hid/HID_FUNC_TABELLE" id="bm_id3154693" localize="false"/> -<paragraph role="heading" id="hd_id3153905" xml-lang="en-US" level="2" l10n="U" oldref="215">SHEET</paragraph> +<bookmark xml-lang="en-US" branch="hid/HID_FUNC_TABELLE" id="bm_id3154693" localize="false"/><paragraph role="heading" id="hd_id3153905" xml-lang="en-US" level="2" l10n="U" oldref="215">SHEET</paragraph> <paragraph role="paragraph" id="par_id3150309" xml-lang="en-US" l10n="U" oldref="216"><ahelp hid="HID_FUNC_TABELLE">Returns the sheet number of a reference or a string representing a sheet name.</ahelp> If you do not enter any parameters, the result is the sheet number of the spreadsheet containing the formula.</paragraph> <paragraph role="heading" id="hd_id3148564" xml-lang="en-US" level="3" l10n="U" oldref="217">Syntax</paragraph> <paragraph role="code" id="par_id3153095" xml-lang="en-US" l10n="U" oldref="218">SHEET(Reference)</paragraph> @@ -353,8 +335,7 @@ UFI: added HYPERLINK function #i27972#; dedr. reviewed</lastedited> <bookmark xml-lang="en-US" branch="index" id="bm_id3148829"><bookmark_value>number of sheets; function</bookmark_value> <bookmark_value>SHEETS function</bookmark_value> </bookmark> -<bookmark xml-lang="en-US" branch="hid/HID_FUNC_TABELLEN" id="bm_id3150524" localize="false"/> -<paragraph role="heading" id="hd_id3148829" xml-lang="en-US" level="2" l10n="U" oldref="222">SHEETS</paragraph> +<bookmark xml-lang="en-US" branch="hid/HID_FUNC_TABELLEN" id="bm_id3150524" localize="false"/><paragraph role="heading" id="hd_id3148829" xml-lang="en-US" level="2" l10n="U" oldref="222">SHEETS</paragraph> <paragraph role="paragraph" id="par_id3148820" xml-lang="en-US" l10n="U" oldref="223"><ahelp hid="HID_FUNC_TABELLEN">Determines the number of sheets in a reference.</ahelp> If you do not enter any parameters, it returns the number of sheets in the current document.</paragraph> <paragraph role="heading" id="hd_id3154220" xml-lang="en-US" level="3" l10n="U" oldref="224">Syntax</paragraph> <paragraph role="code" id="par_id3150777" xml-lang="en-US" l10n="U" oldref="225">SHEETS(Reference)</paragraph> @@ -366,8 +347,7 @@ UFI: added HYPERLINK function #i27972#; dedr. reviewed</lastedited> <section id="Section12"> <bookmark xml-lang="en-US" branch="index" id="bm_id3158407"><bookmark_value>MATCH function</bookmark_value> </bookmark> -<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> +<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> @@ -386,8 +366,7 @@ UFI: added HYPERLINK function #i27972#; dedr. reviewed</lastedited> <section id="Section13"> <bookmark xml-lang="en-US" branch="index" id="bm_id3158430"><bookmark_value>OFFSET function</bookmark_value> </bookmark> -<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> +<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> @@ -411,8 +390,7 @@ UFI: added HYPERLINK function #i27972#; dedr. reviewed</lastedited> <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> +<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="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"/> @@ -430,8 +408,7 @@ UFI: added HYPERLINK function #i27972#; dedr. reviewed</lastedited> <section id="Section15"> <bookmark xml-lang="en-US" branch="index" id="bm_id3149425"><bookmark_value>STYLE function</bookmark_value> </bookmark> -<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> +<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> @@ -450,8 +427,7 @@ UFI: added HYPERLINK function #i27972#; dedr. reviewed</lastedited> <section id="Section16"> <bookmark xml-lang="en-US" branch="index" id="bm_id3150430"><bookmark_value>CHOOSE function</bookmark_value> </bookmark> -<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> +<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> @@ -465,8 +441,7 @@ UFI: added HYPERLINK function #i27972#; dedr. reviewed</lastedited> <section id="Section17"> <bookmark xml-lang="en-US" branch="index" id="bm_id3151001"><bookmark_value>HLOOKUP function</bookmark_value> </bookmark> -<bookmark xml-lang="en-US" branch="hid/HID_FUNC_WVERWEIS" id="bm_id3149481" localize="false"/> -<paragraph role="heading" id="hd_id3151001" xml-lang="en-US" level="2" l10n="U" oldref="151">HLOOKUP</paragraph> +<bookmark xml-lang="en-US" branch="hid/HID_FUNC_WVERWEIS" id="bm_id3149481" localize="false"/><paragraph role="heading" id="hd_id3151001" xml-lang="en-US" level="2" l10n="U" oldref="151">HLOOKUP</paragraph> <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> @@ -476,8 +451,7 @@ UFI: added HYPERLINK function #i27972#; dedr. reviewed</lastedited> <section id="Section18"> <bookmark xml-lang="en-US" branch="index" id="bm_id3147321"><bookmark_value>ROW function</bookmark_value> </bookmark> -<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> +<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> @@ -495,8 +469,7 @@ UFI: added HYPERLINK function #i27972#; dedr. reviewed</lastedited> <section id="Section19"> <bookmark xml-lang="en-US" branch="index" id="bm_id3145772"><bookmark_value>ROWS function</bookmark_value> </bookmark> -<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> +<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> @@ -525,6 +498,33 @@ UFI: added HYPERLINK function #i27972#; dedr. reviewed</lastedited> <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> </section> -</sort> -</body> +<section id="getpivotdata"> +<bookmark xml-lang="en-US" branch="index" id="bm_id7682424"><bookmark_value>GETPIVOTDATA function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/HID_FUNC_GETPIVOTDATA" id="bm_id897854" localize="false"/><paragraph role="heading" id="hd_id3747062" xml-lang="en-US" level="2" l10n="NEW">GETPIVOTDATA</paragraph> +<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_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> +<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> +<paragraph role="paragraph" id="par_id6454969" xml-lang="en-US" l10n="NEW">If the DataPilot table contains only a single result value that fulfills all of the constraints, or a subtotal result that summarizes all matching values, that result is returned. If there is no matching result, or several ones without a subtotal for them, an error is returned. These conditions apply to results that are included in the DataPilot table.</paragraph> +<paragraph role="paragraph" id="par_id79042" xml-lang="en-US" l10n="NEW">If the source data contains entries that are hidden by settings of the DataPilot table, they are ignored. The order of the Field/Item pairs is not significant. Field and item names are not case-sensitive.</paragraph> +<paragraph role="paragraph" id="par_id7928708" xml-lang="en-US" l10n="NEW">If no constraint for a page field is given, the field's selected value is implicitly used. If a constraint for a page field is given, it must match the field's selected value, or an error is returned.</paragraph> +<paragraph role="paragraph" id="par_id3864253" xml-lang="en-US" l10n="NEW">Subtotal values from the DataPilot table are only used if they use the function "auto" (except when specified in the constraint, see <item type="literal">Second Syntax</item> below).</paragraph> +<paragraph role="heading" id="hd_id3144016" xml-lang="en-US" level="3" l10n="NEW">Second Syntax</paragraph> +<paragraph role="paragraph" id="par_id9937131" xml-lang="en-US" l10n="NEW"> +<emph>DataPilot</emph> has the same meaning as in the first syntax.</paragraph> +<paragraph role="paragraph" id="par_id5616626" xml-lang="en-US" l10n="NEW"> +<emph>Constraints</emph> is a space-separated list. Entries can be quoted (single quotes). </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="NEW">Each of the other entries specifies a constraint in the form <item type="literal">Field[Item]</item>. The item must be enclosed in square brackets, unless the item name is unique within all fields that are used in the DataPilot table. </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> +</sort></body> </helpdocument> |