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

# ['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、获取xlwt库的帮助信息

用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-31、openpyxl.worksheet.worksheet.Worksheet.set_printer_settings函数

3-31-1、语法

set_printer_settings(self, paper_size, orientation)
    Set printer settings

3-31-2、参数

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

3-31-2-2、paper_size(可选)：指定打印时使用的纸张大小。

3-31-2-3、orientation(可选)：设置打印方向，指定打印时是纵向还是横向。

3-31-3、功能

设置工作表的打印配置，包括纸张大小、方向、页边距等。

3-31-4、返回值

没有返回值，它通过直接修改工作表对象的属性来应用打印设置。

3-31-5、说明

无

3-31-6、用法

# 31、openpyxl.worksheet.worksheet.Worksheet.set_printer_settings函数
from openpyxl import Workbook
from openpyxl.worksheet.page import PageSetup
# 创建一个新的工作簿和工作表
wb = Workbook()
ws = wb.active
# 设置打印设置
ws.set_printer_settings(paper_size=PageSetup.PAPERSIZE_A4, orientation=PageSetup.ORIENTATION_LANDSCAPE)
# 保存工作簿
wb.save("example.xlsx")

3-32、openpyxl.worksheet.worksheet.Worksheet.unmerge_cells函数

3-32-1、语法

unmerge_cells(self, range_string=None, start_row=None, start_column=None, end_row=None, end_column=None)
    Remove merge on a cell range.  Range is a cell range (e.g. A1:E1)

3-32-2、参数

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

3-32-2-2、range_string(可选)：一个字符串，表示要取消合并的单元格范围。例如，"A1:D1" 表示从A1单元格到D1单元格的范围。

3-32-2-3、start_row(可选)：一个整数(默认值为None)，表示要取消合并的起始行索引。

3-32-2-4、start_column(可选)：一个整数(默认值为None)，表示要取消合并的起始列索引。

3-32-2-5、end_row(可选)：一个整数(默认值为None)，表示要取消合并的结束行索引。

3-32-2-6、end_column(可选)：一个整数(默认值为None)，表示要取消合并的结束列索引。

3-32-3、功能

用于取消工作表中的合并单元格，该函数通过指定合并区域的范围，将该范围内的所有单元格恢复为独立的单元格。

3-32-4、返回值

没有返回值。它直接对工作表进行操作，取消指定范围内的合并单元格，而不会返回任何数据。

3-32-5、说明

无

3-32-6、用法

# 32、openpyxl.worksheet.worksheet.Worksheet.unmerge_cells函数
from openpyxl import Workbook
# 创建一个新的工作簿和工作表
wb = Workbook()
ws = wb.active
# 合并单元格
ws.merge_cells('A1:D1')
# 取消合并单元格
ws.unmerge_cells('A1:D1')  # 没有返回值
# 保存工作簿
wb.save("example.xlsx")

3-33、openpyxl.cell.cell.Cell.check_error函数

3-33-1、语法

check_error(self, value)
    Tries to convert Error" else N/A

3-33-2、参数

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

3-33-2-2、value(必须)：一个字符串或数值，表示需要检查的值。

3-33-3、功能

用于检测单元格中的内容是否为错误值。

3-33-4、返回值

返回一个布尔值。如果单元格中的值是错误值，则返回True；反之，则返回False。

3-33-5、说明

3-33-5-1、该方法仅检查传入的值是否为标准的Excel错误值，并不涉及单元格中的公式或其他内容。

3-33-5-2、检查的错误值是固定的，主要包括#DIV/0!、#N/A、#NAME?、#NULL!、#NUM!、#REF!和#VALUE!等。

3-33-6、用法

