Python酷库之旅-第三方库openpyxl(04)

# ['DEBUG', 'DEFUSEDXML', 'LXML', 'NUMPY', 'Workbook', '__author__', '__author_email__', '__builtins__', '__cached__', 
# '__doc__', '__file__', '__license__', '__loader__', '__maintainer_email__', '__name__', '__package__', '__path__',
# '__spec__', '__url__', '__version__', '_constants', 'cell', 'chart', 'chartsheet', 'comments', 'compat', 'constants',
# 'descriptors', 'drawing', 'formatting', 'formula', 'load_workbook', 'open', 'packaging', 'pivot', 'reader', 'styles',
# 'utils', 'workbook', 'worksheet', 'writer', 'xml']

2、获取openpyxl库的帮助信息

用help()函数获取openpyxl库的帮助信息

Help on package openpyxl:

NAME
    openpyxl - # Copyright (c) 2010-2024 openpyxl

PACKAGE CONTENTS
    _constants
    cell (package)
    chart (package)
    chartsheet (package)
    comments (package)
    compat (package)
    descriptors (package)
    drawing (package)
    formatting (package)
    formula (package)
    packaging (package)
    pivot (package)
    reader (package)
    styles (package)
    utils (package)
    workbook (package)
    worksheet (package)
    writer (package)
    xml (package)

SUBMODULES
    constants

DATA
    DEBUG = False
    DEFUSEDXML = False
    LXML = True
    NUMPY = True
    __author_email__ = 'charlie.clark@clark-consulting.eu'
    __license__ = 'MIT'
    __maintainer_email__ = 'openpyxl-users@googlegroups.com'
    __url__ = 'https://openpyxl.readthedocs.io'

VERSION
    3.1.3

AUTHOR
    See AUTHORS

FILE
    e:\python_workspace\pythonproject\lib\site-packages\openpyxl\__init__.py

3、用法精讲

3-16、openpyxl.worksheet.worksheet.Worksheet.add_chart函数

3-16-1、语法

add_chart(self, chart, anchor=None)
    Add a chart to the sheet
    Optionally provide a cell for the top-left anchor

3-16-2、参数

3-16-2-1、self(必须)：一个对实例对象本身的引用，在类的所有方法中都会自动传递。

3-16-2-2、chart(必须)：一个Chart对象，表示要添加的图表对象，可以是柱形图、折线图、饼图等不同类型的图表。

3-16-2-3、anchor(可选)：一个单元格引用或一个指定图表位置和大小的Anchor对象，表示图表的锚定位置。

3-16-3、功能

用于向工作表中添加图表。

3-16-4、返回值

没有明确的返回值。它的作用是向工作表中添加图表对象，而不是返回任何数值或对象。

3-16-5、说明

如果不指定anchor参数，图表将被添加到工作表的A1单元格的左上角。

3-16-6、用法

# 16、openpyxl.worksheet.worksheet.Worksheet.add_chart函数
from openpyxl import Workbook
from openpyxl.chart import BarChart, Reference
wb = Workbook()
ws = wb.active
# 创建数据
data = [
    ['Number', 'Batch 1', 'Batch 2'],
    [2, 40, 30],
    [3, 40, 25],
    [4, 50, 30],
    [5, 30, 10],
    [6, 25, 5],
]
for row in data:
    ws.append(row)
# 创建图表引用
cat = Reference(ws, min_col=1, min_row=1, max_row=6)
val1 = Reference(ws, min_col=2, min_row=1, max_row=6)
val2 = Reference(ws, min_col=3, min_row=1, max_row=6)
# 创建图表对象
chart = BarChart()
chart.add_data(val1, titles_from_data=True)
chart.add_data(val2, titles_from_data=True)
chart.set_categories(cat)
chart.title = "Batch Chart"
chart.x_axis.title = "Number"
chart.y_axis.title = "Value"
# 将图表添加到工作表
ws.add_chart(chart, "A8")
wb.save("chart.xlsx")

3-17、openpyxl.worksheet.worksheet.Worksheet.add_data_validation函数

3-17-1、语法

add_data_validation(self, data_validation)
    Add a data-validation object to the sheet.  The data-validation
    object defines the type of data-validation to be applied and the
    cell or range of cells it should apply to.

3-17-2、参数

