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

也可以看看

QueryTableCollection类 RangeCollection类