Формулы таблицы диаграммы
О формуле таблицы диаграммы в презентации
Таблица диаграммы (или рабочий лист диаграммы) в презентации является источником данных диаграммы. Таблица диаграммы содержит данные, которые представлены на диаграмме графически. Когда вы создаете диаграмму в PowerPoint, рабочий лист, связанный с этой диаграммой, также создается автоматически. Рабочий лист диаграммы создается для всех типов диаграмм: линейная диаграмма, столбчатая диаграмма, диаграмма-солнечный сплеск, круговая диаграмма и т.д. Чтобы увидеть таблицу диаграммы в PowerPoint, вы должны дважды щелкнуть по диаграмме:
Таблица диаграммы содержит названия элементов диаграммы (Имя категории: Категория1, Имя серии) и таблицу с числовыми данными, соответствующими этим категориям и сериям. По умолчанию, когда вы создаете новую диаграмму, данные таблицы диаграммы устанавливаются с данными по умолчанию. Затем вы можете изменить данные таблицы в рабочем листе вручную.
Обычно диаграмма представляет собой сложные данные (например, финансовые аналитики, научные аналитики), имеющие ячейки, которые вычисляются на основе значений в других ячейках или из других динамических данных. Ручное вычисление значения ячейки и жесткое его кодирование в ячейке усложняет их изменение в будущем. Если вы измените значение определенной ячейки, все клетки, зависимые от нее, также потребуют обновления. Кроме того, данные таблицы могут зависеть от данных из других таблиц, создавая сложную схему данных презентации с необходимостью обновления удобным и гибким образом.
Формула таблицы диаграммы в презентации — это выражение для автоматического вычисления и обновления данных таблицы диаграммы. Формула таблицы определяет логику вычисления данных для определённой ячейки или набора ячеек. Формула таблицы — это математическая формула или логическая формула, которая использует: ссылки на ячейки, математические функции, логические операторы, арифметические операторы, функции преобразования, строковые константы и т.д. Определение формулы записывается в ячейку, и эта ячейка не содержит простого значения. Формула таблицы вычисляет значение и возвращает его обратно, затем это значение присваивается ячейке. Формулы таблицы диаграмм в презентациях фактически аналогичны формулам Excel, и поддерживаются те же функции, операторы и константы по умолчанию для их реализации.
В Aspose.Slides таблица диаграммы представлена с помощью метода Chart.getChartData.getChartDataWorkbook типа IChartDataWorkbook. Формула таблицы может быть назначена и изменена с помощью метода IChartDataCell.setFormula. Следующая функциональность поддерживается для формул в Aspose.Slides:
- Логические константы
- Числовые константы
- Строковые константы
- Константы ошибок
- Арифметические операторы
- Операторы сравнения
- Ссылки на ячейки в стиле A1
- Ссылки на ячейки в стиле R1C1
- Предопределенные функции
Как правило, таблицы хранят последние рассчитанные значения формул. Если после загрузки презентации данные диаграммы не изменились, метод IChartDataCell.getValue возвращает эти значения при чтении. Но если данные таблицы были изменены, при чтении свойства ChartDataCell.Value выбрасывается CellUnsupportedDataException для неподдерживаемых формул. Это происходит потому, что при успешном анализе формул определяются зависимости ячеек и корректность последних значений. Но если формулу невозможно разобрать, корректность значения ячейки не может быть гарантирована.
Добавить формулу таблицы диаграммы в презентацию
Сначала добавьте диаграмму на первый слайд новой презентации с помощью метода IShapeCollection.getShapes.addChart. Рабочий лист диаграммы создается автоматически и может быть доступен с помощью метода Chart.getChartData.getChartDataWorkbook:
$pres = new Presentation();
try {
$chart = $pres->getSlides()->get_Item(0)->getShapes()->addChart(ChartType::ClusteredColumn, 150, 150, 500, 300);
$workbook = $chart->getChartData()->getChartDataWorkbook();
# ...
} finally {
if (!java_is_null($pres)) {
$pres->dispose();
}
}
Теперь давайте запишем некоторые значения в ячейки с помощью свойства IChartDataCell.setValue типа Object, что означает, что вы можете установить любое значение для свойства:
$workbook->getCell(0, "F2")->setValue(-2.5);
$workbook->getCell(0, "G3")->setValue(6.3);
$workbook->getCell(0, "H4")->setValue(3);
Теперь для записи формулы в ячейку вы можете использовать метод IChartDataCell.setFormula:
Примечание: метод IChartDataCell.setFormula используется для установки ссылок на ячейки в стиле A1.
Чтобы установить ссылку на ячейку R1C1Formula, вы можете использовать метод IChartDataCell.setR1C1Formula:
Если вы попытаетесь прочитать значения из ячеек B2 и C2, они будут рассчитаны:
$value1 = $cell1->getValue();// 7.8
$value2 = $cell2->getValue();// 2.1
Логические константы
Вы можете использовать логические константы, такие как FALSE и TRUE в формулах ячеек:
$workbook->getCell(0, "A2")->setValue(false);
$cell = $workbook->getCell(0, "B2");
$cell->setFormula("A2 = TRUE");
$value = $cell->getValue();// значение содержит логическое "false"
Числовые константы
Числа могут использоваться в обычной или научной нотации для создания формул таблицы диаграммы:
$workbook->getCell(0, "A2")->setFormula("1 + 0.5");
$workbook->getCell(0, "B2")->setFormula(".3 * 1E-2");
Строковые константы
Строковая (или литеральная) константа — это специфическое значение, которое используется как есть и не меняется. Строковые константы могут быть: даты, тексты, числа и т.д.:
$workbook->getCell(0, "A2")->setFormula("\"abc\"");
$workbook->getCell(0, "B2")->setFormula("\"2/3/2020 12:00\"");
Константы ошибок
Иногда невозможно вычислить результат по формуле. В этом случае вместо его значения в ячейке отображается код ошибки. Каждый тип ошибки имеет специфический код:
- #DIV/0! - формула пытается разделить на ноль.
- #GETTING_DATA - может отображаться в ячейке, пока ее значение все еще вычисляется.
- #N/A - информация отсутствует или недоступна. Некоторые причины могут быть: используемые в формуле ячейки пустые, лишний пробел, опечатка и т.д.
- #NAME? - определенная ячейка или другие объекты формул не могут быть найдены по своему имени.
- #NULL! - может появиться, когда в формуле есть ошибка, такая как: (,) или пробел вместо двоеточия (:).
- #NUM! - числовое значение в формуле может быть недействительным, слишком длинным или слишком маленьким и т.д.
- #REF! - недействительная ссылка на ячейку.
- #VALUE! - неожидаемый тип значения. Например, строковое значение, присвоенное числовой ячейке.
$cell = $workbook->getCell(0, "A2");
$cell->setFormula("2 / 0");
$value = $cell->getValue();// значение содержит строку "#DIV/0!"
Арифметические операторы
Вы можете использовать все арифметические операторы в формулах рабочих листов диаграмм:
| Оператор | Значение | Пример |
|---|---|---|
| + (плюс) | Сложение или унарный плюс | 2 + 3 |
| - (минус) | Вычитание или отрицание | 2 - 3 -3 |
| * (звездочка) | Умножение | 2 * 3 |
| / (косая черта) | Деление | 2 / 3 |
| % (процент) | Процент | 30% |
| ^ (крышка) | Возведение в степень | 2 ^ 3 |
Примечание: Чтобы изменить порядок вычисления, заключите в скобки ту часть формулы, которая должна быть рассчитана первой.
Операторы сравнения
Вы можете сравнивать значения ячеек с операторами сравнения. Когда два значения сравниваются с использованием этих операторов, результат — логическое значение, либо TRUE, либо FALSE:
| Оператор | Значение | Значение |
|---|---|---|
| = (равно) | Равно | A2 = 3 |
| <> (не равно) | Не равно | A2 <> 3 |
| > (больше) | Больше | A2 > 3 |
| >= (больше или равно) | Больше или равно | A2 >= 3 |
| < (меньше) | Меньше | A2 < 3 |
| <= (меньше или равно) | Меньше или равно | A2 <= 3 |
Ссылки на ячейки в стиле A1
Ссылки на ячейки в стиле A1 используются для рабочих листов, где столбец имеет буквенный идентификатор (например, “A"), а строка имеет числовой идентификатор (например, “1"). Ссылки на ячейки в стиле A1 могут использоваться следующим образом:
| Ссылка на ячейку | Пример | ||
|---|---|---|---|
| Абсолютная | Относительная | Смешанная | |
| Ячейка | $A$2 | A2 | A$2 $A2 |
| Строка | $2:$2 | 2:2 | - |
| Столбец | $A:$A | A:A | - |
| Диапазон | $A$2:$C$4 | A2:C4 | $A$2:C4 A$2:$C4 |
Вот пример того, как использовать ссылку на ячейку в стиле A1 в формуле:
$workbook->getCell(0, "A2")->setFormula("C3 + SUM(F2:H5)");
Ссылки на ячейки в стиле R1C1
Ссылки на ячейки в стиле R1C1 используются для рабочих листов, где как строка, так и столбец имеют числовой идентификатор. Ссылки на ячейки в стиле R1C1 могут использоваться следующим образом:
| Ссылка на ячейку | Пример | ||
|---|---|---|---|
| Абсолютная | Относительная | Смешанная | |
| Ячейка | R2C3 | R[2]C[3] | R2C[3] R[2]C3 |
| Строка | R2 | R[2] | - |
| Столбец | C3 | C[3] | - |
| Диапазон | R2C3:R5C7 | R[2]C[3]:R[5]C[7] | R2C3:R[5]C[7] R[2]C3:R5C[7] |
Вот пример того, как использовать ссылку на ячейку в стиле R1C1 в формуле:
$workbook->getCell(0, "A2")->setR1C1Formula("R2C4 + SUM(R5C6:R7C9)");
Предопределенные функции
Существуют предопределенные функции, которые могут использоваться в формулах для упрощения их реализации. Эти функции инкапсулируют наиболее часто используемые операции, такие как:
- ABS
- AVERAGE
- CEILING
- CHOOSE
- CONCAT
- CONCATENATE
- DATE (система дат 1900 года)
- DAYS
- FIND
- FINDB
- IF
- INDEX (форма ссылки)
- LOOKUP (векторная форма)
- MATCH (векторная форма)
- MAX
- SUM
- VLOOKUP