Range класс

Range класс

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

Тип Range предоставляет следующие члены:

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

Свойство Описание
current_region Возвращает объект Range, представляющий текущий регион.
Текущая область — это диапазон, ограниченный любой комбинацией пустых строк и пустых столбцов.
hyperlinks Получает все гиперссылки в диапазоне.
row_count Получает количество строк в диапазоне.
column_count Получает количество столбцов в диапазоне.
cell_count Получает количество всех ячеек в диапазоне.
name Получает или задает имя диапазона.
refers_to Получает ссылки на диапазон.
address Получает адрес диапазона.
left Получает расстояние в пунктах от левого края столбца A до левого края диапазона.
top Получает расстояние в пунктах от верхнего края строки 1 до верхнего края диапазона.
width Получает ширину диапазона в пунктах.
height Получает ширину диапазона в пунктах.
first_row Получает индекс первой строки диапазона.
first_column Получает индекс первого столбца диапазона.
value Получает и задает значение диапазона.
column_width Задает или получает ширину столбца этого диапазона
row_height Задает или получает высоту строк в этом диапазоне
entire_column Получает объект Range, представляющий весь столбец (или столбцы), содержащий указанный диапазон.
entire_row Получает объект Range, представляющий всю строку (или строки), содержащую указанный диапазон.
worksheet Получает объект Range.worksheet, содержащий этот диапазон.

Методы

Метод Описание
auto_fill(target) Автоматическое заполнение целевого диапазона.
auto_fill(target, auto_fill_type) Автоматическое заполнение целевого диапазона.
set_style(style, explicit_flag) Примените стиль ячейки.
set_style(style) Устанавливает стиль диапазона.
set_outline_borders(border_style, border_color) Устанавливает границы контура вокруг диапазона ячеек с одинаковым стилем и цветом границы.
set_outline_borders(border_style, border_color) Устанавливает границы контура вокруг диапазона ячеек с одинаковым стилем и цветом границы.
set_outline_borders(border_styles, border_colors) Устанавливает границы линии вокруг диапазона ячеек.
set_outline_border(border_edge, border_style, border_color) Устанавливает границу контура вокруг диапазона ячеек.
set_outline_border(border_edge, border_style, border_color) Устанавливает границу контура вокруг диапазона ячеек.
copy(range, options) Копирование диапазона со специальными параметрами вставки.
copy(range) Копирует данные (включая формулы), форматирование, объекты рисования и т. д. из исходного диапазона.
get_enumerator() Получает перечислитель для ячеек в этом диапазоне.
is_intersect(range) Указывает, является ли диапазон пересекающимся.
intersect(range) Возвращает объект Range, представляющий прямоугольное пересечение двух диапазонов.
union(range) Возвращает объединение двух диапазонов.
merge() Объединяет диапазон ячеек в одну ячейку.
un_merge() Разъединяет объединенные ячейки этого диапазона.
put_value(string_value, is_converted, set_style) Помещает значение в диапазон, при необходимости значение будет преобразовано в другой тип данных, а числовой формат ячейки будет сброшен.
apply_style(style, flag) Применяет форматы ко всему диапазону.
set_inside_borders(border_edge, line_style, border_color) Установить внутренние границы диапазона.
move_to(dest_row, dest_column) Переместите текущий диапазон в диапазон назначения.
copy_data(range) Копирует данные ячейки (включая формулы) из исходного диапазона.
copy_value(range) Копирует значение ячейки из исходного диапазона.
copy_style(range) Копирует настройки стиля из исходного диапазона.
get_cell_or_null(row_offset, column_offset) Получает объект Cell или null в этом диапазоне.
get_offset(row_offset, column_offset) Получает диапазон Range по смещению.

Пример

from aspose.cells import Workbook

# Instantiating a Workbook object
workbook = Workbook()
#  Get the first Worksheet Cells.
cells = workbook.worksheets[0].cells
#  Create a range (A1:D3).
range = cells.create_range("A1", "D3")
#  Set value to the range.
range.value = "Hello"
# Save the Excel file
workbook.save("book1.xlsm")

Смотрите также