如何使用 Python openpyxl 套件操作 Excel 註解?openpyxl Comment 物件介紹
閱讀本節的先決條件是已經了解 Excel 儲存格物件Cell
,你可以檢視如何使用 Python openpyxl 套件操作 Excel 儲存格?openpyxl Cell 物件介紹一節來取得相關資訊。
Python openpyxl 套件中的 Excel 註解物件 Comment
Pythonopenpyxl
套件中的Comment
類別,屬於模組openpyxl.comments.comments
,用於表示 Excel 中的註解。
什麽是 Excel 註解?
在 Excel 檔案中,註解一般用於 Excel 儲存格,可以為使用者提供更多有用的資訊。
使用 Python openpyxl 套件的 Comment 物件建立 Excel 註解
使用 Pythonopenpyxl
套件的Comment
物件的建構子,可以建立新的 Excel 註解,這些註解可與 Excel 檔案中的儲存格關聯。
Comment(text, author, height=79, width=144)
- text 參數
text
參數是 Excel 註解的文字內容,可以是 Python 字串或其他型別的值。- author 參數
author
參數是一個字串,表示 Excel 註解的作者。- height 參數
height
參數是數值型別,表示 Excel 註解的高度,預設值為79
。- width 參數
width
參數是數值型別,表示 Excel 註解的寬度,預設值為144
。
Python openpyxl 套件的 Comment 物件的特性
Pythonopenpyxl
套件的Comment
物件擁有屬性text
,以及變數author
,height
,width
,在未作出修改時,他們的值與傳遞給Comment
建構子的引數的值相同。
此外,Comment
物件還擁有變數content
,其作用與屬性text
相同。
openpyxl 套件的 Comment 物件的 author 變數所表示的作者可能無法在 Office 軟體中顯示
雖然可以通過openpyxl
套件的Comment
物件的建構子或author
變數,來設定 Excel 儲存格註解的作者,但在不同的 Office 軟體中,註解的作者可能不會正確顯示。
使用 Python openpyxl 套件的 Comment 物件取得和設定 Excel 註解
Pythonopenpyxl
套件的Cell
物件的comment
屬性,可以取得或設定 Excel 儲存格中的註解。comment
屬性的傳回值是一個Comment
物件,如果 Excel 儲存格未包含註解,則Cell
物件的comment
屬性傳回空值None
。
cell.comment
cell.comment = text
- text 值
text
是一個表示 Excel 註解的Comment
物件。要移除 Excel 儲存格中的註解,text
應該為空值None
。
在 Excel 檔案Comment.xlsx
的工作表Sheet
中,儲存格A1
和B1
沒有註解,我們通過新增的Comment
物件為儲存格A1
新增註解。
# 開啟 Comment.xlsx 中的工作表 Sheet
import openpyxl
wb = openpyxl.load_workbook('Comment.xlsx')
ws = wb['Sheet']
from openpyxl.comments.comments import Comment
# 為儲存格 A1 設定註解
ws['A1'].comment = Comment('一個註解!', '好人', 300, 500)
# 取得儲存格 B1,C1 的註解
print(ws['B1'].comment)
print(ws['C1'].comment)
# 修改儲存格 C1 的註解
c = ws['C1'].comment
c.text = '我改了一下'
c.width = 500
c.height = 500
wb.save('Apple.xlsx')
None
Comment: 一頭熊! by 未知作者
程式碼
src/zh-hant/openpyxl/cells/comments·codebeatme/office-programming·GitHub