3-17-2-1、self(必须)：一个对实例对象本身的引用，在类的所有方法中都会自动传递。

3-17-2-2、data_validation(必须)：一个数据验证对象，定义了数据验证的类型和规则。通过该对象，可以设置数据输入的限制条件，例如只允许输入整数、日期范围等。

3-17-3、功能

用于在工作表中添加数据验证规则。

3-17-4、返回值

没有返回值，其作用是将指定的数据验证对象添加到工作表中，以便对特定单元格范围应用数据验证规则。

3-17-5、说明

一个void类型的方法，只负责执行操作，而不返回任何值。

3-17-6、用法

# 17、openpyxl.worksheet.worksheet.Worksheet.add_data_validation函数
from openpyxl import Workbook
from openpyxl.worksheet.datavalidation import DataValidation
# 创建一个新的工作簿和工作表
wb = Workbook()
ws = wb.active
# 创建一个数据验证对象，设置规则为整数，范围为 1 到 10
dv = DataValidation(type="whole", operator="between", formula1=1, formula2=10, showErrorMessage=True)
# 将数据验证规则添加到工作表
ws.add_data_validation(dv)
# 将数据验证规则应用到单元格范围 A1 到 A10
dv.add('A1:A10')
# 保存工作簿
wb.save("example.xlsx")

3-18、openpyxl.worksheet.worksheet.Worksheet.add_image函数

3-18-1、语法

add_image(self, img, anchor=None)
    Add an image to the sheet.
    Optionally provide a cell for the top-left anchor

3-18-2、参数

3-18-2-1、self(必须)：一个对实例对象本身的引用，在类的所有方法中都会自动传递。

3-18-2-2、img(必须)：一个openpyxl.drawing.image.Image对象，表示要插入的图片。

3-18-2-3、anchor(可选)：一个字符串，表示 Excel 单元格的位置(例如 A1，B2)，即指定图片插入的位置。

3-18-3、功能

用于在工作表中添加图片。

3-18-4、返回值

没有返回值，它的作用是将指定的图片对象插入到工作表中的特定位置。

3-18-5、说明

无

3-18-6、用法

# 18、openpyxl.worksheet.worksheet.Worksheet.add_image函数
from openpyxl import Workbook
from openpyxl.drawing.image import Image
# 创建一个新的工作簿和工作表
wb = Workbook()
ws = wb.active
# 加载图片，请根据实际情况自行调整修改
img = Image(R'E:\360Downloads\凤凰.png')
# 将图片添加到工作表
# 如果不指定 anchor 参数，默认插入到 'A1' 位置
ws.add_image(img)
# 如果指定 anchor 参数，例如 'B2'，则图片将插入到 B2 单元格位置
# ws.add_image(img, anchor='B2')
# 保存工作簿
wb.save("example_with_image.xlsx")

3-19、openpyxl.worksheet.worksheet.Worksheet.add_table函数

3-19-1、语法

add_table(self, table)
    Check for duplicate name in definedNames and other worksheet tables
    before adding table.

3-19-2、参数

3-19-2-1、self(必须)：一个对实例对象本身的引用，在类的所有方法中都会自动传递。

3-19-2-2、table(必须)：一个Table对象，表示要添加到工作表中的表格。

3-19-3、功能

用于将表格(Table)添加到工作表中。

3-19-4、返回值

没有返回值，它主要用于配置和添加表格到工作表中。

3-19-5、说明

3-19-5-1、创建工作簿和工作表

wb = Workbook()
ws = wb.active
ws.title = "Data"

3-19-5-2、添加数据到工作表

data = [
    ["Item", "Category", "Amount"],
    ["Item1", "A", 10],
    ["Item2", "B", 20],
    ["Item3", "A", 30],
    ["Item4", "B", 40],
    ["Item5", "A", 50],
]

for row in data:
    ws.append(row)

3-19-5-3、定义表格范围和创建表格对象

table_start = "A1"
table_end = f"C{len(data)}"
table_range = f"{table_start}:{table_end}"

table = Table(displayName="DataTable", ref=table_range)

3-19-5-4、应用表格样式

style = TableStyleInfo(
    name="TableStyleMedium9",
    showFirstColumn=False,
    showLastColumn=False,
    showRowStripes=True,
    showColumnStripes=True
)
table.tableStyleInfo = style

