Python Excel操作模块XlsxWriter之写入富字符串worksheet.write_rich_string()

worksheet.write_rich_string()

write_rich_string(row, col, *string_parts[, cell_format])

向工作表单元格写入多格式的“富”字符串。

参数：

• row(int) - 单元格所在的行（索引从0开始计数）。
• col(int) - 单元格所在的列（索引从0开始计数）。
• string_parts(list) - 字符串-格式对。
• cell_format(Format) - 可选的格式化对象。

write_rich_string()方法用于写入含有多种格式的字符串。例如写入“This is bold and this is italic”你得这么做：

bold   = workbook.add_format({'bold': True})
italic = workbook.add_format({'italic': True})

worksheet.write_rich_string('A1',
                            'This is ',
                            bold, 'bold',
                            ' and this is ',
                            italic, 'italic')

基本法则是将字符串分段并将Format对象放在你想要格式化的片段前面。比如：

# 没有被格式化的字符串。
'This is an example string'

# 将字符串分段。
'This is an ', 'example', ' string'

# 将格式对象放在你想要格式化的片段前面。
'This is an ', format, 'example', ' string'

# 在XlsxWriter里这么用。
worksheet.write_rich_string('A1',
                            'This is an ', format, 'example', ' string')

没有格式的字符串片段会给定默认格式。比如在写入字符串“Some bold text”时你下面第一个例子和第二个例子是等价的：

# bold格式和默认格式。
bold    = workbook.add_format({'bold': True})
default = workbook.add_format()

# 默认格式化：
worksheet.write_rich_string('A1',
                            'Some ',
                            bold, 'bold',
                            ' text')

# 或者更显式的写法：
worksheet.write_rich_string('A1',
                             default, 'Some ',
                             bold,    'bold',
                             default, ' text')

在Excel中只有像字体名称，样式，大小，下划线，颜色，效果这样的字体属性会被应用到富字符串中的字符串片段上。其他诸如边框，背景，文本框，对齐方式的特性必须在单元格中应用。

write_rich_string()方法允许你通过将最后一个参数作为单元格格式（如果这是个格式化对象）来写入富字符串。下面是一个在单元格居中富字符串的例子：

bold   = workbook.add_format({'bold': True})
center = workbook.add_format({'align': 'center'})

worksheet.write_rich_string('A5',
                            'Some ',
                            bold, 'bold text',
                            ' centered',
                            center)

例：写入含有多个格式的“富”字符串

这是一个向工作表单元格写入含有多个格式的富字符串的例子。

#######################################################################
#
# An example of using Python and XlsxWriter to write some "rich strings",
# i.e., strings with multiple formats.
#
# Copyright 2013-2017, John McNamara, jmcnamara@cpan.org
#
import xlsxwriter

workbook = xlsxwriter.Workbook('rich_strings.xlsx')
worksheet = workbook.add_worksheet()

worksheet.set_column('A:A', 30)

# 设置一些格式。
bold = workbook.add_format({'bold': True})
italic = workbook.add_format({'italic': True})
red = workbook.add_format({'color': 'red'})
blue = workbook.add_format({'color': 'blue'})
center = workbook.add_format({'align': 'center'})
superscript = workbook.add_format({'font_script': 1})

# 写入几个含有多种格式的字符串
worksheet.write_rich_string('A1',
                            'This is ',
                            bold, 'bold',
                            ' and this is ',
                            italic, 'italic')

worksheet.write_rich_string('A3',
                            'This is ',
                            red, 'red',
                            ' and this is ',
                            blue, 'blue')

worksheet.write_rich_string('A5',
                            'Some ',
                            bold, 'bold text',
                            ' centered',
                            center)

worksheet.write_rich_string('A7',
                            italic,
                            'j = k',
                            superscript, '(n-1)',
                            center)

workbook.close()

例：合并含有富字符串的的单元格

这是一个合并含有富字符串单元格的例子。

使用标准XlsxWriter API我们只能将简单类型的字符串写入合并范围，所以我们先将一个空字符串写入合并范围。然后用富字符串覆盖第一个合并了的单元格。

注意我们也必须传递在最后用于合并了的单元格的单元格格式。

##############################################################################
#
# An  example of merging cells which contain a rich string using the
# XlsxWriter Python module.
#
# Copyright 2013-2017, John McNamara, jmcnamara@cpan.org
#
import xlsxwriter


# 创建一个新Excel文件并添加一个工作表。
workbook = xlsxwriter.Workbook('merge_rich_string.xlsx')
worksheet = workbook.add_worksheet()

# 设置一些格式。
red = workbook.add_format({'color': 'red'})
blue = workbook.add_format({'color': 'blue'})
cell_format = workbook.add_format({'align': 'center',
                                   'valign': 'vcenter',
                                   'border': 1})

# 我们只能向合并范围写入简单类型，所以我们写了个空字符串。
worksheet.merge_range('B2:E5', "", cell_format)

# 然后我们用富字符串覆盖第一个合并了的单元格。
# 注意我们必须传递最后用于合并了的单元格的单元格格式。
worksheet.write_rich_string('B2',
                            'This is ',
                            red, 'red',
                            ' and this is ',
                            blue, 'blue',
                            cell_format)

workbook.close()