يُلحق برمجياً
ورقة مخطط BIFF8 بالمصنف ويُرجع كائن
TXLSWorksheet الجديد
تعداد TXLSChartType
يختار نوع المخطط. مُعاد تصديره من lxHandle بحيث لا يحتاج كود المستخدم إلى استيراد وحدة بناء المخطط مباشرةً
type
TXLSChartType = (
xlsChartTypeColumn,
xlsChartTypeBar,
xlsChartTypeLine,
xlsChartTypePie);
سجل TXLSChartSeriesInfo
يحمل إعلان سلسلة واحدة للحِمل الزائد ذي 6 معاملات. Categories وValues سلاسل نطاق A1 (مثل Sheet1!A1:A10)
type
TXLSChartSeriesInfo = record
Name : WideString;
Categories : WideString;
Values : WideString;
end;
البنية
تغطي خمسة أحمال زائدة تعريفات ورقة مخطط أكثر ثراءً تدريجياً
// 1) v2.41.0 — name only; default column chart, no titles, no series.
function AddChartSheet(const Name: WideString): TXLSWorksheet;
// 2) v2.41.0 — name + chart type.
function AddChartSheet(
const Name : WideString;
ChartType : TXLSChartType): TXLSWorksheet;
// 3) v2.41.0 — + chart title.
function AddChartSheet(
const Name : WideString;
ChartType : TXLSChartType;
const Title: WideString): TXLSWorksheet;
// 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): TXLSWorksheet;
// 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): TXLSWorksheet;
ملاحظات
يغطي تيار المخطط المُصدَّر إطار BIFF8 الذي تصفه المواصفات — BOF (dt=$0020) والمخطط/PlotGrowth/الإطار/السلسلة/SheetProperties/الحدود
ربط اسم السلسلة (v2.42.0): يُكتب كل Series[i].Name غير فارغ في تيار المخطط كنص حرفي
ربط نطاق السلسلة (v2.47.0): بدءاً من v2.47.0، تُربط سلاسل نطاق A1 للـ Categories وValues بالمخطط
تظهر TXLSWorksheet المُرجَعة في مجموعة Sheets وتحصل على إدخال boundsheet لورقة المخطط المكتوب عند الحفظ
مثال
يبني هذا المثال مصنفاً بورقة بيانات ومخطط عمودي مرتبط بعمودَين من تلك الورقة
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;
القيود
تفاصيل التنسيق لكل نوع مخطط (عرض الفجوة، تداخل الأشرطة، حجم فتحة الدائرة، نمط العلامة) لا تزال تُصدَر بالإعدادات الافتراضية لبناء المخطط
انظر أيضاً