Làm việc với biểu đồ

Phương thức insert_chart mới đã được thêm vào lớp DocumentBuilder. Vì vậy, hãy xem cách chèn biểu đồ cột đơn giản vào tài liệu bằng phương thức DocumentBuilder.insert_chart:

Cách chèn biểu đồ

Trong phần này chúng ta sẽ tìm hiểu cách chèn biểu đồ vào tài liệu.

Chèn biểu đồ cột

Ví dụ mã sau đây cho thấy cách chèn biểu đồ cột:

Mã tạo ra kết quả sau:

Có các phương thức add, add_double và add_date được trình bày để bao gồm tất cả các biến thể nguồn dữ liệu có thể có cho tất cả các loại biểu đồ:

Mã tạo ra kết quả sau:

Chèn biểu đồ phân tán

Ví dụ dưới đây cho thấy cách chèn biểu đồ tán xạ.

Mã tạo ra kết quả sau:

Chèn biểu đồ vùng

Ví dụ mã sau đây cho biết cách chèn biểu đồ vùng:

Mã tạo ra kết quả sau:

Chèn biểu đồ bong bóng

Ví dụ mã sau đây cho biết cách chèn biểu đồ bong bóng:

Mã tạo ra kết quả sau:

Làm việc với Biểu đồ thông qua đối tượng Shape.chart

Sau khi biểu đồ được chèn và chứa đầy dữ liệu, bạn có thể thay đổi giao diện của biểu đồ. Thuộc tính Shape.chart chứa tất cả các tùy chọn liên quan đến biểu đồ có sẵn thông qua API công khai.

Ví dụ: hãy thay đổi hành vi tiêu đề hoặc chú giải Chart:

Mã tạo ra kết quả sau:

Cách làm việc với ChartSeriesCollection of Chart

Hãy cùng nhìn vào bộ sưu tập ChartSeries. Tất cả các chuỗi biểu đồ đều có sẵn thông qua bộ sưu tập Chart.series:

Bạn có thể xóa từng bộ một hoặc xóa tất cả chúng cũng như thêm một bộ mới nếu cần. Biểu đồ mới được chèn có một số chuỗi mặc định được thêm vào bộ sưu tập này. Để loại bỏ chúng, bạn cần gọi phương thức chart.series.clear().

Làm việc với lớp ChartSeries đơn

Đây là cách làm việc với một chuỗi cụ thể.

Xin vui lòng xem kết quả dưới đây:

Tất cả ChartSeries đơn lẻ đều có các tùy chọn ChartDataPoint mặc định, vui lòng thử sử dụng đoạn mã sau để thay đổi chúng:

Xin vui lòng xem kết quả dưới đây:

Cách làm việc với ChartDataPoint đơn của ChartSeries

Sử dụng ChartDataPoint, bạn có thể tùy chỉnh định dạng của một điểm dữ liệu duy nhất trong chuỗi biểu đồ:

Xin vui lòng xem kết quả dưới đây:

Cách làm việc với ChartDataLabel của một ChartSeries đơn

Sử dụng ChartDataLabel, bạn có thể chỉ định định dạng của một nhãn dữ liệu duy nhất của chuỗi biểu đồ, như hiển thị/ẩn LegendKey, CategoryName, SeriesName, Value, v.v.

Xin vui lòng xem kết quả dưới đây:

Cách xác định các tùy chọn mặc định cho ChartDataLabels của ChartSeries

Lớp ChartDataLabelCollection xác định các thuộc tính có thể được sử dụng để đặt các tùy chọn mặc định cho ChartDataLabels cho Chuỗi biểu đồ. Các thuộc tính này bao gồm show_category_name, show_bubble_size, show_percentage, show_series_name, show_value, v.v.

Xin vui lòng xem kết quả dưới đây:

Cách định dạng số nhãn dữ liệu biểu đồ

Sử dụng ChartDataLabel.number_format, bạn có thể chỉ định định dạng số của một nhãn dữ liệu duy nhất trên biểu đồ.

Ví dụ mã sau đây cho thấy cách định dạng một số nhãn dữ liệu:

Cách đặt thuộc tính trục biểu đồ

Nếu bạn muốn làm việc với trục biểu đồ, chia tỷ lệ và đơn vị hiển thị cho trục giá trị, vui lòng sử dụng các lớp ChartAxis, AxisDisplayUnit và AxisScaling.

