Range класс

Range класс

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

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

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

СвойствоОписание
current_regionВозвращает объект Range, представляющий текущий регион.
Текущий регион представляет собой диапазон, ограниченный любой комбинацией пустых строк и пустых столбцов.
hyperlinksПолучает все гиперссылки в диапазоне.
row_countПолучает количество строк в диапазоне.
column_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Автоматическое заполнение целевого диапазона.
auto_fillАвтоматическое заполнение целевого диапазона.
set_styleПримените стиль ячейки.
set_styleУстанавливает стиль диапазона.
set_outline_bordersУстанавливает контурные границы вокруг диапазона ячеек с одинаковым стилем и цветом границы.
set_outline_bordersУстанавливает контурные границы вокруг диапазона ячеек с одинаковым стилем и цветом границы.
set_outline_bordersУстанавливает границы линий вокруг диапазона ячеек.
set_outline_borderУстанавливает контурную границу вокруг диапазона ячеек.
set_outline_borderУстанавливает контурную границу вокруг диапазона ячеек.
copyКопирование диапазона со специальными параметрами вставки.
copyКопирует данные (включая формулы), форматирование, рисование объектов и т. д. из исходного диапазона.
add_hyperlinkДобавляет гиперссылку в указанную ячейку или диапазон ячеек.
get_enumeratorПолучает перечислитель для ячеек в этом диапазоне.
is_intersectУказывает, является ли диапазон пересечением.
intersectВозвращает объект Range, представляющий прямоугольное пересечение двух диапазонов.
union_rangВозвращает результат объединения двух диапазонов.
unionВозвращает объединение двух диапазонов.
is_blankУказывает, содержит ли диапазон значения.
mergeОбъединяет диапазон ячеек в одну ячейку.
un_mergeРазъединяет объединенные ячейки этого диапазона.
put_valueПомещает значение в диапазон. При необходимости значение будет преобразовано в другой тип данных, а числовой формат ячейки будет сброшен.
apply_styleПрименяет форматы для всего диапазона.
set_inside_bordersУстанавливается внутри границ диапазона.
move_toПереместить текущий диапазон в целевой диапазон.
copy_dataКопирует данные ячеек (включая формулы) из исходного диапазона.
copy_valueКопирует значение ячейки из исходного диапазона.
copy_styleКопирует настройки стиля из исходного диапазона.
get_cell_or_nullПолучает объект Cell или значение NULL в этом диапазоне.
get_offsetПолучает диапазон Range по смещению.

Примечания

Класс Range обозначает область электронной таблицы Excel. Благодаря этому вы можете форматировать и устанавливать значение диапазона. И вы также можете просто скопировать диапазон Excel.

Пример

В следующем примере показано, как создать диапазон и установить значение диапазона Excel.

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")

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