Python XlsxWriter – 边框

本节描述了如何应用和格式化单元格边框的外观以及文本框的边框。

使用单元格边框

add_format() 方法中控制单元格边框外观的属性如下表所示。

说明	属性	方法
单元格边框	‘border	set_border()
底部边框	‘bottom’	set_bottom()
顶部边框	‘top’	set_top()
左边框	‘left’	set_left()
右边框	‘right’	set_right()
边框颜色	‘border_color’	set_border_color()
底部颜色	‘bottom_color’	set_bottom_color()
顶部的颜色	‘top_color’	set_top_color()
左边的颜色	‘left_color	set_left_color()
右边的颜色	‘right_color’	set_right_color()

请注意，对于 add_format() 方法的每个属性，都有一个相应的格式类方法，以 set_propertyname() 方法开始。

例如，要在单元格周围设置边框，我们可以在 add_format() 方法中使用border属性，如下所示

f1= wb.add_format({ 'border':2})

同样的动作也可以通过调用 set_border( )方法来完成：

f1 = workbook.add_format()
f1.set_border(2)

单个边框元素可以通过属性或格式方法进行配置，如下所示

set_bottom()
set_top()
set_left()
set_right()

这些边框方法/属性有一个整数值，与预定义的样式相对应，如下表所示

索引	名称	重量	样式
0	无	0
1	连续的	1	-———-
2	连续的	2	-———-
3	冲刺	1	- – – – – –
4	点	1	. . . . . .
5	连续的	3	-———-
6	双人	3	===========
7	连续	0	-———-
8	衝刺	2	- – – – – –
9	冲刺点	1	- . – . – .
10	破折号点	2	- . – . – .
11	冲刺点点	1	- . .- . .
12	破折号圆点	2	- . .- . .
13	斜线点	2	/ – ./ – .

例子

下面的代码显示了如何使用边框属性。这里，每一行都有一个边框样式2，对应于连续的粗体。

import xlsxwriter

wb = xlsxwriter.Workbook('hello.xlsx')
ws = wb.add_worksheet()

f1=wb.add_format({'bold':True, 'border':2, 'border_color':'red'})
f2=wb.add_format({'border':2, 'border_color':'red'})

headings = ['Month', 'Product A', 'Product B']

data = [
   ['Jan', 'Feb', 'Mar', 'Apr', 'May', 'June'],
   [10, 40, 50, 20, 10, 50],
   [30, 60, 70, 50, 40, 30],
]

ws.write_row('A1', headings, f1)
ws.write_column('A2', data[0], f2)
ws.write_column('B2', data[1],f2)
ws.write_column('C2', data[2],f2)

wb.close()

输出

工作表显示单元格周围有一个粗体的边框。

Python XlsxWriter - 边框

使用文本框边框

边框属性也可用于文本框对象。文本框也有一个线属性，它与边框类似，因此它们可以互换使用。边框本身可以进一步通过无、颜色、宽度和 dash_type 等参数进行格式化。

线条或边框设置为none意味着文本框将没有任何边框。The dash_type parameter can be any of the following values −

solid
round_dot
square_dot
dash
dash_dot
long_dash
long_dash_dot
long_dash_dot_dot

例子

下面是一个显示两个文本框的程序，其中一个文本框的边框是实心的，颜色为红色；第二个文本框的边框是蓝色的 破折号_点 。

import xlsxwriter

wb = xlsxwriter.Workbook('hello.xlsx')
ws = wb.add_worksheet()

ws.insert_textbox('B2', 'Welcome to Tutorialspoint',
{'border': {'color': '#FF9900'}})

ws.insert_textbox('B10', 'Welcome to Tutorialspoint', {
   'line':
   {'color': 'blue', 'dash_type': 'dash_dot'}
})
wb.close()