Cell类
Cell类
封装代表单个工作簿单元格的对象。
Cell 类型公开以下成员:
特性
属性 | 描述 |
---|---|
worksheet | 获取父工作表。 |
date_time_value | 获取单元格中包含的日期时间值。 |
row | 获取单元格的行号(从零开始)。 |
column | 获取单元格的列号(从零开始)。 |
is_formula | 表示指定单元格是否包含公式。 |
type | 代表单元格值类型。 |
name | 获取单元格的名称。 |
is_error_value | 检查此单元格的值是否有错误。 |
is_numeric_value | 指示该单元格的值是否为数字(int、double 和 datetime) |
string_value | 获取单元格中包含的字符串值。如果此单元格的类型是字符串,则返回字符串值本身。 对于其他单元格类型,将返回格式化的字符串值(使用该单元格的指定样式进行格式化)。 格式化的单元格值与将单元格复制为文本时从 Excel 中获得的值相同(例如 将单元格复制到文本编辑器或导出到 csv)。 |
string_value_without_format | 获取不带任何格式的字符串形式的单元格值。 |
number_category_type | 表示此单元格数字格式的类别类型。 |
display_string_value | 根据单元格的显示样式获取该单元格的格式化字符串值。 |
int_value | 获取单元格中包含的整数值。 |
double_value | 获取单元格中包含的双精度值。 |
float_value | 获取单元格中包含的浮点值。 |
bool_value | 获取单元格中包含的布尔值。 |
has_custom_style | 指示该单元格是否有自定义样式设置(与继承的默认样式不同) 来自相应的行、列或工作簿)。 |
shared_style_index | 获取样式池中单元格的共享样式索引。 |
formula | 获取或设置 Cell 的公式。 |
formula_local | 获取单元格的区域设置格式的公式。 |
r1c1_formula | 获取或设置 Cell 的 R1C1 公式。 |
contains_external_link | 指示此单元格是否包含外部链接。 仅当单元格是公式单元格时适用。 |
is_array_header | 表示单元格的公式是数组公式 它是数组的第一个单元格。 |
is_dynamic_array_formula | 指示单元格的公式是动态数组公式 (true) 还是旧数组公式 (false)。 |
is_array_formula | 指示单元格公式是否为数组公式。 |
is_in_array | 指示单元格公式是否为数组公式。 |
is_shared_formula | 指示单元格公式是否是共享公式的一部分。 |
is_table_formula | 指示此单元格是否是表格公式的一部分。 |
is_in_table | 指示此单元格是否是表格公式的一部分。 |
value | 获取/设置此单元格中包含的值。 |
is_style_set | 指示单元格的样式是否已设置。如果返回 false,则表示该单元格具有默认单元格格式。 |
is_merged | 检查单元格是否属于合并范围的一部分。 |
comment | 获取该单元格的评论。 |
html_string | 获取和设置包含此单元格中的数据和某些格式的 html 字符串。 |
embedded_image | 获取并设置单元格中嵌入的图像。 |
方法
方法 | 描述 |
---|---|
put_value | 将布尔值放入单元格中。 |
put_value | 将整数值放入单元格中。 |
put_value | 将双精度值放入单元格中。 |
put_value | 将一个值放入单元格中,如果合适,该值将转换为其他数据类型,并且单元格的数字格式将被重置。 |
put_value | 将字符串值放入单元格中,并在适当的情况下将该值转换为其他数据类型。 |
put_value | 将字符串值放入单元格中。 |
put_value | 将日期时间值放入单元格中。 |
put_value | 将对象值放入单元格中。 |
get_display_style | 获取单元格的显示样式。 如果此单元格还受到其他设置(例如条件格式、列表对象等)的影响, 那么显示样式可能与cell.GetStyle()不同。 |
get_display_style | 获取单元格的显示样式。 如果单元格是条件格式的,则显示样式与cell.GetStyle()不同。 |
get_style | 获取单元格样式。 |
get_style | 如果 checkBorders 为 true,则检查其他单元格的边框是否会影响该单元格的样式。 |
set_style | 设置单元格样式。 |
set_style | 将更改后的样式属性应用到单元格。 |
set_style | 应用基于标志的单元格样式。 |
set_formula | 设置公式和公式的值(计算结果)。 |
set_formula | 设置公式和公式的值。 |
set_formula | 设置公式和公式的值(计算结果)。 |
set_array_formula | 将数组公式设置为单元格区域。 |
set_array_formula | 将数组公式(在 ms excel 中通过 CTRL+SHIFT+ENTER 输入的旧数组公式)设置为单元格区域。 |
set_array_formula | 将数组公式设置为单元格区域。 |
set_array_formula | 将数组公式设置为单元格区域。 |
set_shared_formula | 将公式设置为单元格区域。 |
set_shared_formula | 将共享公式设置为一系列单元格。 |
set_shared_formula | 将共享公式设置为一系列单元格。 |
set_shared_formula | 将共享公式设置为一系列单元格。 |
get_leafs | 获取直接引用该单元格并在修改该单元格时需要更新的所有单元格。 |
get_leafs | 获取当该单元格被修改时将更新的所有单元格。 |
set_dynamic_array_formula | 设置动态数组公式,并在可能的情况下使公式溢出到相邻单元格中。 |
set_dynamic_array_formula | 设置动态数组公式,并在可能的情况下使公式溢出到相邻单元格中。 |
set_dynamic_array_formula | 设置动态数组公式,并在可能的情况下使公式溢出到相邻单元格中。 |
set_table_formula | 从该单元格开始为给定范围创建二变量数据表。 |
set_table_formula | 从该单元格开始为给定范围创建单变量数据表。 |
set_table_formula | 从该单元格开始为给定范围创建二变量数据表。 |
set_table_formula | 从该单元格开始为给定范围创建单变量数据表。 |
get_characters | 返回所有字符对象 表示单元格文本中的一系列字符。 |
get_characters | 返回所有字符对象 表示单元格文本中的一系列字符。 |
calculate | 计算单元格的公式。 |
get_string_value | 通过特定的格式化策略获取字符串值。 |
get_width_of_value | 获取以像素为单位的值的宽度。 |
get_height_of_value | 获取以像素为单位的值的高度。 |
get_format_conditions | 获取适用于该单元格的格式条件。 |
get_formula | 获取该单元格的公式。 |
get_precedents | 获取此单元格公式中出现的所有引用。 |
get_dependents | 获取其公式直接引用该单元格的所有单元格。 |
get_precedents_in_calculation | 获取此单元格公式在计算时使用的所有先例(引用当前工作簿中的单元格)。 |
get_dependents_in_calculation | 获取计算结果取决于该单元格的所有单元格。 |
get_array_range | 如果单元格的公式是数组公式,则获取数组范围。 |
remove_array_formula | 删除数组公式。 |
copy | 从源单元格复制数据。 |
characters | 返回一个 Characters 对象,该对象表示单元格文本中的字符范围。 |
replace | 用选项替换单元格的文本。 |
insert_text | 向单元格中插入一些字符。 如果单元格格式丰富,此方法可以保留原始格式。 |
is_rich_text | 指示此单元格的字符串值是否为富格式文本。 |
set_characters | 设置单元格的富文本格式。 |
get_merged_range | 返回表示合并范围的 Range 对象。 |
get_html_string | 获取包含此单元格中的数据和某些格式的 html 字符串。 |
to_json | 将 Cell 转换为 JSON 结构体数据。 |
equals | 检查此对象是否与另一个单元格对象引用同一单元格。 |
get_conditional_formatting_result | 获取条件格式的结果。 |
get_validation | 获取应用于此单元格的验证。 |
get_validation_value | 获取应用于此单元格的验证值。 |
get_table | 获取包含此单元格的表。 |
例子
from aspose.cells import TextAlignmentType, Workbook
from aspose.pydrawing import Color
excel = Workbook()
cells = excel.worksheets[0].cells
# Put a string into a cell
cell = cells.get(0, 0)
cell.put_value("Hello")
first = cell.string_value
# Put an integer into a cell
cell = cells.get("B1")
cell.put_value(12)
second = cell.int_value
# Put a double into a cell
cell = cells.get(0, 2)
cell.put_value(-1.234)
third = cell.double_value
# Put a formula into a cell
cell = cells.get("D1")
cell.formula = "=B1 + C1"
# Put a combined formula: "sum(average(b1,c1), b1)" to cell at b2
cell = cells.get("b2")
cell.formula = "=sum(average(b1,c1), b1)"
# Set style of a cell
style = cell.get_style()
# Set background color
style.background_color = Color.yellow
# Set format of a cell
style.font.name = "Courier New"
style.vertical_alignment = TextAlignmentType.TOP
cell.set_style(style)
也可以看看
- 模块
aspose.cells
- 类
Cell
- 类
Range