Cell класс

Инкапсулирует объект, представляющий одну ячейку рабочей книги.

Тип Cell предоставляет следующие элементы:

Характеристики

Свойство	Описание
worksheet	Получает родительский рабочий лист.
date_time_value	Получает значение DateTime, содержащееся в ячейке.
row	Возвращает номер строки (начиная с нуля) ячейки.
column	Возвращает номер столбца (начиная с нуля) ячейки.
is_formula	Показывает, содержит ли указанная ячейка формулу.
has_custom_function	Проверяет, есть ли в формуле ячейки пользовательская функция (неподдерживаемая функция).
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	Указывает, является ли формула ячейки динамической формулой массива (истина) или устаревшей формулой массива (ложь).
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-строку, содержащую данные и некоторые форматы в этой ячейке.
is_check_box_style	Указывает, установлена ли эта ячейка как флажок.
embedded_image	Получает и задает встроенное изображение в ячейке.

Методы

Метод	Описание
`put_value(self, bool_value)`	Помещает в ячейку логическое значение.
`put_value(self, int_value)`	Помещает в ячейку целочисленное значение.
`put_value(self, double_value)`	Помещает в ячейку двойное значение.
`put_value(self, string_value, is_converted, set_style)`	Помещает значение в ячейку, при необходимости значение будет преобразовано в другой тип данных, а числовой формат ячейки будет сброшен.
`put_value(self, string_value, is_converted)`	Помещает строковое значение в ячейку и при необходимости преобразует значение в другой тип данных.
`put_value(self, string_value)`	Помещает строковое значение в ячейку.
`put_value(self, date_time)`	Помещает значение DateTime в ячейку.
`put_value(self, object_value)`	Помещает значение объекта в ячейку.
`get_display_style(self)`	Получает стиль отображения этой ячейки.
`get_display_style(self, include_merged_borders)`	Получает стиль отображения этой ячейки.
`get_display_style(self, adjacent_borders)`	Получает стиль отображения этой ячейки.
`get_style(self)`	Получает стиль ячейки.
`get_style(self, check_borders)`	Если checkBorders имеет значение true, проверьте, повлияют ли границы других ячеек на стиль этой ячейки.
`set_style(self, style)`	Задает стиль ячейки.
`set_style(self, style, explicit_flag)`	Применить измененное свойство стиля к ячейке.
`set_style(self, style, flag)`	Применить стиль ячеек на основе флагов.
`set_formula(self, formula, value)`	Задайте формулу и значение (вычисленный результат) формулы.
`set_formula(self, formula, options)`	Задайте формулу и значение (вычисленный результат) формулы.
`set_formula(self, formula, is_r1c1, is_local, value)`	Задайте формулу и значение формулы.
`set_formula(self, formula, options, value)`	Задайте формулу и значение (вычисленный результат) формулы.
`set_array_formula(self, array_formula, row_number, column_number, is_r1c1, is_local)`	Устанавливает формулу массива для диапазона ячеек.
`set_array_formula(self, array_formula, row_number, column_number)`	Устанавливает формулу массива (устаревшую формулу массива, введенную с помощью CTRL+SHIFT+ENTER в MS Excel) для диапазона ячеек.
`set_array_formula(self, array_formula, row_number, column_number, options)`	Устанавливает формулу массива для диапазона ячеек.
`set_array_formula(self, array_formula, row_number, column_number, options, values)`	Устанавливает формулу массива для диапазона ячеек.
`set_shared_formula(self, shared_formula, row_number, column_number, is_r1c1, is_local)`	Устанавливает формулу для диапазона ячеек.
`set_shared_formula(self, shared_formula, row_number, column_number)`	Устанавливает общие формулы для диапазона ячеек.
`set_shared_formula(self, shared_formula, row_number, column_number, options)`	Устанавливает общие формулы для диапазона ячеек.
`set_shared_formula(self, shared_formula, row_number, column_number, options, values)`	Устанавливает общие формулы для диапазона ячеек.
`get_leafs(self)`	Получить все ячейки, которые напрямую ссылаются на данную ячейку и должны быть обновлены при изменении данной ячейки.
`get_leafs(self, recursive)`	Получить все ячейки, которые будут обновлены при изменении данной ячейки.
`set_dynamic_array_formula(self, array_formula, options, calculate_value)`	Задает динамическую формулу массива и заставляет формулу распространяться на соседние ячейки, если это возможно.
`set_dynamic_array_formula(self, array_formula, options, values, calculate_range, calculate_value)`	Задает динамическую формулу массива и заставляет формулу распространяться на соседние ячейки, если это возможно.
`set_dynamic_array_formula(self, array_formula, options, values, calculate_range, calculate_value, copts)`	Задает динамическую формулу массива и заставляет формулу распространяться на соседние ячейки, если это возможно.
`set_table_formula(self, row_number, column_number, row_input_cell, column_input_cell, values)`	Создать таблицу данных с двумя переменными для заданного диапазона, начиная с этой ячейки.
`set_table_formula(self, row_number, column_number, input_cell, is_row_input, values)`	Создать таблицу данных с одной переменной для заданного диапазона, начиная с этой ячейки.
`set_table_formula(self, 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(self, row_number, column_number, row_index_of_input_cell, column_index_of_input_cell, is_row_input, values)`	Создать таблицу данных с одной переменной для заданного диапазона, начиная с этой ячейки.
`get_characters(self)`	Возвращает все объекты Characters который представляет собой диапазон символов в тексте ячейки.
`get_characters(self, flag)`	Возвращает все объекты Characters который представляет собой диапазон символов в тексте ячейки.
`calculate(self, options)`	Вычисляет формулу ячейки.
`get_string_value(self, format_strategy)`	Получает строковое значение по определенной отформатированной стратегии.
`get_width_of_value(self)`	Получает ширину значения в пикселях.
`get_height_of_value(self)`	Получает высоту значения в пикселях.
`get_format_conditions(self)`	Получает условия форматирования, применяемые к этой ячейке.
`get_formula(self, is_r1c1, is_local)`	Получите формулу этой ячейки.
`get_precedents(self)`	Получает все ссылки, встречающиеся в формуле этой ячейки.
`get_dependents(self, is_all)`	Получить все ячейки, формула которых напрямую ссылается на эту ячейку.
`get_precedents_in_calculation(self)`	Возвращает все прецеденты (ссылки на ячейки в текущей книге), используемые формулой этой ячейки при ее вычислении.
`get_dependents_in_calculation(self, recursive)`	Получает все ячейки, вычисленный результат которых зависит от этой ячейки.
`get_array_range(self)`	Возвращает диапазон массива, если формула ячейки является формулой массива.
`remove_array_formula(self, leave_normal_formula)`	Удалить формулу массива.
`copy(self, cell)`	Копирует данные из исходной ячейки.
`characters(self, start_index, length)`	Возвращает объект Characters, представляющий диапазон символов в тексте ячейки.
`replace(self, place_holder, new_value, options)`	Заменить текст ячейки параметрами.
`insert_text(self, index, text)`	Вставьте несколько символов в ячейку. Если ячейка имеет расширенный формат, этот метод может сохранить исходное форматирование.
`is_rich_text(self)`	Указывает, является ли строковое значение этой ячейки текстом в расширенном формате.
`set_characters(self, characters)`	Устанавливает расширенный текстовый формат ячейки.
`get_merged_range(self)`	Возвращает объект `Range`, представляющий объединенный диапазон.
`get_html_string(self, html5)`	Получает HTML-строку, содержащую данные и некоторые форматы в этой ячейке.
`to_json(self)`	Преобразовать структурные данные `Cell` в JSON.
`equals(self, cell)`	Проверяет, ссылается ли данный объект на ту же ячейку, что и другой объект ячейки.
`get_conditional_formatting_result(self)`	Получите результат условного форматирования.
`get_validation(self)`	Получает проверку, примененную к этой ячейке.
`get_validation_value(self)`	Получает значение проверки, примененной к этой ячейке.
`get_table(self)`	Получает таблицу, содержащую эту ячейку.
`get_rich_value(self)`	Получает богатое значение ячейки.

Пример

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

CalculationOptions класс CellArea класс