Python XlsxWriter - 边框


本节介绍如何应用单元格边框以及文本框周围的边框并设置其外观格式。

使用单元格边框

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

描述 财产 方法
单元格边框 '边界' 设置边框()
下边框 '底部' 设置底部()
顶部边框 '顶部' 设置顶部()
左边框 '左边' set_left()
右边框 '正确的' 设置权限()
边框颜色 '边框颜色' 设置边框颜色()
底色 '底部颜色' 设置底部颜色()
顶部颜色 '顶部颜色' 设置顶部颜色()
左颜色 '左颜色' 设置左颜色()
正确的颜色 '右颜色' 设置右颜色()

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

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

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

也可以通过调用set_border()方法来完成相同的操作-

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

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

  • 设置底部()
  • 设置顶部()
  • set_left()
  • 设置权限()

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

指数 姓名 重量 风格
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 / - . / - .

例子

以下代码显示了如何使用 border 属性。这里,每行都有与连续粗体相对应的边框样式 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()

输出

工作表在单元格周围显示粗体边框。

细胞边框

使用文本框边框

border 属性也可用于文本框对象。文本框也有与边框类似的线条属性,因此它们可以互换使用。边框本身可以进一步通过 none、color、width 和dash_type参数进行格式化。

Line 或 border 设置为 none 意味着文本框将没有任何边框。dash_type参数可以是以下任何值 -

  • 坚硬的
  • 圆点
  • 方点
  • 短跑
  • 破折号
  • 长划线
  • 长划线点
  • 长划线点点

例子

这是一个显示两个文本框的程序,其中一个带有实线边框,颜色为红色;第二个框有蓝色的dash_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()

输出

输出工作表显示文本框边框。

文本框边框