Програмно прибавя BIFF8
chart sheet (лист с диаграма) към работната книга, връщайки новото
TXLSWorksheet табче
TXLSChartType изброявателен тип
Избира вида на диаграмата. Реекспортиран от lxHandle, така че потребителският код да не трябва да импортира директно модула за изграждане на диаграми
type
TXLSChartType = (
xlsChartTypeColumn,
xlsChartTypeBar,
xlsChartTypeLine,
xlsChartTypePie);
Запис TXLSChartSeriesInfo
Носи единична декларация за серия за 6-параметровото претоварване. Categories и Values са низове от диапазони в стил A1 (напр. 'Sheet1!$B$2:$B$5')
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, Chart / PlotGrowth / Frame / Series / SheetProperties / AxesUsed / AxisParent и т.н
Обвързване на имена на серии (v2.42.0): всяко непразно Series[i].Name се записва в подпотока на диаграмата като буквален етикет на серия чрез токен tStr PTG
Обвързване на диапазони на серии (v2.47.0): от v2.47.0 нататък, низовете от диапазони в стил A1 на Categories и Values се компилират в реални референции за клетъчни диапазони tArea3D
Върнатото TXLSWorksheet се появява в колекцията Sheets и получава запис за граница на листа с диаграма при записване. Методите на ниво клетки върху резултата не се поддържат
Пример
Изгражда работна книга с лист с данни и колонна диаграма, обвързана с две колони от листа с данни
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;
Ограничения
Детайлите за форматиране за конкретен вид диаграма (ширина на пролуката, припокриване на лентите, размер на отвора на пая, стил на маркера) все още се записват при стойностите по подразбиране на строителя на диаграми
Вижте също