FR/Documentation/Calc: fonction CELLULE
From Apache OpenOffice Wiki
CELLULE
Renvoie des informations au sujet de l'adresse, du formatage ou du contenu de la cellule
Syntaxe :
CELLULE(type_info; ref_cell)
- renvoie des informations à propos de la cellule ref_cell. Les informations renvoyées dépendent de la chaîne de texte (insensible à la casse) type_info, qui peut être défini de la façon suivante :
- COL
- CELLULE() renvoie le numéro de la colonne référencée. Exemple :
- CELLULE("COL"; D2) renvoie 4, puisque D est la quatrième colonne.
- ROW
- CELLULE() renvoie le numéro de la ligne référencée. Exemple :
- CELLULE("ROW"; D2) renvoie 2.
- SHEET
- CELLULE() renvoi le numéro de la feuille référencée. Exemple :
- CELLULE("SHEET"; Feuille3.D2) renvoie 3 supposant que Feuille3 est la troisième feuille.
- ADDRESS
- CELLULE() renvoi l'adresse absolue de la référence de la cellule, comme texte. Exemples :
- CELLULE("ADDRESS"; D2) renvoie $D$2.
- CELLULE("ADDRESS"; Feuille3.D2) renvoie $Feuille3.$D$2.
- CELLULE("ADDRESS;'X:\dr\test.ods'#$Feuille1.D2) renvoie 'file:///X:/dr/test.ods'#$Feuille1.$D$2.
- FILENAME
- CELLULE() renvoie le nom de fichier et le numéro de la feuille de la cellule référencée, comme texte. Exemples :
- CELLULE("FILENAME";D2) renvoie 'file:///X:/dr/monfichier.ods'#$Feuille1, si le document actif est X:\dr\monfichier.ods et que la formule sur la Feuille1.
- CELLULE("FILENAME";'X:\dr\monfichier.ods'#$Sheet1.D2) renvoie 'file:///X:/dr/monfichier.ods'#$Feuille1.
- COORD
- CELLULE() renvoie l'adresse complète de la cellule en notation Lotus(TM), comme texte. Exemples :
- CELLULE("COORD"; D2) renvoie $A:$D$2.
- CELLULE("COORD"; Feuille3.D2) renvoie $C:$D$2.
- CONTENTS
- CELLULE() renvoie le contenu de la cellule référencée, sans aucun formatage. Exemple :
- CELLULE("CONTENTS"; D2) renvoie le contenu de la cellule D2 (ou 0 si D2 est vide).
- TYPE
- CELLULE() renvoie un texte qui indique le type de contenu de la cellule :
- b (blank) signifie une cellule vide
- l (label) signifie du texte ou le résultat d'une formule comme texte
- v (value) signifies a number, or the result of a formula as a number
- CELLULE() renvoie un texte qui indique le type de contenu de la cellule :
- WIDTH
- CELL() returns the width of the referenced column. The unit is the number of zeros (0) that fit into the column in the default text and the default size.
- PREFIX
- CELL() returns text that indicates the alignment of the referenced cell, as:
- ' = align left or left-justified
- " = align right
- ^ = centered
- \ = repeating (currently inactive)
- CELL() returns text that indicates the alignment of the referenced cell, as:
- PROTECT
- CELL() returns the status of the cell protection for the cell.
- 1 = cell is protected
- 0 = cell is not protected
- CELL() returns the status of the cell protection for the cell.
- FORMAT
- CELL() returns text that indicates the number format:
- , = number with thousands separator
- F = number without thousands separator
- C = currency format
- S = exponential representation, for example 1.234+E56
- P = percentage
- In the above formats, the number of decimal places after the decimal separator is given as a number. Example: the number format #,##0.0 returns ,1 and the number format 00.000% returns P3
- D1 = MMM-D-YY, MM-D-YY and similar formats
- D2 = DD-MM
- D3 = MM-YY
- D4 = DD-MM-YYYY HH:MM:SS
- D5 = MM-DD
- D6 = HH:MM:SS AM/PM
- D7 = HH:MM AM/PM
- D8 = HH:MM:SS
- D9 = HH:MM
- G = All other formats
- - (Minus) at the end = negative numbers are formatted in color
- () (brackets) at the end = there is an opening bracket in the format code
- CELL() returns text that indicates the number format:
- COLOR
- CELL() returns 1, if negative values have been formatted in color, otherwise 0.
- PARENTHESES
- CELL() returns 1 if the format code contains an opening bracket (, otherwise 0.
Issues:
- CELL() is unique to OpenOffice.org Calc. It cannot be exported to other spreadsheets, and is not a part of the ODFF standard.
- CELL() returns information captured when the target cell was last updated. For example CELL("WIDTH"; D2) returns the width of column D - but if column D is then made wider, the value returned will not update until the contents of D2 are changed.