Tính năng và chức năng

Tổng quan

Trang này đề cập đến các khả năng tạo biểu đồ của Aspose.Words FOSS cho .NET với các ví dụ C# hoạt động, được xây dựng quanh DocumentBuilder.InsertChart() và Chart mô hình đối tượng. Mô hình đối tượng tài liệu đầy đủ của thư viện (đoạn văn, bảng, kiểu dáng, dấu trang, phần) được mô tả trong tổng quan sản phẩm và trong Quickstart hướng dẫn.


Tạo tài liệu với biểu đồ

Chèn một hình dạng biểu đồ bằng DocumentBuilder.InsertChart(), sau đó truy cập đối tượng Chart của nó thông qua Shape được trả về. Xóa series mặc định được tạo trước khi thêm dữ liệu thực:

using Aspose.Words;
using Aspose.Words.Drawing.Charts;

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

Shape shape = builder.InsertChart(ChartType.Line, 432, 252);
Chart chart = shape.Chart;

// Delete default generated series.
chart.Series.Clear();

string[] categories = new string[] { "AW Category 1", "AW Category 2", "AW Category 3" };
chart.Series.Add("AW Series 1", categories, new double[] { 4.3, 2.5, 3.5 });

doc.Save("chart.docx");

Series biểu đồ, Điểm dữ liệu và Dấu đánh dấu

Chart.Series là một ChartSeriesCollection. Mỗi ChartSeries cho phép truy cập các điểm dữ liệu riêng lẻ của nó thông qua DataPoints, cho phép bạn tùy chỉnh dấu hoặc định dạng của một điểm duy nhất mà không ảnh hưởng đến phần còn lại của series:

Shape shape = builder.InsertChart(ChartType.Line, 432, 252);
Chart chart = shape.Chart;
chart.Series.Clear();
chart.Series.Add("AW Series 1", categories, new double[] { 4.3, 2.5, 3.5 });

ChartSeries series = chart.Series[0];
ChartDataPointCollection points = series.DataPoints;

ChartDataPoint point1 = points[0];
ChartDataPoint point2 = points[1];

point1.InvertIfNegative = true;
point1.Marker.Symbol = MarkerSymbol.Square;
point2.InvertIfNegative = true;
point2.Marker.Symbol = MarkerSymbol.Diamond;

// Reset a single data point back to the series' inherited default formatting.
point1.ClearFormat();

Nhãn dữ liệu biểu đồ

ChartSeries.DataLabels là một ChartDataLabelCollection kiểm soát nhãn cho mọi điểm trong chuỗi cùng một lúc. Truy cập vào nó bằng DataLabels[i] để ghi đè một ChartDataLabel riêng lẻ:

Shape shape = builder.InsertChart(ChartType.Line, 432, 252);
Chart chart = shape.Chart;
chart.Series.Clear();
chart.Series.Add("AW Series 1", categories, new double[] { 4.3, 2.5, 3.5 });

ChartSeries series = chart.Series[0];
series.HasDataLabels = true;
series.DataLabels.ShowValue = true;

ChartDataLabel label = series.DataLabels[1];
label.ShowCategoryName = true;
label.Position = ChartDataLabelPosition.Below;

Tiêu đề trục biểu đồ

Chart.AxisX và Chart.AxisY mỗi cái đều cung cấp một ChartAxisTitle qua thuộc tính Title của chúng:

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

Shape shape = builder.InsertChart(ChartType.Column, 432, 252);

Chart chart = shape.Chart;
ChartAxisTitle xTitle = chart.AxisX.Title;
ChartAxisTitle yTitle = chart.AxisY.Title;

xTitle.Show = true;
xTitle.Text = "Categories";
yTitle.Show = true;
yTitle.Text = "Values";

Chú giải biểu đồ và phông chữ

Chart.Legend cung cấp LegendEntries, một ChartLegendEntry cho mỗi chuỗi, mỗi cái có Font riêng của nó. Font thực hiện định dạng tô đầy, vì vậy Font.Fill.Solid() đặt màu văn bản đặc giống như trên bất kỳ đoạn đã định dạng nào khác:

using System.Drawing;

Shape shape = builder.InsertChart(ChartType.Column, 432, 252);

ChartLegend legend = shape.Chart.Legend;
Font font1 = legend.LegendEntries[0].Font;
Font font2 = legend.LegendEntries[1].Font;

font1.Fill.Solid(Color.Blue);
font2.Color = Color.Green;

Bảng dữ liệu biểu đồ

Chart.DataTable là một ChartDataTable hiển thị các giá trị chuỗi nền dưới biểu đồ. Các thuộc tính Has*Border và HasLegendKeys của nó kiểm soát phần nào được hiển thị:

Shape shape = builder.InsertChart(ChartType.Column, 432, 252);
ChartDataTable dataTable = shape.Chart.DataTable;

dataTable.HasLegendKeys = false;
dataTable.HasHorizontalBorder = true;
dataTable.HasVerticalBorder = true;
dataTable.HasOutlineBorder = false;

doc.Save("chart-report.docx");

