Python Xlsxwriter 简明教程

Python XlsxWriter - Cell Comments

在 Excel 工作表中,可以出于各种原因插入 comments 。一种用法是解释单元格中的公式。此外,Excel 批注还可以作为其他用户提醒或笔记。它们对于与其他 Excel 工作簿交叉引用很有用。

从 Excel 的菜单系统,可在功能区中的“审阅”菜单中找到批注功能。

comment

若要添加和设置批注的格式,XlsxWriter 具有 add_comment() 方法。该方法的两个必需参数是 cell location (A1 类型或行号和列号)和 comment text

Example

以下是一个简单示例:

import xlsxwriter

wb = xlsxwriter.Workbook('hello.xlsx')
ws = wb.add_worksheet()

data='XlsxWriter Library'

ws.set_column('C:C', 25)
ws.set_row(2, 50)
ws.write('C3', data)

text = 'Developed by John McNamara'
ws.write_comment('C3', text)

wb.close()

Output

当我们打开工作簿,然后将光标置于 C3 单元格顶部右侧的标记上时,将看到一个带有批注。

comment1

默认情况下,批注不可见,直到光标悬停在写入批注的单元格上。可以通过调用工作表对象的 show_comment() 方法或者将单个批注的可见属性设置为 True 来显示工作表中的所有批注。

ws.write_comment('C3', text, {'visible': True})

Example

在以下代码中,放置了三条批注。但是,C3单元格中的一个已配置为可见属性设置为 False。因此,在光标置于该单元格之前看不到它。

import xlsxwriter

wb = xlsxwriter.Workbook('hello.xlsx')
ws = wb.add_worksheet()

ws.show_comments()

data='Python'
ws.set_column('C:C', 25)
ws.set_row(0, 50)
ws.write('C1', data)
text = 'Programming language developed by Guido Van Rossum'
ws.write_comment('C1', text)
data= 'XlsxWriter'
ws.set_row(2, 50)
ws.write('C3', data)
text = 'Developed by John McNamara'
ws.write_comment('C3', text, {'visible':False})
data= 'OpenPyXl'
ws.set_row(4, 50)
ws.write('C5', data)
text = 'Developed by Eric Gazoni and Charlie Clark'
ws.write_comment('C5', text, {'visible':True})

wb.close()

Output

它将生成如下输出:

show comment

可以设置 author 选项以指示单元格批注的作者。批注的作者还显示在工作表底部的状态栏中。

worksheet.write_comment('C3', 'Atonement', {'author': 'Tutorialspoint'})

可以使用 set_comments_author() 方法设置所有单元格批注的默认作者:

worksheet.set_comments_author('Tutorialspoint')

它将生成如下输出:

set comments author