详解xlwt的 Worksheet.panes_frozen 函数：冻结窗格

xlwt的Worksheet.panes_frozen函数详解

1.作用

Worksheet.panes_frozen用于设置excel中的冻结窗格（Frozen Panes），即保留excel中某些行或列不随滚动条滚动而移动。这个函数最常用的情景是，在表格顶部设置一行表头，然后对表头进行冻结，使得用户在浏览长列表时，始终能看到表头。

2.语法

Worksheet.panes_frozen(cols, rows, top_row, left_col)

• cols: 冻结窗格左边的列数。例如，如果你想冻结A列和B列，那么cols应该设置成2。
• rows: 冻结窗格上边的行数。例如，如果你想冻结前两行，那么rows应该设置成2。
• top_row: 冻结窗格上边的区域末尾行的索引。例如，如果你要冻结第一行和第二行，那么top_row应该设置成2。
• left_col: 冻结窗格左边的区域末尾列的索引。例如，如果你要冻结第一列和第二列，那么left_col应该设置成2。

3.实例

3.1 冻结左侧列

下面是一个例子，演示如何冻结左侧的一列：

import xlwt

# 创建一个Workbook对象，生成一个Sheet对象
book = xlwt.Workbook(encoding='utf-8')
sheet = book.add_sheet('Sheet1')

# 写入数据
sheet.write(0, 0, 'Name')
sheet.write(1, 0, 'Alice')
sheet.write(2, 0, 'Bob')
sheet.write(3, 0, 'Charlie')

# 冻结首列
sheet.panes_frozen(1, 0, 1, 0)

# 保存Excel文件
book.save('example.xls')

3.2 冻结多行多列

下面是一个例子，演示如何冻结前两行和前两列：

import xlwt

# 创建一个Workbook对象，生成一个Sheet对象
book = xlwt.Workbook(encoding='utf-8')
sheet = book.add_sheet('Sheet1')

# 写入数据
for i in range(5):
    for j in range(5):
        sheet.write(i, j, '%d-%d' % (i, j))

# 冻结前两行和两列
sheet.panes_frozen(2, 2, 2, 2)

# 保存Excel文件
book.save('example.xls')

在这个例子中，我们冻结了前两行和前两列，因此，当用户向下滚动表格时，前两行和前两列会始终保持在表格的顶端和左侧，不会移动。

4.注意事项

• Worksheet.panes_frozen方法只能在当前的工作表中调用，而不能通过Workbook对象来调用。
• 参数cols和rows的值必须大于等于1，否则将抛出异常。
• 由于xlwt本身的限制，Worksheet.panes_frozen方法只能使得最多一个水平与一个垂直偏移百分比来指定一个想要固定的窗格的单元格成为窗格左上角。