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)`	通过 .Net 添加 API for Python，因为 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")

也可以看看

QueryTableCollection类 RangeCollection类