Python XlsxWriter - 单元格注释


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

在 Excel 的菜单系统中,功能区的“审阅”菜单上提供了注释功能。

评论

要添加和格式化注释,XlsxWriter 有add_comment()方法。此方法的两个强制参数是单元格位置(A1 类型或行号和列号)和注释文本

例子

这是一个简单的例子 -

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()

输出

当我们打开工作簿时,当光标放置在 C3 单元格的右上角时,将看到带有标记的注释。

评论1

默认情况下,只有当光标悬停在写入注释的单元格上时,注释才可见。您可以通过调用工作表对象的show_comment()方法来显示工作表中的所有注释,也可以将单个注释的可见属性设置为 True。

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

例子

在下面的代码中,放置了三个注释。然而,单元格 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()

输出

它将产生以下输出 -

显示评论

您可以设置作者选项来指示谁是单元格评论的作者。评论的作者也会显示在工作表底部的状态栏中。

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

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

worksheet.set_comments_author('Tutorialspoint')

它将产生以下输出 -

设置评论作者