База Знаний: Функции Calc. CELL

 < Apache OpenOffice | База знаний | Модули Apache OpenOffice | Apache OpenOffice Calc | Справочник функций | Информационные функции

CELL

Функция возвращает информацию об адресе, форматировании или содержимом ячейки.

Синтаксис функции:

=CELL(info_type; cell_ref)

Рис. 1. Пример функции.

где:

• info_type — символьная строка, определяющая тип информации. Символьная строка вводится всегда на английском языке. Прописные или строчные буквы — неважно;
• cell_ref — положение исследуемой ячейки. Если cell_ref — диапазон, берётся верхняя левая ячейка диапазона.

Если cell_ref отсутствует, InfraOffice.pro Calc использует положение ячейки, в которой расположена формула. MS Excel использует ссылку на ячейку, в которую помещён курсор.

Функция CELL возвращает информацию о ячейке cell_ref. Возвращаемая информация зависит от текстовой строки info_type (независимой от регистра), которая может быть установлена следующим образом:

• COL — возвращается номер столбца, на который ссылаются;
• ROW — возвращается номер строки, на который ссылаются;
• SHEET — возвращается номер листа, на который ссылаются;
• ADDRESS — возвращается абсолютный адрес ячейки, на которую ссылаются, в виде текста;
• FILENAME — возвращается имя файла и номер листа ячейки, на которую ссылаются, в виде текста;
• COORD — возвращается полный адрес ячейки в нотации Lotus™, в виде текста.
• CONTENTS — возвращается содержимое ячейки, на которую ссылаются, без форматирования.
• TYPE — возвращается текст, который обозначает тип содержимого ячейки:
  • b (blank) обозначает пустую ячейку;
  • l (label) обозначает текст, или результат формулы в виде текста;
  • v (value) обозначает число, или результат формулы в виде числа;
• WIDTH — возвращается ширина столбца, на который ссылаются. Единица измерения — количество нулей (0), которые вписываются в столбец шрифтом и размером шрифта по умолчанию;
• PREFIX — возвращается текст, который обозначает выравнивание ячейки, на которую ссылаются, в виде:
  • ' = выравнивание по левому краю или по ширине;
    " = выравнивание по правому краю;
    ^ = выравнивание по центру;
    \ = заполнение (в настоящее время не активно).
• PROTECT — возвращается статус защиты ячейки:
  • 1 = ячейка защищена;
    0 = ячейка не защищена.
• FORMAT — возвращается текст, который обозначает формат числа:
  • , = число с разделителем тысяч;
    F = число без разделителя тысяч;
    C = денежный формат;
    S = экспоненциальное представление, например 1,234+E56;
    P = процентный формат;
    В вышеупомянутых форматах, число десятичных разрядов после десятичного разделителя даётся в виде числа. Например: формат числа #,##0.0 возвращает ,1, а формат числа 00.000% возвращает P3;
    D1 = MMM-D-YY, MM-D-YY и подобные форматы;
    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 = все другие форматы;
    - (минус) в конце = отрицательные числа выделяются цветом;
    () (скобки) в конце = в коде формата есть открывающая скобка.
• COLOR — возвращается 1, если отрицательные значения выделяются цветом, в противном случае 0.
• PARENTHESES — возвращается 1, если код формата содержит открывающую скобку (, в противном случае 0.

Функция CELL возвращает захваченную информацию, когда целевая ячейка была последний раз обновлена. Например CELL(“WIDTH”; D2), возвращает ширину столбца D — но если столбец D сделать шире, возвращаемое значение не обновится, пока содержимое D2 не будет изменено. Чтобы гарантировать обновление, используйте (например) CELL(“WIDTH”; D2) + 0*RAND(); это работает, потому что RAND() обновляется, когда изменяется ширина столбца.

---

А. Е. Харламенков

Версия Apache OpenOffice 3.1.x

---

---