如何使用 Python openpyxl 套件操作 Excel 註解?openpyxl Comment 物件介紹

閱讀 3:38·字數 1092·發佈 
Youtube 頻道
訂閱 133

閱讀本節的先決條件是已經了解 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,以及變數authorheightwidth,在未作出修改時,他們的值與傳遞給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中,儲存格A1B1沒有註解,我們通過新增的Comment物件為儲存格A1新增註解。

comment.py
# 開啟 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