# 33、openpyxl.cell.cell.Cell.check_error函数
from openpyxl import Workbook
# 创建一个新的工作簿和工作表
wb = Workbook()
ws = wb.active
# 设置一些单元格值，包括一个错误值
ws['A1'] = 5
ws['A2'] = 0
ws['A3'] = '=A1/A2'  # 这是一个错误值，会导致 #DIV/0!
# 检查单元格A3是否有错误
cell = ws['A3']
has_error = cell.check_error("#DIV/0!")
print(f"Cell A3 has error: {has_error}") # 输出：Cell A3 has error: #DIV/0!
# 保存工作簿
wb.save("example.xlsx")

3-34、openpyxl.cell.cell.Cell.check_string函数

3-34-1、语法

check_string(self, value)
    Check string coding, length, and line break character

3-34-2、参数

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

3-34-2-2、value(必须)：一个字符串，表示需要检查的值。

3-34-3、功能

用于检查传入的值是否为一个有效的字符串。

3-34-4、返回值

3-34-4-1、如果value是一个有效的字符串，此方法不会返回任何内容。

3-34-4-2、如果value不是一个有效的字符串，此方法会引发TypeError或ValueError异常。

3-34-5、说明

3-34-5-1、此方法仅检查值是否为字符串，并不检查字符串的长度或内容是否符合其他特定要求。

3-34-5-2、如果传入的值不是字符串或包含非法字符，该方法会引发异常，而不是返回一个布尔值。

3-34-6、用法

# 34、openpyxl.cell.cell.Cell.check_string函数
from openpyxl import Workbook
from openpyxl.cell import Cell
# 创建一个新的工作簿和工作表
wb = Workbook()
ws = wb.active
# 创建一个单元格对象
cell = Cell(ws, 'A1')
# 一个有效的字符串值
value = "Hello, OpenPyxl!"
# 检查值是否为有效的字符串
try:
    cell.check_string(value)
    print(f"The value '{value}' is a valid string.")
except (TypeError, ValueError) as e:
    print(f"The value '{value}' is not a valid string: {e}")
# 一个无效的值（例如，包含非法字符或不是字符串）
invalid_value = 12345
try:
    cell.check_string(invalid_value)
    print(f"The value '{invalid_value}' is a valid string.")
except (TypeError, ValueError) as e:
    print(f"The value '{invalid_value}' is not a valid string: {e}")
# 保存工作簿
wb.save("example.xlsx")
# The value 'Hello, OpenPyxl!' is a valid string.
# The value '12345' is not a valid string: decoding to str: need a bytes-like object, int found

3-35、openpyxl.cell.cell.Cell.offset函数

3-35-1、语法

offset(self, row=0, column=0)
    Returns a cell location relative to this cell.
    
    :param row: number of rows to offset
    :type row: int
    
    :param column: number of columns to offset
    :type column: int
    
    :rtype: :class:`openpyxl.cell.Cell`

3-35-2、参数

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

3-35-2-2、row(可选)：一个整数类型(默认为 0，即不进行行偏移)，表示指定相对于当前单元格的行偏移量。正值表示向下偏移，负值表示向上偏移。

3-35-2-3、 column(可选)：一个整数类型(默认为 0，即不进行列偏移)，表示指定相对于当前单元格的列偏移量。正值表示向右偏移，负值表示向左偏移。

3-35-3、功能

用于在 Excel 工作表中相对于当前单元格的位置偏移。

3-35-4、返回值

返回一个新的Cell对象，表示相对于当前单元格位置的偏移位置的单元格。

3-35-5、说明

无

3-35-6、用法

# 35、openpyxl.cell.cell.Cell.offset函数
from openpyxl import Workbook
# 创建一个新的工作簿和工作表
wb = Workbook()
ws = wb.active
# 在A1单元格中写入数据
cell = ws['A1']
cell.value = "Hello"
# 偏移函数：获取当前单元格偏移1行2列的位置
offset_cell = cell.offset(row=1, column=2)
# 在偏移位置的单元格中写入数据
offset_cell.value = "World"
# 保存工作簿
wb.save("example.xlsx")