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 / - . / - .

示例

以下程式碼顯示瞭如何使用 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()

輸出

工作表顯示單元格周圍的粗體邊框。

Cell Border

使用文字框邊框

邊框屬性也適用於文字框物件。文字框還有一個 line 屬性,它類似於 border,因此它們可以互換使用。邊框本身可以透過 none、顏色、寬度和 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()

輸出

輸出工作表顯示文字框邊框。

Textbox Borders
廣告

© . All rights reserved.