Cell класс
Cell класс
Инкапсулирует объект, представляющий одну ячейку книги.
Тип Cell предоставляет следующие члены:
Характеристики
| Свойство | Описание |
|---|---|
| worksheet | Получает родительский рабочий лист. |
| date_time_value | Получает значение DateTime, содержащееся в ячейке. |
| row | Получает номер строки (начиная с нуля) ячейки. |
| column | Получает номер столбца (начиная с нуля) ячейки. |
| is_formula | Указывает, содержит ли указанная ячейка формулу. |
| type | Представляет тип значения ячейки. |
| name | Получает имя ячейки. |
| is_error_value | Проверяет, является ли значение этой ячейки ошибкой. |
| is_numeric_value | Указывает, является ли внутреннее значение этой ячейки числовым (int, double и datetime) |
| string_value | Получает строковое значение, содержащееся в ячейке. Если тип этой ячейки — строка, верните само строковое значение.
Для других типов ячеек будет возвращено форматированное строковое значение (отформатированное в соответствии с указанным стилем этой ячейки). Отформатированное значение ячейки совпадает с тем, что вы можете получить из Excel при копировании ячейки в виде текста (например, копирование ячейки в текстовый редактор или экспорт в csv). |
| string_value_without_format | Получает значение ячейки в виде строки без какого-либо формата. |
| number_category_type | Представляет тип категории числового форматирования этой ячейки. |
| display_string_value | Получает отформатированное строковое значение этой ячейки по стилю отображения ячейки. |
| int_value | Получает целочисленное значение, содержащееся в ячейке. |
| double_value | Получает двойное значение, содержащееся в ячейке. |
| float_value | Получает значение с плавающей запятой, содержащееся в ячейке. |
| bool_value | Получает логическое значение, содержащееся в ячейке. |
| has_custom_style | Указывает, имеет ли эта ячейка пользовательские настройки стиля (отличные от унаследованных по умолчанию).
из соответствующей строки, столбца или книги). |
| shared_style_index | Получает индекс общего стиля ячейки в пуле стилей. |
| formula | Получает или задает формулу Cell. |
| formula_local | Получите формулу ячейки в формате локали. |
| r1c1_formula | Получает или задает формулу R1C1 для Cell. |
| contains_external_link | Указывает, содержит ли эта ячейка внешнюю ссылку.
Применяется только в том случае, если ячейка является ячейкой формулы. |
| is_array_header | Указывает, что формула ячейки и формула массива
и это первая ячейка массива. |
| is_dynamic_array_formula | Указывает, является ли формула ячейки формулой динамического массива (true) или устаревшей формулой массива (false). |
| is_array_formula | Указывает, является ли формула ячейки формулой массива. |
| is_in_array | Указывает, является ли формула ячейки формулой массива. |
| is_shared_formula | Указывает, является ли формула ячейки частью общей формулы. |
| is_table_formula | Указывает, является ли эта ячейка частью формулы таблицы. |
| is_in_table | Указывает, является ли эта ячейка частью формулы таблицы. |
| value | Получает значение, содержащееся в этой ячейке. |
| is_style_set | Указывает, установлен ли стиль ячейки. Если возвращается false, это означает, что эта ячейка имеет формат ячейки по умолчанию. |
| is_merged | Проверяет, является ли ячейка частью объединенного диапазона или нет. |
| comment | Получает комментарий этой ячейки. |
| html_string | Получает и задает строку html, содержащую данные и некоторые форматы в этой ячейке. |
Методы
| Метод | Описание |
|---|---|
| calculate(options) | Вычисляет формулу ячейки. |
| calculate(ignore_error, custom_function) | Вычисляет формулу ячейки. |
| put_value(bool_value) | Помещает логическое значение в ячейку. |
| put_value(int_value) | Помещает в ячейку целочисленное значение. |
| put_value(double_value) | Помещает двойное значение в ячейку. |
| put_value(string_value, is_converted, set_style) | Помещает значение в ячейку, при необходимости значение будет преобразовано в другой тип данных, а числовой формат ячейки будет сброшен. |
| put_value(string_value, is_converted) | Помещает строковое значение в ячейку и при необходимости преобразует значение в другой тип данных. |
| put_value(string_value) | Помещает строковое значение в ячейку. |
| put_value(date_time) | Помещает значение DateTime в ячейку. |
| put_value(object_value) | Помещает значение объекта в ячейку. |
| get_display_style() | Получает стиль отображения ячейки.
Если на эту ячейку также влияют другие параметры, такие как условное форматирование, объекты списка и т. д., тогда стиль отображения может отличаться от cell.GetStyle(). |
| get_display_style(include_merged_borders) | Получает стиль отображения ячейки.
Если ячейка имеет условное форматирование, стиль отображения отличается от стиля cell.GetStyle(). |
| get_style() | Получает стиль ячейки. |
| get_style(check_borders) | Если checkBorders имеет значение true, проверьте, повлияют ли границы других ячеек на стиль этой ячейки. |
| set_style(style) | Задает стиль ячейки. |
| set_style(style, explicit_flag) | Примените стиль ячейки. |
| set_style(style, flag) | Примените стиль ячейки. |
| set_formula(formula, value) | Установите формулу и значение формулы. |
| set_formula(formula, is_r1c1, is_local, value) | Установите формулу и значение формулы. |
| set_formula(formula, options, value) | Установите формулу и значение формулы. |
| set_array_formula(array_formula, row_number, column_number, is_r1c1, is_local) | Задает формулу массива для диапазона ячеек. |
| set_array_formula(array_formula, row_number, column_number) | Задает формулу массива (устаревшая формула массива, введенная с помощью CTRL+SHIFT+ENTER в MS Excel) для диапазона ячеек. |
| set_array_formula(array_formula, row_number, column_number, options) | Задает формулу массива для диапазона ячеек. |
| set_array_formula(array_formula, row_number, column_number, options, values) | Задает формулу массива для диапазона ячеек. |
| set_shared_formula(shared_formula, row_number, column_number, is_r1c1, is_local) | Устанавливает формулу в диапазон ячеек. |
| set_shared_formula(shared_formula, row_number, column_number) | Задает общие формулы для диапазона ячеек. |
| set_shared_formula(shared_formula, row_number, column_number, options) | Задает общие формулы для диапазона ячеек. |
| set_shared_formula(shared_formula, row_number, column_number, options, values) | Задает общие формулы для диапазона ячеек. |
| get_leafs() | Получите все ячейки, которые ссылаются на эту ячейку напрямую и должны быть обновлены при изменении этой ячейки. |
| get_leafs(recursive) | Получить все ячейки, которые будут обновлены при изменении этой ячейки. |
| set_dynamic_array_formula(array_formula, options, calculate_value) | Задает формулу динамического массива и по возможности распространяет формулу на соседние ячейки. |
| set_dynamic_array_formula(array_formula, options, values, calculate_range, calculate_value) | Задает формулу динамического массива и по возможности распространяет формулу на соседние ячейки. |
| set_dynamic_array_formula(array_formula, options, values, calculate_range, calculate_value, copts) | Задает формулу динамического массива и по возможности распространяет формулу на соседние ячейки. |
| set_table_formula(row_number, column_number, row_input_cell, column_input_cell, values) | Создайте таблицу данных с двумя переменными для заданного диапазона, начиная с этой ячейки. |
| set_table_formula(row_number, column_number, input_cell, is_row_input, values) | Создайте таблицу данных с одной переменной для заданного диапазона, начиная с этой ячейки. |
| set_table_formula(row_number, column_number, row_index_of_row_input_cell, column_index_of_row_input_cell, row_index_of_column_input_cell, column_index_of_column_input_cell, values) | Создайте таблицу данных с двумя переменными для заданного диапазона, начиная с этой ячейки. |
| set_table_formula(row_number, column_number, row_index_of_input_cell, column_index_of_input_cell, is_row_input, values) | Создайте таблицу данных с одной переменной для заданного диапазона, начиная с этой ячейки. |
| get_characters() | Возвращает все объекты символов
который представляет собой диапазон символов в тексте ячейки. |
| get_characters(flag) | Возвращает все объекты символов
который представляет собой диапазон символов в тексте ячейки. |
| get_string_value(format_strategy) | Получает строковое значение по определенной стратегии форматирования. |
| get_width_of_value() | Получает ширину значения в пикселях. |
| get_height_of_value() | Получает высоту значения в единицах пикселей. |
| get_format_conditions() | Получает условия формата, применимые к этой ячейке. |
| get_formula(is_r1c1, is_local) | Получите формулу этой ячейки. |
| get_precedents() | Получает все ссылки, встречающиеся в формуле этой ячейки. |
| get_dependents(is_all) | Получить все ячейки, формула которых напрямую ссылается на эту ячейку. |
| get_precedents_in_calculation() | Получает все прецеденты (ссылки на ячейки в текущей книге), используемые формулой этой ячейки при ее вычислении. |
| get_dependents_in_calculation(recursive) | Получает все ячейки, результат вычислений которых зависит от этой ячейки. |
| get_array_range() | Получает диапазон массива, если формула ячейки является формулой массива. |
| remove_array_formula(leave_normal_formula) | Удалить формулу массива. |
| copy(cell) | Копирует данные из исходной ячейки. |
| characters(start_index, length) | Возвращает объект Characters, представляющий диапазон символов в тексте ячейки. |
| is_rich_text() | Указывает, является ли значение строки ячейки форматированным текстом. |
| set_characters(characters) | Устанавливает расширенный текстовый формат ячейки. |
| get_merged_range() | Возвращает объект Range, представляющий объединенный диапазон. |
| get_html_string(html5) | Получает строку html, содержащую данные и некоторые форматы в этой ячейке. |
| to_json() | Преобразование Cell в данные структуры JSON. |
| equals(cell) | Проверяет, ссылается ли этот объект на ту же ячейку с другим объектом ячейки. |
| get_conditional_formatting_result() | Получите результат условного форматирования. |
| get_validation() | Получает проверку, применяемую к этой ячейке. |
| get_validation_value() | Получает значение проверки, примененное к этой ячейке. |
| get_table() | Получает таблицу, содержащую эту ячейку. |
Пример
from aspose.cells import TextAlignmentType, Workbook
from aspose.pydrawing import Color
excel = Workbook()
cells = excel.worksheets[0].cells
# Put a string into a cell
cell = cells.get(0, 0)
cell.put_value("Hello")
first = cell.string_value
# Put an integer into a cell
cell = cells.get("B1")
cell.put_value(12)
second = cell.int_value
# Put a double into a cell
cell = cells.get(0, 2)
cell.put_value(-1.234)
third = cell.double_value
# Put a formula into a cell
cell = cells.get("D1")
cell.formula = "=B1 + C1"
# Put a combined formula: "sum(average(b1,c1), b1)" to cell at b2
cell = cells.get("b2")
cell.formula = "=sum(average(b1,c1), b1)"
# Set style of a cell
style = cell.get_style()
# Set background color
style.background_color = Color.yellow
# Set format of a cell
style.font.name = "Courier New"
style.vertical_alignment = TextAlignmentType.TOP
cell.set_style(style)
Смотрите также
- модуль aspose.cells
- класс Cell
- класс Range
