openpyxl -- Cell

news2024/10/17 15:22:56

文章目录

Cell
Cell的属性
MergedCell

版本：openpyxl - 3.0.10

Cell

创建一个单元格，并存入数据、样式、注释等；
openpyxl.cell.cell.Cell;
获取cell
- worksheet_obj[“B3”]，根据coordinate获取cell; 也可直接赋值写入；
- worksheet_obj.cell(row_id, col_id)，根据行列获取cell; 也可以再传一个值写入；
- worksheet_obj[“A1”: “C4”]，获取二维数组的cell，每行的cell对象组成一个元组；

Cell的属性

cell.row，行 id，从1开始；
cell.column / col_idx，列 id，从1开始；
cell.column_letter，获取列对应的字母，如B
cell.coordinate，坐标，如 ‘B5’
cell.value / internal_value，单元格中的数据；
cell.comment，关联到这个cell的注释
- 如图
- 返回一个openpyxl.comments.comments.Comment对象
- cell.comment.text 获取注释的文本数据；
cell.data_type 数据类型
- n，数值类型，包括整数、浮点数；
- s，文本类型；
- d，日期类型；
cell.encoding，编码方式
cell.hyperlink，单元格内的超链接；
- 返回openpyxl.worksheet.hyperlink.Hyperlink对象；
- 可以在excel单元格中添加一个超链接，链向另一个excel文件，如b.xlsx 或者 b.xlsx#jack!B5，#跟worksheet名称，!跟对应的单元格坐标（#…!..必须一起使用）；
- 超链接对象的参数：
  - ref=‘B5’, 所在单元格的坐标；
  - target=“b.xlsx”，链向的文件名
  - location=‘jack!B5’，链向的excel文件的worksheet表及单元格；
  - tooltip=‘这是一个超链接’，鼠标悬浮链接的提示信息；
  - display=‘b.xlsx - jack!B5’，超链接显示为的内容，若不生效，则通过设置cell.value 来显示；
  - id=‘rId1’，超链接的编号；


from openpyxl.worksheet.hyperlink import Hyperlink
cell2 = ws["B6"]
# 设置显示内容
cell2.value = "laufing 设置value"
# 设置超链接
cell2.hyperlink = Hyperlink(
    ref=cell2.coordinate,
    target="b.xlsx",
    location="jack!B5",
    display="laufing 测试display",
    tooltip="这是Lucy的超链接",
    id="rId2") # id 可以不用传入

cell.is_date，数据是否为日期类型；
cell.offset(rid, cid) ，相对于当前cell偏移行、列后的cell对象；
cell.parent，获取单元格所属的worksheet对象；
cell.alignment，水平、垂直对齐方式；
- 返回openpyxl.styles.alignment.Alignment对象；
- alignment.horizontal，水平对齐方式，如“center”
- alignment.vertical，垂直对齐方式，如“center”
cell.border, 单元格的边框；
- 返回openpyxl.styles.borders.Border 对象；
- border.left/right/top/bottom，返回openpyxl.styles.borders.Side对象；
- side.style & side.color均为None时，无对应边框；均有值时有对应的边框；

# 有对应的边框
# <openpyxl.styles.borders.Side object>
# Parameters:
# style='medium', color=<openpyxl.styles.colors.Color object>
# Parameters:
# rgb='FF00B050', indexed=None, auto=None, theme=None, tint=0.0, type='rgb'

# 无对应的边框
# <openpyxl.styles.borders.Side object>
# Parameters:
# style=None, color=None

cell.fill ，单元格的填充色；
- 返回 openpyxl.styles.fills.PatternFill 对象；
- p_fill.fgColor.rgb, 如"FF0000FF" 为蓝色（前两个FF忽略）；
cell.font，字体样式；
- 返回openpyxl.styles.fonts.Font对象；
- font.name 使用的字体名称；
- font.family 使用字体的编号；
- font.b 是否加粗；
- font.i 是否倾斜；
- font.color 字体颜色，返回Color对象；
cell.has_style 判断单元格是否有样式，返回True/False;
- alignment、border、fill、font、protection都是样式；
cell.style，单元格类型（常规、超链接）；.style_id为对应的编号；
cell.number_format
cell.pivotButton
cell.protection 单元格是否锁定，避免误操作；
- 必须先开启工作表保护(开始-格式-工作表保护)，再设置单元格的格式（右键），勾选锁定，才会锁定该单元格（禁止编辑）；
- 如图：
- 返回openpyxl.styles.protection.Protection对象；
- protection.locked 是否为锁定；
- protection.hidden 是否为隐藏；

MergedCell

合并的单元格，openpyxl.cell.cell.MergedCell 类；
合并的单元格的值，只在最左上角的cell中，其他的cell中的值均为None;
worksheet.merged_cells，获取所有的合并的单元格；返回openpyxl.worksheet.cell_range.MultiCellRange的可迭代对象；
遍历MultiCellRange对象得到openpyxl.worksheet.merge.MergedCellRange对象，属性如下：
- i.bottom # 合并区域的最下面一行cell的（rid, cid），同样有left 最左边一列，right最右边一列，top最上边一行的cell;
- i.bounds # 左上角、右下角cell的（cid, rid）
- i.cells 所有的单元格，可以逐一遍历
- i.rows 所有的行可迭代对象
- i.cols 所有的列
- i.coord 起始：结束范围
- i.min_row/max_row/min_col/max_col;
- i.start_cell 左上角的起始cell;
- i.size 整体大小，行数&列数；
- i.ws 获取worksheet对象；
案例，输出合并单元格区域的所有cell;


ws = wb_a["sheet"]
# MultiCellRange
t = ws.merged_cells

for i in t:
    # i 为 MergedCellRange
    for r in range(i.max_row - i.min_row + 1):
        start_row, start_col = i.start_cell.row, i.start_cell.column
        cur_row = start_row + r
        for c in range(i.max_col - i.min_col + 1):
            cur_col = start_col + c
            cell = ws.cell(cur_row, cur_col)
            print(cur_row, cur_col, cell, cell.value)