Python XlsxWriter - 文字框

在 Excel 中，文字框是一個圖形物件，可以放置在工作表的任何位置，如果需要，可以四處移動。所需的格式化功能，如字型（顏色、大小、名稱等）、對齊方式、填充效果、方向等，可以應用於文字框中包含的文字。

使用 XlsxWriter – 文字框

在 XlsxWriter 中，可以使用insert_textbox()方法在工作表上放置文字框。必須給出文字框的單元格位置以及要寫入其中的文字。此外，不同的格式選項以字典物件的的形式給出。

示例

以下程式碼在 C5 單元格顯示一個文字框，給定的字串將使用如下所示的字型和對齊屬性顯示：

import xlsxwriter

wb = xlsxwriter.Workbook('hello.xlsx')
worksheet = wb.add_worksheet()
text = 'Welcome to TutorialsPoint'

options = {'font': {'color': 'red','size': 14},
   'align': {'vertical': 'middle','horizontal': 'center'}}
worksheet.insert_textbox('C5', text, options)

wb.close()

輸出

使用 Excel 應用程式開啟工作表“hello.xlsx”。文字框將如下所示：

文字框選項 – 填充

文字框預設大小為 192X120 畫素（對應 3 列和 6 行）。可以使用 width 和 height 引數更改此大小，這兩個引數都以畫素為單位給出。inset_textbox() 方法可接受的引數之一是fill引數。它以預定義的顏色名稱或十六進位制表示的顏色作為值。

示例

以下程式碼在自定義大小的文字框中顯示一個多行字串，背景填充為紅色。

import xlsxwriter
wb = xlsxwriter.Workbook('hello.xlsx')
worksheet = wb.add_worksheet()
text = 'TutorialsPoint - Simple Easy Learning\nThe best resource for Online Education'

options = {
   'width': 384,
   'height':80,
   'font': {'color': 'blue', 'bold':True, 'size': 14},
   'align': {'vertical': 'middle', 'horizontal': 'center'},
   'fill':{'color':'red'},
}
worksheet.insert_textbox('C5', text, options)
wb.close()

如下圖所示，在 C5 單元格渲染了一個包含多行的文字框。

文字框選項 – text_rotation

另一個重要的屬性是text_rotation。預設情況下，文字水平顯示。如果需要，您可以透過給出一個角度作為其值來更改其方向。請檢視以下選項。

import xlsxwriter
wb = xlsxwriter.Workbook('hello.xlsx')
worksheet = wb.add_worksheet()
text = 'TutorialsPoint - Simple Easy Learning\nThe best resource for Online Education'

options = {
   'width': 128,
   'height':200,
   'font': {'bold':True, 'name':'Arial', 'size': 14},
   'text_rotation':90,
}
worksheet.insert_textbox('C5', text, options)
wb.close()

文字現在以垂直方向顯示在文字框中。

object_position 引數控制文字框的行為。它可以具有以下可能的值及其效果：

• “1” - 隨單元格移動和調整大小（預設值）。

• “2” - 移動但不隨單元格調整大小。

• “3” - 不隨單元格移動或調整大小。