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(self, target) | Автоматически заполнить целевой диапазон. |
auto_fill(self, target, auto_fill_type) | Автоматически заполнить целевой диапазон. |
set_style(self, style, explicit_flag) | Примените стиль ячейки. |
set_style(self, style) | Задает стиль диапазона. |
set_outline_borders(self, border_style, border_color) | Устанавливает границы контура вокруг диапазона ячеек с одинаковым стилем и цветом границ. |
set_outline_borders(self, border_style, border_color) | Устанавливает границы контура вокруг диапазона ячеек с одинаковым стилем и цветом границ. |
set_outline_borders(self, border_styles, border_colors) | Устанавливает границы линий вокруг диапазона ячеек. |
set_outline_border(self, border_edge, border_style, border_color) | Устанавливает границу контура вокруг диапазона ячеек. |
set_outline_border(self, border_edge, border_style, border_color) | Устанавливает границу контура вокруг диапазона ячеек. |
copy(self, range, options) | Копирование диапазона с использованием опций специальной вставки. |
copy(self, range) | Копирует данные (включая формулы), форматирование, объекты чертежей и т. д. из исходного диапазона. |
add_hyperlink(self, address, text_to_display, screen_tip) | Добавляет гиперссылку к указанной ячейке или диапазону ячеек. |
is_intersect(self, range) | Указывает, пересекается ли диапазон. |
intersect(self, range) | Возвращает объект Range, представляющий собой прямоугольное пересечение двух диапазонов. |
union_rang(self, range) | Возвращает результат объединения двух диапазонов. |
union_ranges(self, ranges) | Возвращает результат объединения двух диапазонов. |
union(self, range) | Возвращает объединение двух диапазонов. |
is_blank(self) | Указывает, содержит ли диапазон значения. |
merge(self) | Объединяет ряд ячеек в одну ячейку. |
un_merge(self) | Разделяет объединенные ячейки данного диапазона. |
put_value(self, string_value, is_converted, set_style) | Помещает значение в диапазон, при необходимости значение будет преобразовано в другой тип данных, а числовой формат ячейки будет сброшен. |
apply_style(self, style, flag) | Применяет форматы для всего диапазона. |
set_inside_borders(self, border_edge, line_style, border_color) | Установить внутри границ диапазона. |
move_to(self, dest_row, dest_column) | Переместить текущий диапазон в целевой диапазон. |
copy_data(self, range) | Копирует данные ячеек (включая формулы) из исходного диапазона. |
copy_value(self, range) | Копирует значение ячейки из исходного диапазона. |
copy_style(self, range) | Копирует настройки стиля из исходного диапазона. |
transpose(self) | Транспонировать (повернуть) данные из строк в столбцы и наоборот. |
get(self, row_offset, column_offset) | Добавьте API for Python через .Net.since this[int, int] не поддерживается |
get_cell_or_null(self, row_offset, column_offset) | Получает объект Cell или значение NULL в этом диапазоне. |
get_offset(self, row_offset, column_offset) | Получает диапазон Range по смещению. |
to_image(self, options) | Преобразует диапазон в изображение. |
to_json(self, options) | Преобразовать диапазон в значение JSON. |
to_html(self, save_options) | Конвертировать диапазон в html. |
clear(self) | Очищает этот диапазон. |
clear_contents(self) | Очищает содержимое этого диапазона. |
clear_formats(self) | Очищает форматы этого диапазона. |
clear_comments(self) | Очищает комментарии этого диапазона. |
clear_hyperlinks(self, clear_format) | Удаляет только гиперссылки. |
Примечания
Класс 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")
Смотрите также
- модуль
aspose.cells - класс
Cell - класс
Range
