圖表的繪圖區包含顯示其資料的空間。格式化此區域可幫助圖表符合 Word 報告的外觀，並使其資料更易於辨識。繪圖區是較大圖表區的一部分，該區域還可以包含標題和圖例等元素。

在本教程中，您將在 Word 文檔中建立柱狀圖，對其繪圖區域套用漸層填色與邊框，並使用 Python 儲存結果。

用於格式化 Word 圖表繪圖區域的 Python 函式庫

Aspose.Words for Python via .NET 讓您能夠從 Python 應用程式建立和操作 Word 文件。使用 26.10 或更高版本 以進行圖表區域填充和線條格式設定。

使用 pip 安裝庫：

pip install "aspose-words>=26.10"

您可以在評估模式下使用該庫，或取得免費臨時許可證以在無評估限制的情況下進行評估。

在 Python 中格式化 Word 圖表的繪圖區域

按照以下步驟建立並格式化圖表：

  1. 建立一個 Document 與 DocumentBuilder。
  2. 插入柱狀圖，並透過返回的 shape 進行存取。
  3. 清除預設系列，並新增您自己的類別和數值。
  4. 存取繪圖區的 format 屬性。
  5. 套用漸層填色，並設定邊框顏色與寬度。
  6. 將文件儲存為 DOCX 檔案。

以下範例建立一個包含兩個系列的圖表，並格式化其繪圖區域：

import aspose.pydrawing
import aspose.words as aw

# Create a document and insert a column chart.
doc = aw.Document()
builder = aw.DocumentBuilder(doc=doc)
shape = builder.insert_chart(
    chart_type=aw.drawing.charts.ChartType.COLUMN,
    width=432,
    height=252,
)
chart = shape.chart

# Replace the default series with sample data.
chart.series.clear()
categories = ["Quarter 1", "Quarter 2"]
chart.series.add(series_name="2025", categories=categories, values=[1, 2])
chart.series.add(series_name="2026", categories=categories, values=[3, 4])

# Set the plot-area fill and border.
plot_area = chart.plot_area
plot_area.format.fill.one_color_gradient(
    color=aspose.pydrawing.Color.light_blue,
    style=aw.drawing.GradientStyle.DIAGONAL_UP,
    variant=aw.drawing.GradientVariant.VARIANT2,
    degree=1,
)
plot_area.format.stroke.fore_color = aspose.pydrawing.Color.blue
plot_area.format.stroke.weight = 0.25

# Save the document.
doc.save(file_name="formatted-chart-python.docx")

圖表區域格式化的工作原理

此範例在加入自己的系列之前會先清除圖表產生的系列，因此輸出僅包含範例資料。類別會顯示在圖表的類別軸上，每個系列為每個類別提供一個值。

The chart.plot_area.format 屬性提供對圖表繪圖區填充和線條格式的存取。one_color_gradient() 方法設定漸層顏色、樣式、變體和程度。stroke.fore_color 與 stroke.weight 屬性設定邊框顏色與寬度；範例使用 0.25 點的寬度。

查看已格式化的圖表

在 Word 文件檢視器中開啟 formatted-chart-python.docx。該文件包含一個具有兩個資料系列的柱狀圖，圖表區域具有淡藍色漸層，且有細藍色邊框。您可以更改顏色、漸層設定、類別和數值，以符合您的報告需求。

格式化 Word 圖表的繪圖區域。

格式化 Word 圖表的繪圖區域。

結論

您已使用 Python 建立了 Word 柱狀圖，並以漸層和邊框格式化了繪圖區。請調整範例資料和顏色以符合您自己的報告，或探索 Python 圖表教學 以了解如何建立其他圖表類型。

另請參閱