
# ['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-6、openpyxl.Workbook.get_index方法

3-6-1、语法


get_index(self, worksheet)
    Return the index of the worksheet.
    
    .. note::
        Deprecated: Use wb.index(worksheet)

3-6-2、参数

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

3-6-2-2、worksheet(必须)：一个工作表对象，表示要获取索引的工作表对象。

3-6-3、功能

用于获取已知工作表在工作簿中的索引。

3-6-4、返回值

返回一个整数，代表工作表在工作簿中的索引位置，从0开始。

3-6-5、说明

无

3-6-6、用法


# 6、openpyxl.Workbook.get_index方法
from openpyxl import Workbook
# 创建一个新的工作簿
wb = Workbook()
# 获取活动工作表
active_sheet = wb.active
# 在工作簿中添加新工作表
new_sheet = wb.create_sheet("New Sheet")
# 获取工作表的索引
index = wb.get_index(new_sheet)
print(f"新工作表的索引是：{index}")

3-7、openpyxl.Workbook.get_sheet_by_name方法

3-7-1、语法


get_sheet_by_name(self, name)
    Returns a worksheet by its name.
    
            :param name: the name of the worksheet to look for
            :type name: string
    
            
    
    .. note::
        Deprecated: Use wb[sheetname]

3-7-2、参数

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

3-7-2-2、name(必须)：一个字符串，表示要获取的工作表的名称。

3-7-3、功能

用于根据工作表名称获取相应的工作表。

3-7-4、返回值

返回对应工作表对象。如果名称不匹配或工作表不存在，可能会抛出KeyError异常。

3-7-5、说明

该方法从openpyxl 2.5版本开始已被弃用，并在之后的版本中被正式移除。推荐使用Workbook[sheet_name]或Workbook.get_sheet_by_name(sheet_name)来代替。

3-7-6、用法


# 7、openpyxl.Workbook.get_sheet_by_name方法
from openpyxl import Workbook
# 创建一个新的工作簿
wb = Workbook()
# 创建一个新工作表
wb.create_sheet("NewSheet")
# 使用推荐的方法根据名称获取工作表
sheet = wb["NewSheet"]
# 使用已弃用方法根据名称获取工作表
# sheet = wb.get_sheet_by_name("NewSheet")  # 仍然可用，但不建议使用
print(f"获取到的工作表名称是：{sheet.title}")

3-8、openpyxl.Workbook.get_sheet_names方法

3-8-1、语法


get_sheet_names(self)
    .. note::
        Deprecated: Use wb.sheetnames

3-8-2、参数

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

3-8-3、功能

用于获取工作簿中所有工作表的名称列表。

3-8-4、返回值

返回一个包含工作簿中所有工作表名称的列表。

3-8-5、说明

该方法在openpyxl 2.5版本中被弃用，并在之后的版本中被移除。推荐使用wb.sheetnames属性来替代。

3-8-6、用法


# 8、openpyxl.Workbook.get_sheet_names方法
from openpyxl import Workbook
# 创建一个新的工作簿
wb = Workbook()
# 使用已弃用方法获取所有工作表的名称
# sheet_names = wb.get_sheet_names() # 仍然可用，但不建议使用
# 使用推荐方法获取所有工作表的名称
sheet_names = wb.sheetnames
print(sheet_names)

3-9、openpyxl.Workbook.index方法

3-9-1、语法


index(self, worksheet)
    Return the index of a worksheet.

3-9-2、参数

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

3-9-2-2、worksheet(必须)：一个Worksheet对象，表示需要获取索引位置的工作表对象。

3-9-3、功能

用于获取指定工作表在工作簿中的索引位置。

3-9-4、返回值

返回一个整数，表示指定工作表在工作簿中的索引位置，从0开始计数。

3-9-5、说明

3-9-5-1、确保worksheet是属于当前工作簿的一个有效工作表对象。

3-9-5-2、如果指定的工作表不在工作簿中，将会引发ValueError异常，因此在调用该方法前，可以先检查工作表是否在工作簿中。通过这种方式，你可以轻松获取任何工作表在工作簿中的索引位置，以便在其他操作中使用。

3-9-6、用法


# 9、openpyxl.Workbook.index方法
from openpyxl import Workbook
# 创建一个新的工作簿
wb = Workbook()
# 创建新的工作表
ws1 = wb.create_sheet(title="Sheet1")
ws2 = wb.create_sheet(title="Sheet2")
# 获取工作表索引
index_ws1 = wb.index(ws1)
index_ws2 = wb.index(ws2)
print(f"Sheet1 的索引位置是: {index_ws1}")
print(f"Sheet2 的索引位置是: {index_ws2}")

3-10、openpyxl.Workbook.move_sheet方法

3-10-1、语法


move_sheet(self, sheet, offset=0)
    Move a sheet or sheetname

3-10-2、参数

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

3-10-2-2、sheet(必须)：一个worksheet对象，表示需要移动的工作表对象。

3-10-2-3、offset(可选)：一个整数(默认值为0)，表示移动的偏移量，可以是正数(向右移动)或负数(向左移动)。

3-10-3、功能

用于在工作簿中移动工作表到新的位置。

3-10-4、返回值

该方法没有返回值，但会直接在工作簿中移动指定的工作表。

3-10-5、说明

3-10-5-1、有效范围：offset参数的值必须在有效范围内，即不能超出工作表的总数量范围。如果offset超出范围，会引发IndexError异常。

3-10-5-2、方向：正数offset表示向右移动，负数 offset表示向左移动。

3-10-5-3、引用：确保传入的sheet对象是当前工作簿中的有效工作表。

3-10-6、用法


# 10、openpyxl.Workbook.move_sheet方法
from openpyxl import Workbook
# 创建一个新的工作簿
wb = Workbook()
# 创建多个工作表
ws1 = wb.create_sheet(title="Sheet1")
ws2 = wb.create_sheet(title="Sheet2")
ws3 = wb.create_sheet(title="Sheet3")
# 初始工作表顺序
print([sheet.title for sheet in wb.worksheets])
# 将 "Sheet3" 移动到第一个位置
wb.move_sheet(ws3, -2)
# 移动后的工作表顺序
print([sheet.title for sheet in wb.worksheets])

五、推荐阅读

1、Python筑基之旅

2、Python函数之旅

3、Python算法之旅

4、Python魔法之旅

5、博客个人主页

声明：本文内容由网友自发贡献，不代表【wpsshop博客】立场，版权归原作者所有，本站不承担相应法律责任。如您发现有侵权的内容，请联系我们。转载请注明出处：https://www.wpsshop.cn/w/代码探险家/article/detail/855833