Phương thức AddChartSheet
Lập trình thêm Lập trình thêm
Lập trình thêm BIFF8 vào workbook, trả về tab
TXLSCustomChartLập trình thêm
SaveAs(xlExcel97)mới. Trước đây, Lập trình thêm chỉ có thể được bảo toàn một cách mờ trong vòng load-save qua
; phương thức này ghi trực tiếp một chart substream hoàn chỉnh vào
. Excel mở kết quả như một tab biểu đồ của loại được yêu cầu. Có từ v2.41.0; nạp chồng mảng chuỗi theo sau trong v2.42.0 lxHLoại dữ liệule Cú pháp
type
TXLSChartType = (
xlsChartTypeColumn,
xlsChartTypeBar,
xlsChartTypeLine,
xlsChartTypePie);
Chọn loại biểu đồ. Được tái xuất khẩu từ
để code người dùng không cần nhập trực tiếp unit chart-builder Categories Loại dữ liệu Values Mang một khai báo chuỗi cho nạp chồng 6 tham số. 'Sheet1!$B$2:$B$5')
type
TXLSChartSeriesInfo = record
Name : WideString;
Categories : WideString;
Values : WideString;
end;
là các chuỗi vùng kiểu A1 (ví dụ:
Cấu trúc dữ liệu
// 1) v2.41.0 — name only; default column chart, no titles, no series.
function AddChartSheet(const Name: WideString): Lập trình thêm;
// 2) v2.41.0 — name + chart type.
function AddChartSheet(
const Name : WideString;
ChartType : TXLSChartType): Lập trình thêm;
// 3) v2.41.0 — + chart title.
function AddChartSheet(
const Name : WideString;
ChartType : TXLSChartType;
const Title: WideString): Lập trình thêm;
// 4) v2.41.0 — + category-axis title + value-axis title.
function AddChartSheet(
const Name : WideString;
ChartType : TXLSChartType;
const Title : WideString;
const CatAxisTitle: WideString;
const ValAxisTitle: WideString): Lập trình thêm;
// 5) v2.42.0 — + array of series (Name + Categories range + Values range).
function AddChartSheet(
const Name : WideString;
ChartType : TXLSChartType;
const Title : WideString;
const CatAxisTitle: WideString;
const ValAxisTitle: WideString;
const Series : array of TXLSChartSeriesInfo): Lập trình thêm;
Năm nạp chồng bao gồm các định nghĩa chart-sheet ngày càng phong phú hơn
The emitted chart substream covers the BIFF8 framing the spec calls for — BOF (dt=$0020), Chart / PlotGrowth / Frame / Series / SheetProperties / AxesUsed / AxisParent (POS + category axis + value axis + PlotArea + Frame + ChartFormat + chart-kind record + ChartFormatLink + Legend), EOF. Existing chart-sheet round-trip via TXLSCustomChart Nạp chồng
Chart substream được phát ra bao gồm khung BIFF8 mà spec yêu cầu — BOF (dt=$0020), Chart / PlotGrowth / Frame / Series / SheetProperties / AxesUsed / AxisParent (POS + category axis + value axis + PlotArea + Frame + ChartFormat + chart-kind record + ChartFormatLink + Legend), EOF. Vòng round-trip Lập trình thêm hiện có quakhông thay đổi Series[i].Name Ràng buộc tên chuỗi (v2.42.0) tStr : mỗi BRAI không rỗng được ghi vào chart substream như một nhãn chuỗi nghĩa đen qua token PTG
trêntên chuỗi (id=2). Excel sử dụng nhãn này trong legend và bộ chọn chuỗi, vì vậy các biểu đồ nhiều chuỗi hiển thị chú thích phù hợp thay vì placeholder "Series1 / Series2" mặc định Categories Loại dữ liệu Values : từ v2.47.0, các chuỗi A1-range tArea3D được biên dịch thành các tham chiếu cell-range cce=0 thực sự bên trong BRAI, đi qua trình biên dịch công thức và bảng tham chiếu EXTERNSHEET workbook. Trước v2.47.0, hai trường này được chấp nhận trên API nhưng được phát ra như các placeholder Categories / Values , vì vậy biểu đồ được render trống
, vì vậy biểu đồ được render trống Lập trình thêm được trả về xuất hiện trong bộ sưu tập Sheets collection Loại dữ liệu gets a chart-sheet boundsheet entry written on save. Cell-level methods on the result are unsupported — the host worksheet is a chart container, not a data sheet
Ghi chú kỹ thuật
Ví dụ này xây dựng workbook với một sheet dữ liệu và một biểu đồ cột được ràng buộc với hai cột của sheet dữ liệu đó
var
Series: array of TXLSChartSeriesInfo;
begin
// Populate cells on Sheet1.
Workbook.Sheets[1].Name := 'Data';
// ... fill A1:B5 with categories + values ...
SetLength(Series, 1);
Series[0].Name := 'Quarterly Revenue';
Series[0].Categories := 'Data!$A$2:$A$5';
Series[0].Values := 'Data!$B$2:$B$5';
Workbook.Sheets.AddChartSheet(
'Revenue',
xlsChartTypeColumn,
'Quarterly Revenue',
'Quarter',
'USD',
Series);
Workbook.SaveAs('Revenue.xls', xlExcel97);
end;
Ràng buộc tên chuỗi
Per-chart-type formatting details (gap width, bar overlap, pie hole size, marker style) are still emitted at the chart-builder defaults — not yet exposed on the API. Save-Loại dữ liệu-reopen with Excel preserves the Lập trình thêm's presence, kind, title, axis titles, series captions, Loại dữ liệu (from v2.47.0) the series data binding
Ràng buộc vùng chuỗi