Ví dụ mã sau đây cho thấy cách xác định thuộc tính trục X và Y:

Cách đặt giá trị thời gian Date của trục

Ví dụ mã sau đây cho thấy cách đặt giá trị ngày/giờ cho thuộc tính trục:

Cách định dạng giá trị số của trục

Ví dụ mã sau đây cho thấy cách thay đổi định dạng của số trên trục giá trị:

Cách đặt giới hạn của trục

Lớp AxisBound biểu thị giới hạn tối thiểu hoặc tối đa của các giá trị trục. Giới hạn có thể được chỉ định dưới dạng giá trị số, ngày giờ hoặc giá trị “tự động” đặc biệt.

Ví dụ mã sau đây cho thấy cách đặt giới hạn của một trục:

Cách đặt đơn vị khoảng thời gian giữa các nhãn

Ví dụ mã sau đây cho thấy cách đặt đơn vị khoảng giữa các nhãn trên một trục:

Cách ẩn trục biểu đồ

Nếu bạn muốn hiển thị hoặc ẩn trục biểu đồ, bạn chỉ cần thực hiện điều này bằng cách đặt giá trị của thuộc tính ChartAxis.hidden.

Ví dụ mã sau đây cho biết cách ẩn trục Y của biểu đồ:

Cách căn chỉnh nhãn biểu đồ

Nếu bạn muốn đặt căn chỉnh văn bản cho nhãn nhiều dòng, bạn chỉ cần đạt được điều này bằng cách đặt giá trị của thuộc tính ChartAxis.tick_label_alignment.

Ví dụ mã sau đây cho thấy cách đánh dấu căn chỉnh nhãn:

MS Word căn chỉnh Nhãn biểu đồ vào giữa theo mặc định.

Cách đặt định dạng tô và nét

Định dạng điền và nét có thể được đặt cho chuỗi biểu đồ, điểm dữ liệu và điểm đánh dấu. Để thực hiện việc này, bạn cần sử dụng các thuộc tính của loại ChartFormat trong các lớp ChartSeries, ChartDataPoint và ChartMarker, cũng như các bí danh cho một số thuộc tính, chẳng hạn như fore_color, back_color, visible và transparency trong lớp Stroke.

Ví dụ mã sau đây cho biết cách đặt màu chuỗi:

doc = aw.Document()
builder = aw.DocumentBuilder(doc)

shape = builder.insert_chart(aw.drawing.charts.ChartType.COLUMN, 432, 252)

chart = shape.chart
seriesColl = chart.series

# Delete default generated series.
seriesColl.clear()

# Create category names array.
categories = [ "AW Category 1", "AW Category 2" ]

# Adding new series. Value and category arrays must be the same size.
series1 = seriesColl.add("AW Series 1", categories, [ 1, 2 ])
series2 = seriesColl.add("AW Series 2", categories, [ 3, 4 ])
series3 = seriesColl.add("AW Series 3", categories, [ 5, 6 ])

# Set series color.
series1.format.fill.fore_color = drawing.Color.red
series2.format.fill.fore_color = drawing.Color.yellow
series3.format.fill.fore_color = drawing.Color.blue

doc.save(docs_base.artifacts_dir + "WorkingWithCharts.set_series_color.docx")

Ví dụ mã sau đây cho thấy cách đặt màu và độ dày của dòng:

doc = aw.Document()
builder = aw.DocumentBuilder(doc)

shape = builder.insert_chart(aw.drawing.charts.ChartType.LINE, 432, 252)

chart = shape.chart
seriesColl = chart.series

# Delete default generated series.
seriesColl.clear()

# Adding new series.
series1 = seriesColl.add_double("AW Series 1", [ 0.7, 1.8, 2.6 ], [ 2.7, 3.2, 0.8 ])
series2 = seriesColl.add_double("AW Series 2", [ 0.5, 1.5, 2.5 ], [ 3, 1, 2 ])

# Set series color.
series1.format.stroke.fore_color = drawing.Color.red
series1.format.stroke.weight = 5
series2.format.stroke.fore_color = drawing.Color.light_green
series2.format.stroke.weight = 5

doc.save(docs_base.artifacts_dir + "WorkingWithCharts.line_color_and_weight.docx")