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” - 不随单元格移动或调整大小。