详解xlwt的 Worksheet.get_printer_settings 函数：返回打印机设置

函数作用

Worksheet.get_printer_settings函数主要用于获取指定工作表的打印设置，包括各项打印属性的设置，如打印页面设置、打印机设置、打印区域设置、打印标头和标尾等属性。

函数使用方法

例如，我们创建一个工作簿，然后在其中添加一个工作表并设置一些打印属性后，可以使用下列代码获取该工作表的打印设定信息：

import xlwt

# 创建一个工作簿
workbook = xlwt.Workbook(encoding='utf-8')

# 创建一个工作表
worksheet = workbook.add_sheet('my_worksheet')

# 设置打印属性
worksheet.print_paper_size = 9
worksheet.show_grid = False
worksheet.horz_print_scaling = 55

# 获取打印设定信息
print_settings = worksheet.get_printer_settings()

print_settings_dict = {
    "orientation": print_settings.orientation,
    "paper_size_code": print_settings.paper_size_code,
    "scaling": print_settings.scaling,
    "horz_dpi": print_settings.horz_dpi,
    "vert_dpi": print_settings.vert_dpi,
    "port_name": print_settings.port_name,
    "copies": print_settings.copies,
    "landscape": print_settings.landscape,
    "preview": print_settings.preview,
    "print_area": print_settings.print_area,
    "left_margin": print_settings.left_margin,
    "right_margin": print_settings.right_margin,
    "top_margin": print_settings.top_margin,
    "bottom_margin": print_settings.bottom_margin,
    "header_margin": print_settings.header_margin,
    "footer_margin":print_settings.footer_margin,
    "h_centering": print_settings.h_centering,
    "v_centering": print_settings.v_centering,
    "print_labels": print_settings.print_labels,
    "draft_quality": print_settings.draft_quality,
    "cell_error": print_settings.cell_error,
    "errors_received": print_settings.errors_received,
    "print_no_color": print_settings.print_no_color,
}

print(print_settings_dict)

在上述代码中，我们创建了一个工作簿，并添加一个名为“my_worksheet”的工作表。然后，我们设置了几个打印属性，包括纸张大小、打印区域、缩放比例、打印线网格等属性。接下来，我们使用 get_printer_settings 函数获取该工作表的打印设置信息，并把获取到的信息以字典的形式输出。

输出结果：

{
    "orientation": 1,
    "paper_size_code": 9,
    "scaling": 55,
    "horz_dpi": 0,
    "vert_dpi": 0,
    "port_name": "",
    "copies": 1,
    "landscape": 0,
    "preview": 0,
    "print_area": "",
    "left_margin": 720,
    "right_margin": 720,
    "top_margin": 720,
    "bottom_margin": 720,
    "header_margin": 720,
    "footer_margin": 720,
    "h_centering": 0,
    "v_centering": 0,
    "print_labels": 0,
    "draft_quality": 0,
    "cell_error": 0,
    "errors_received": 0,
    "print_no_color": 0,
}

在输出结果中，我们可以看到该工作表的打印设置信息，包括纸张方向、纸张大小、打印区域等等打印属性。

案例分析

修改打印设备名称

假设我们需要将上面的“my_worksheet”工作表的打印设备从默认的“Microsoft Print to PDF”改为“XPS 显示”。则可以使用下列代码进行设置：

import win32print

def set_printer_port_name(worksheet, printer_name):
    print_settings = worksheet.get_printer_settings()
    print_settings.port_name = win32print.GetPrinter(printer_name)[2]
    worksheet.set_printer_settings(print_settings)
    worksheet.preview() # 可以用 preview() 方法查看是否使用了新的打印设备名称

运行上述代码即可完成打印设备的设置。

获取打印区域的最大行和列

假如我们需要获取工作表的打印区域中实际有数据填充的最大行和列, 则可以使用类似如下代码编写：

import xlwt

workbook = xlwt.Workbook(encoding='utf-8')
worksheet = workbook.add_sheet('my_worksheet')

# 设置打印区域
worksheet.print_area = "A1:H100"

# 创建数据
for row in range(10):
    for col in range(4):
        worksheet.write(row, col, f"({row}, {col})")

# 获取打印区域的行和列
print_row = worksheet.get_usedrows()
print_col = worksheet.get_usedcols()

print(f"print range: A1:{print_col}{print_row}")

运行上述代码，可以输出打印区域的最大行和列，例如：

print range: A1:D10

总结

在实际工作中，可以使用 get_printer_settings 函数获取Excel表格的打印实际，并获取各种打印设备的参数信息。可以有力地帮助工程师进行对于打印设备的一系列自动化操作。