Mẹo và Thực hành Tốt nhất

  • DocumentBuilder.InsertChart() điền biểu đồ mới với một chuỗi được tạo mặc định — gọi chart.Series.Clear() trước khi thêm dữ liệu của bạn, nếu không các giá trị mặc định sẽ vẫn hiện cùng nó.
  • Sử dụng ChartSeries.DataLabels[i] để nhắm mục tiêu một nhãn dữ liệu khi chỉ một vài điểm cần định dạng tùy chỉnh; sử dụng các thuộc tính cấp bộ sưu tập (DataLabels.ShowValue, và các tương tự) để đặt mặc định cho mọi nhãn trong chuỗi cùng một lúc.
  • ClearFormat() có sẵn trên cả ChartDataPoint và ChartDataLabelCollection — nó đặt lại định dạng trực tiếp về giá trị mà chuỗi kế thừa mặc định.
  • Công cụ đánh giá trường cập nhật các trường nội dung như DATE và DOCPROPERTY một cách lập trình, nhưng các trường phụ thuộc vào bố cục trang (số trang trong mục lục, NUMPAGES) sẽ được đánh giá thành giá trị 0 vì bản phát hành này không bao gồm công cụ bố cục.
  • Xem Hướng dẫn Cài đặt để thêm gói qua NuGet, hoặc biên dịch từ nguồn, trước khi tham chiếu các API này.

Các vấn đề thường gặp

Vấn đềNguyên nhânKhắc phục
Số trang hoặc mục lục hiển thị 0Phiên bản này không bao gồm engine bố cục/trình bày trangHành vi mong đợi — các giá trị trường phụ thuộc vào bố cục không được tính toán; sử dụng bản thương mại Aspose.Words cho .NET nếu bạn cần chúng
Document.Save() đến .pdf, .xps, hoặc một phần mở rộng hình ảnh không thành côngCác định dạng render không được bao gồm trong phiên bản nàyLưu dưới dạng DOCX, DOCM, DOTX, DOTM, Flat OPC, Markdown hoặc văn bản thuần thay thế
Việc tải tệp .doc, .rtf, .odt, .html hoặc .epub không thành côngChỉ hỗ trợ DOCX, DOCM, DOTX, DOTM, Flat OPC, Markdown và văn bản thuần cho việc tải/luuChuyển đổi tệp nguồn sang DOCX trước, hoặc sử dụng phiên bản thương mại
Dòng dữ liệu biểu đồ mặc định vẫn xuất hiện sau khi thêm dữ liệu tùy chỉnhchart.Series.Clear() không được gọi sau InsertChart()Xóa chuỗi mặc định được tạo trước khi gọi chart.Series.Add()

FAQ

Tại sao số trang trong mục lục của tôi lại hiển thị là 0?

Bản FOSS này không bao gồm hệ thống bố cục trang và kết xuất, vì vậy bất kỳ giá trị trường nào phụ thuộc vào bố cục trang — bao gồm cả số trang — sẽ được đánh giá thành một phần giữ chỗ 0 thay vì một giá trị đã tính toán.

Tôi có thể xuất tài liệu sang PDF hoặc định dạng hình ảnh không?

Không có trong phiên bản này. Việc xuất PDF, XPS và hình ảnh phụ thuộc vào cùng một hệ thống kết xuất đã bị loại bỏ để giữ phiên bản này miễn phí. Sử dụng Aspose.Words thương mại cho .NET để tạo các đầu ra đó.

Tôi có thể tạo chữ ký số mới trên một tài liệu không?

Không — phiên bản này có thể xác minh các chữ ký số hiện có nhưng không thể tạo chữ ký mới.

InsertChart() hỗ trợ những loại biểu đồ nào?

InsertChart() nhận một giá trị ChartType — enum bao gồm các họ biểu đồ tiêu chuẩn như đường, cột, thanh, tròn, khu vực, doughnut, radar, scatter, stock và surface, bao gồm các biến thể xếp chồng và 3D.

Tóm tắt API Reference

Lớp / Thuộc tínhMô tả
DocumentĐối tượng tài liệu gốc; Save() ghi ra DOCX, Markdown hoặc văn bản thuần
DocumentBuilderCon trỏ cấp cao API; InsertChart() thêm một hình biểu đồ
ShapeĐối tượng vẽ được trả về bởi InsertChart(); cung cấp thuộc tính Chart
ChartĐối tượng biểu đồ; Series, Legend, DataTable, AxisX, AxisY, Title
ChartSeries / ChartSeriesCollectionDữ liệu chuỗi (Add, Clear) và cài đặt cho mỗi chuỗi
ChartDataPoint / ChartDataPointCollectionĐịnh dạng mỗi điểm; ClearFormat()
ChartMarker / MarkerSymbolHình dạng và kích thước của điểm đánh dấu dữ liệu
ChartDataLabel / ChartDataLabelCollectionCài đặt hiển thị nhãn theo từng nhãn và trên toàn bộ bộ sưu tập
ChartAxisTitleVăn bản tiêu đề hiển thị trên Chart.AxisX / Chart.AxisY
ChartLegend / ChartLegendEntryChú giải biểu đồ và các mục theo chuỗi của nó
ChartDataTableBảng dữ liệu hiển thị bên dưới biểu đồ
Font / FillĐịnh dạng văn bản và tô (màu đặc, gradient) trên các phần tử văn bản biểu đồ

Xem thêm

 Tiếng Việt