3-19-5-5、将表格添加到工作表中并保存工作簿

ws.add_table(table)
file_path = "example_with_table.xlsx"
wb.save(file_path)

3-19-5-6、Table对象的创建及其主要属性和方法

from openpyxl.worksheet.table import Table, TableStyleInfo

# 创建一个Table对象
table = Table(displayName="Table1", ref="A1:D5")

# 设置表格样式
style = TableStyleInfo(name="TableStyleMedium9", showFirstColumn=False,
                       showLastColumn=False, showRowStripes=True, showColumnStripes=True)
table.tableStyleInfo = style

# displayName: 表格的名称，必须在工作簿中唯一。
# ref: 表格的单元格区域引用，例如"A1:D5"。
# tableStyleInfo: 一个TableStyleInfo对象，用于定义表格的样式。

3-19-6、用法

# 19、openpyxl.worksheet.worksheet.Worksheet.add_table函数
from openpyxl import Workbook
from openpyxl.worksheet.table import Table, TableStyleInfo
# 创建一个新的工作簿和工作表
wb = Workbook()
ws = wb.active
ws.title = "Data"
# 添加一些示例数据
data = [
    ["Item", "Category", "Amount"],
    ["Item1", "A", 10],
    ["Item2", "B", 20],
    ["Item3", "A", 30],
    ["Item4", "B", 40],
    ["Item5", "A", 50],
]
# 将数据写入工作表
for row in data:
    ws.append(row)
# 定义表的范围
table_start = "A1"
table_end = f"C{len(data)}"
table_range = f"{table_start}:{table_end}"
# 创建一个表格对象
table = Table(displayName="DataTable", ref=table_range)
# 为表格应用样式
style = TableStyleInfo(
    name="TableStyleMedium9",
    showFirstColumn=False,
    showLastColumn=False,
    showRowStripes=True,
    showColumnStripes=True
)
table.tableStyleInfo = style
# 将表格添加到工作表中
ws.add_table(table)
# 保存工作簿
file_path = "example_with_table.xlsx"
wb.save(file_path)
print(f"表格已经添加并保存在 {file_path} 中")

3-20、openpyxl.worksheet.worksheet.Worksheet.append函数

3-20-1、语法

append(self, iterable)
    Appends a group of values at the bottom of the current sheet.
    
    * If it's a list: all values are added in order, starting from the first column
    * If it's a dict: values are assigned to the columns indicated by the keys (numbers or letters)
    
    :param iterable: list, range or generator, or dict containing values to append
    :type iterable: list|tuple|range|generator or dict
    
    Usage:
    
    * append(['This is A1', 'This is B1', 'This is C1'])
    * **or** append({'A' : 'This is A1', 'C' : 'This is C1'})
    * **or** append({1 : 'This is A1', 3 : 'This is C1'})
    
    :raise: TypeError when iterable is neither a list/tuple nor a dict

3-20-2、参数

3-20-2-1、self(必须)：一个对实例对象本身的引用，在类的所有方法中都会自动传递。

3-20-2-2、iterable(必须)：一个可迭代对象，表示你想要追加到工作表中的一行数据。可迭代对象可以是列表、元组或其他任何Python对象，该对象有一个可以遍历的集合。

3-20-3、功能

用于向工作表中追加一行数据。

3-20-4、返回值

没有返回值，它仅仅是将数据添加到工作表中，而不返回任何信息。

3-20-5、说明

3-20-5-1、如果可迭代对象的长度超过工作表中已有的列数，则会自动扩展列数。

3-20-5-2、如果可迭代对象的长度少于工作表中已有的列数，则将会补齐缺失的列为空值。

3-20-6、用法

# 20、openpyxl.worksheet.worksheet.Worksheet.append函数
from openpyxl import Workbook
# 创建新的工作簿
wb = Workbook()
# 激活工作表
ws = wb.active
# 追加一行数据（列表）
ws.append([1, 2, 3])
# 追加一行数据（元组）
ws.append((4, 5, 6))
# 也可以追加包含字典的列表，字典的键将被作为列名
data = [
    {"A": 7, "B": 8, "C": 9},
    {"A": 10, "B": 11, "C": 12}
]
for row in data:
    ws.append(row)
# 保存文件
wb.save("example.xlsx")