Làm việc với Biểu đồ
Làm việc với Biểu đồ
Aspose.Cells FOSS for Java preserves embedded charts when loading and saving XLSX workbooks. You can inspect existing charts, query their type and position, and add new standard-type charts programmatically. ChartEx types such as Waterfall, Treemap, Sunburst, Histogram, Box and Whisker, Funnel, and Map are preserved on round-trip but cannot be created through the API.
Overview
Các biểu đồ trong một bảng điều khiển được quản lý thông qua các ChartCollection Truy cập qua Worksheet.getCharts().Mỗi người Chart ví dụ tiết lộ tên, loại biểu đồ, và vị trí anchor hai tế bào của nó. một biểu đồ mới được nhập với ChartCollection.add(type, dataRange, upperLeftRow, upperLeftColumn, lowerRightRow, lowerRightColumn), mà trả về chỉ số của biểu đồ mới được tạo.
Các ChartType enum xác định biến thể biểu đồ (bar, line, pie, vv). Phương pháp giúp đỡ ChartCollection.parseChartType(string) và ChartCollection.chartTypeToString(ChartType) chuyển đổi giữa enum và biểu hiện string của nó cho các trường hợp sử dụng serialization.
Các Lớp Chính
| Class | Description |
|---|---|
Chart | Hiển thị một biểu đồ tích hợp trong một bảng tính. đọc truy cập vào tên, kiểu và vị trí ô-anchor. |
ChartCollection | Thu thập tất cả các biểu đồ trên một bảng tính hỗ trợ số, truy cập chỉ mục, thêm và máy trợ giúp chuyển đổi kiểu biểu mẫu. |
ChartType | Enum xác định biến thể biểu đồ (bar, cột, dòng, pie, scatter, vv). |
ChartModel | Mô hình phân phối nội bộ cho một biểu đồ. Hiển thị các trường XML nguyên liệu được sử dụng trong quá trình tải / lưu trữ. |
Truy cập bảng trên một sổ làm việc
Retrieve các ChartCollection Từ bất kỳ Worksheet đối tượng qua Worksheet.getCharts().Sử dụng ChartCollection.getCount() Để xác định bao nhiêu biểu đồ hiện diện. biểu mẫu cá nhân được truy cập thông qua chỉ số dựa trên zero thông ChartCollection.get(index).
Khi bạn giữ một Chart Các tham khảo bạn có thể đọc:
Chart.getName()- dòng tên nội bộ của biểu đồ.Chart.getChartType()- TheChartTypegiá trị enum.Chart.getUpperLeftRow()/Chart.getUpperLeftColumn()- Tầng thượng bên trái của ô anchor.Chart.getLowerRightRow()/Chart.getLowerRightColumn()- Các tế bào anchor bên dưới phải.Chart.getExtentCx()/Chart.getExtentCy()- Bản đồ mở rộng trong EMU.
Thêm một bản đồ mới
Sử dụng ChartCollection.add(type, dataRange, upperLeftRow, upperLeftColumn, lowerRightRow, lowerRightColumn) để nhập một biểu đồ mới. phương pháp trả về chỉ số toàn bộ của biểu mẫu trong Đặt hàng: cung cấp A ChartType Giá trị cho The type Câu chuyện và một ô Tính năng của string (ví dụ: A1:B5) Đối với dataRange.
Lưu ý: Các loại gia đình ChartEx (Waterfall, Treemap, Sunburst, Histogram, Box and Whisker, Funnel, Map) được lưu trữ khi tải các tệp XLSX nhưng không thể được tạo lập trình thông qua API này.
Tóm tắt Tham chiếu API
Chart
| Method | Loại Return | Description |
|---|---|---|
getName() | String | Tên nội bộ của bản đồ. |
getChartType() | ChartType | Chart variant enum giá trị. |
getUpperLeftRow() | int | Chỉ số dây của anchor phía trên bên trái. |
getUpperLeftColumn() | int | Chỉ số cột của anchor phía trên bên trái. |
getLowerRightRow() | int | - Chỉ số dây của anchor dưới bên phải. |
getLowerRightColumn() | int | Chỉ số cột của anchor dưới bên phải. |
getExtentCx() | long | Chart width trong EMU. |
getExtentCy() | long | Chart chiều cao trong EMU. |
ChartCollection
| Method | Loại Return | Description |
|---|---|---|
getCount() | int | Số lượng biểu đồ trên bảng tính. |
get(index) | Chart | Trả lại biểu đồ tại chỉ số dựa trên zero. |
add(type, dataRange, ...) | int | Thêm một biểu đồ mới; trả lại chỉ số của nó. |
parseChartType(string) | ChartType | Chuyển đổi tên string thành a ChartType giá trị enum. |
chartTypeToString(type) | String | chuyển đổi a ChartType giá trị enum cho tên string của nó. |
Limitations
- Các loại ChartEx (Waterfall, Treemap, Sunburst, Histogram, Box and Whisker, Funnel, Map) là chữ viết tròn nhưng không thể được tạo qua API.
- Các liên kết loạt dữ liệu biểu đồ không thể thay đổi trong bản phát hành này; các trình bày biểu mẫu dựa trên phạm vi dữ kiện ban đầu được cung cấp tại thời điểm tạo.
