diff --git a/helpcontent2/source/text/scalc/01/04060109.xhp b/helpcontent2/source/text/scalc/01/04060109.xhp index 4cf259f81c..01624ce4eb 100644 --- a/helpcontent2/source/text/scalc/01/04060109.xhp +++ b/helpcontent2/source/text/scalc/01/04060109.xhp @@ -62,7 +62,7 @@ Sun Microsystems, Inc. -UFI: brushed up this doc due to #i29327# +UFI: brushed up this doc due to #i29327# dedr: reviewed UFI: added HYPERLINK function #i27972#; dedr. reviewed @@ -84,7 +84,7 @@ UFI: added HYPERLINK function #i27972#; dedr. reviewed ADDRESS Returns a cell address (reference) as text, according to the specified row and column numbers. Optionally, 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. Syntax -ADDRESS(row; column; abs;sheet) +ADDRESS(row; column; abs;sheet) row represents the row number for the cell reference @@ -100,8 +100,6 @@ UFI: added HYPERLINK function #i27972#; dedr. reviewed Example: ADDRESS(1; 1; 2; "Sheet2") returns the following: Sheet2.A$1 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. - -COLUMN, ROW.
AREAS function @@ -110,22 +108,20 @@ UFI: added HYPERLINK function #i27972#; dedr. reviewed AREAS Returns the number of individual ranges that belong to a multiple range. A range can consist of contiguous cells or a single cell. Syntax -AREAS(Reference) +AREAS(Reference) Reference represents the reference to a cell or cell range. Example =AREAS(A1:B3;F2;G1) returns 3, as it is a reference to three cells and/or areas. -=AREAS(All) returns 1 if you have defined an area named All under Data - Define Range. - -ADDRESS, COLUMN, COLUMNS, INDEX, ROW, ROWS. +=AREAS(All) returns 1 if you have defined an area named All under Data - Define Range.
DDE function DDE -Returns the result of a DDE-based link. If the contents of the linked range or section changes, the returned value will also change. You must reload the spreadsheet or choose Edit - Links to see the updated links. Cross-platform links, for example from a%PRODUCTNAME installation running on a Windows machine to a document created on a Linux machine, are not allowed. +Returns the result of a DDE-based link. If the contents of the linked range or section changes, the returned value will also change. You must reload the spreadsheet or choose Edit - Links to see the updated links. Cross-platform links, for example from a %PRODUCTNAME installation running on a Windows machine to a document created on a Linux machine, are not allowed. Syntax -DDE(server;file;range;mode) +DDE(server;file;range;mode) Server is the name of a server application. %PRODUCTNAME applications have the server name "Soffice". @@ -174,8 +170,10 @@ UFI: added HYPERLINK function #i27972#; dedr. reviewed Example -=DDE("soffice";"c:\office\document\data1.sxc";"sheet1.A1") reads the contents of cell A1 in sheet1 of the %PRODUCTNAME Calc spreadsheet data1.sxc. -=DDE("soffice";"c:\office\document\motto.sxw";"Today's motto") 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 Today's Motto (in %PRODUCTNAME Writer under Insert - Section). If the motto is modified (and saved) in the %PRODUCTNAME Writer document, the motto is updated in all %PRODUCTNAME Calc cells in which this DDE link is defined. + +=DDE("soffice";"c:\office\document\data1.sxc";"sheet1.A1") reads the contents of cell A1 in sheet1 of the %PRODUCTNAME Calc spreadsheet data1.sxc. + +=DDE("soffice";"c:\office\document\motto.sxw";"Today's motto") 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 Today's Motto (in %PRODUCTNAME Writer under Insert - Section). If the motto is modified (and saved) in the %PRODUCTNAME Writer document, the motto is updated in all %PRODUCTNAME Calc cells in which this DDE link is defined.
ERRORTYPE function @@ -186,13 +184,11 @@ UFI: added HYPERLINK function #i27972#; dedr. reviewed The Status Bar displays the predefined error code from %PRODUCTNAME if you click the cell containing the error. Syntax -ERRORTYPE(Reference) +ERRORTYPE(Reference) Reference contains the address of the cell in which the error occurs. Example If cell A1 displays Err:518, the function =ERRORTYPE(A1) returns the number 518. - -ISREF, ISERR, ISERROR, ISFORMULA. ISNONTEXT, ISBLANK, ISLOGICAL, ISNA, ISTEXT, ISNUMBER.
INDEX function @@ -201,7 +197,7 @@ UFI: added HYPERLINK function #i27972#; dedr. reviewed INDEX INDEX returns the content of a cell, specified by row and column number or an optional range name. Syntax -INDEX(reference;row;column;range) +INDEX(reference;row;column;range) reference 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. @@ -215,8 +211,6 @@ UFI: added HYPERLINK function #i27972#; dedr. reviewed =INDEX(SumX;4;1) returns the value from the range SumX in row 4 and column 1 as defined in Insert - Names - Define. =INDEX((multi);4;1) indicates the value contained in row 4 and column 1 of the (multiple) range, which you named under Insert - Names - Set as multi. 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 range parameter. =INDEX(A1:B6;1;1) indicates the value in the upper-left of the A1:B6 range. - -VLOOKUP, MATCH, LOOKUP, CHOOSE, HLOOKUP.
INDIRECT function @@ -225,14 +219,13 @@ UFI: added HYPERLINK function #i27972#; dedr. reviewed INDIRECT Returns the reference specified by a text string. This function can also be used to return the area of a corresponding string. Syntax -INDIRECT(ref) +INDIRECT(ref) ref represents a reference to a cell or an area (in text form) for which to return the contents. +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).UFI: for #i34465# Example =INDIRECT(A1) equals 100 if A1 contains C108 as a reference and cell C108 contains a value of 100. =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. - -OFFSET.
COLUMN function @@ -241,7 +234,7 @@ UFI: added HYPERLINK function #i27972#; dedr. reviewed COLUMN Returns the column number of a cell reference. 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 array if the formula is entered as an array formula. 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. Syntax -COLUMN(reference) +COLUMN(reference) Reference is the reference to a cell or cell area whose first column number is to be found. If no reference is entered, the column number of the cell in which the formula is entered is found. %PRODUCTNAME Calc automatically sets the reference to the current cell. @@ -252,8 +245,6 @@ UFI: added HYPERLINK function #i27972#; dedr. reviewed {=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. =COLUMN() returns 3 if the formula was entered in column C. {=COLUMN(Rabbit)} returns the single-row array (3, 4) if "Rabbit" is the named area (C1:D3). - -COLUMNS, ROWS.
COLUMNS function @@ -262,15 +253,13 @@ UFI: added HYPERLINK function #i27972#; dedr. reviewed COLUMNS Returns the number of columns in the given reference. Syntax -COLUMNS(array) +COLUMNS(array) array is the reference to a cell range whose total number of columns is to be found. The argument can also be a single cell. Example =Columns(B5) returns 1 because a cell only contains one column. =COLUMNS(A1:C5) equals 3. The reference comprises three columns. =COLUMNS(Rabbit) returns 2 if "Rabbit" is the named range (C1:D3). - -COLUMN, ROWS.
vertical search function @@ -281,7 +270,7 @@ UFI: added HYPERLINK function #i27972#; dedr. reviewed Vertical search with reference to adjacent cells to the right. This function checks if a specific value is contained in the first column of an array. The function then returns the value to the same line of a specific array column named by index. Syntax -=VLOOKUP(Search criterion;array;index;sort order) +=VLOOKUP(Search criterion;array;index;Sort order) Search criterion is the value searched for in the first column of the array. @@ -295,8 +284,6 @@ UFI: added HYPERLINK function #i27972#; dedr. reviewed Enter the following formula in B1: =VLOOKUP(A1; D1:E100; 2) 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. - -INDEX, HLOOKUP, LOOKUP, MATCH.
sheet numbers; looking up @@ -306,7 +293,7 @@ UFI: added HYPERLINK function #i27972#; dedr. reviewed SHEET Returns the sheet number of a reference or a string representing a sheet name. If you do not enter any parameters, the result is the sheet number of the spreadsheet containing the formula. Syntax -SHEET(Reference) +SHEET(Reference) Reference is optional and is the reference to a cell, an area, or a sheet name string. Example @@ -320,7 +307,7 @@ UFI: added HYPERLINK function #i27972#; dedr. reviewed SHEETS Determines the number of sheets in a reference. If you do not enter any parameters, it returns the number of sheets in the current document. Syntax -SHEETS(Reference) +SHEETS(Reference) Reference is the reference to a sheet or an area. This parameter is optional. Example @@ -333,7 +320,7 @@ UFI: added HYPERLINK function #i27972#; dedr. reviewed MATCH Returns the relative position of an item in an array that matches a specified value. The function returns the position of the value found in the lookup_array as a number. Syntax -MATCH(search criterion;lookup_array;type) +MATCH(search criterion;lookup_array;type) Search Criterion is the value which is to be searched for in the single-row or single-column array. @@ -345,8 +332,6 @@ UFI: added HYPERLINK function #i27972#; dedr. reviewed Example =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. - -INDEX, VLOOKUP, HLOOKUP.
OFFSET function @@ -355,7 +340,7 @@ UFI: added HYPERLINK function #i27972#; dedr. reviewed OFFSET Returns the value of a cell offset by a certain number of rows and columns from a given reference point. Syntax -OFFSET(reference;rows;columns;height;width) +OFFSET(reference;rows;columns;height;width) Reference is the cell from which the function searches for the new reference. @@ -367,7 +352,7 @@ UFI: added HYPERLINK function #i27972#; dedr. reviewed Width is the optional horizontal width for an area that starts at the new reference position. Example -=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. +=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. =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).
@@ -378,7 +363,7 @@ UFI: added HYPERLINK function #i27972#; dedr. reviewed Returns the contents of a cell either from a one-row or one-column range or from an array. Optionally, the assigned value (of the same index) is returned in a different column and row. As opposed to VLOOKUP and HLOOKUP, 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. Syntax -LOOKUP(Search criterion;Search vector;result_vector) +LOOKUP(Search criterion;Search vector;result_vector) Search criterion is the value to be searched for; entered either directly or as a reference. @@ -387,8 +372,6 @@ UFI: added HYPERLINK function #i27972#; dedr. reviewed result_vector 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. Example =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). - -HLOOKUP, INDEX, VLOOKUP.
STYLE function @@ -397,7 +380,7 @@ UFI: added HYPERLINK function #i27972#; dedr. reviewed STYLE Applies a style to the cell containing the formula. 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. Syntax -STYLE(style;time;style2) +STYLE(style;time;style2) Style is the name of a cell style assigned to the cell. Style names must be entered in quotation marks. @@ -414,15 +397,13 @@ UFI: added HYPERLINK function #i27972#; dedr. reviewed CHOOSE Uses an index to return a value from a list of up to 30 values. Syntax -CHOOSE(Index; value1;...value30) +CHOOSE(Index; value1;...value30) Index is a reference or number between 1 and 30 indicating which value is to be taken from the list. Value1...Value30 is the list of values entered as a reference to a cell or as individual values. Example =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". - -INDEX
HLOOKUP function @@ -432,10 +413,8 @@ UFI: added HYPERLINK function #i27972#; dedr. reviewed Searches for a value and reference to the cells below the selected area. 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 Index, in the same column. Syntax -=HLOOKUP(search_criteria;array;Index;sorted) +=HLOOKUP(search_criteria;array;Index;sorted) See also:VLOOKUP (columns and rows are exchanged) - -INDEX, LOOKUP, MATCH, VLOOKUP.
ROW function @@ -444,7 +423,7 @@ UFI: added HYPERLINK function #i27972#; dedr. reviewed ROW Returns the row number of a cell reference. 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 Array if the formula is entered as an array formula. 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. Syntax -ROW(reference) +ROW(reference) Reference is a cell, an area, or the name of an area. If you do not indicate a reference, the row number of the cell in which the formula is entered will be found. %PRODUCTNAME Calc automatically sets the reference to the current cell. @@ -455,8 +434,6 @@ UFI: added HYPERLINK function #i27972#; dedr. reviewed {=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.) =ROW() returns 3 if the formula was entered in row 3. {=ROW(Rabbit)} returns the single-column array (1, 2, 3) if "Rabbit" is the named area (C1:D3). - -COLUMN, ROWS.
ROWS function @@ -465,15 +442,13 @@ UFI: added HYPERLINK function #i27972#; dedr. reviewed ROWS Returns the number of rows in a reference or array. Syntax -ROWS(array) +ROWS(array) array is the reference or named area whose total number of rows is to be determined. Example =Rows(B5) returns 1 because a cell only contains one row. =ROWS(A10:B12) returns 3. =ROWS(Rabbit) returns 3 if "Rabbit" is the named area (C1:D3). - -COLUMNS, ROW.
@@ -484,7 +459,7 @@ UFI: added HYPERLINK function #i27972#; dedr. reviewed If you use the optional cell text parameter, the formula locates the URL, and then displays the text. 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 Open Hyperlink. Syntax -HYPERLINK (URL) or HYPERLINK (URL;cell text) +HYPERLINK (URL) or HYPERLINK (URL;cell text) URL specifies the link target. The optional cell text parameter is the text that is displayed in the cell and the result of the function. If the cell text parameter is not specified, the URL is displayed in the cell text and in the result of the function. Example