Referenčná stránka HotXLS pre AddChartSheet method, pokrývajúca automatizáciu Excel v Delphi a C++Builder, API zošita XLS/XLSX, funkcie pracovných listov a použitie v Pascal

Obsah

Prehľad Prehľad Metóda AddChartSheet Programaticky pridá list grafu TXLSCustomChartBIFF8 do zošita, vrátiac novú záložku SaveAs(xlExcel97)Programaticky pridá

Programaticky pridá

. Predtým bolo možné vytvoriť listy grafov iba v Exceli lxHTypy grafovle Vyberie typ grafu. Opätovne exportované z
type
  TXLSChartType = (
    xlsChartTypeColumn,
    xlsChartTypeBar,
    xlsChartTypeLine,
    xlsChartTypePie);

Selects the chart kind. Re-exported from

so user code does not need to import the chart-builder unit directly Categories Typy grafov Values Typy grafov 'Sheet1!$B$2:$B$5')
type
  TXLSChartSeriesInfo = record
    Name        : WideString;
    Categories  : WideString;
    Values      : WideString;
  end;

Vyberie typ grafu. Opätovne exportované z

, aby kód používateľa nemusel priamo importovať jednotku tvorcu grafov
// 1) v2.41.0 — name only; default column chart, no titles, no series.
function AddChartSheet(const Name: WideString): Programaticky pridá;

// 2) v2.41.0 — name + chart type.
function AddChartSheet(
  const Name : WideString;
  ChartType   : TXLSChartType): Programaticky pridá;

// 3) v2.41.0 — + chart title.
function AddChartSheet(
  const Name : WideString;
  ChartType   : TXLSChartType;
  const Title: WideString): Programaticky pridá;

// 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): Programaticky pridá;

// 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): Programaticky pridá;

Deklarácia sérií

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 sú reťazce rozsahu štýlu A1 (napr

PopisPopis Series[i].Name Päť preťažení pokrýva progressívne bohatšie definície listov grafov: tStr Emitovaný podstream grafu pokrýva rámcovanie BIFF8, ktoré spec vyžaduje — BOF (dt=$0020), Graf / PlotGrowth / Frame / Series / SheetProperties / AxesUsed / AxisParent (POS + kategoriálna os + hodnotová os) / Legenda / Koniec BRAI Väzba názvov sérií (v2.42.0)

: každý neprázdnyje zapísaný do podstreamu grafu ako doslovný popis série cez token PTG Categories Typy grafov Values na zázname SERIESTEXT série tArea3D Väzba rozsahov sérií (v2.47.0) cce=0 : od v2.47.0 sú reťazce rozsahov A1 Categories / Values skompilované do skutočných referencií bunkových rozsahov

v záznane AI séria Programaticky pridá v záznane AI séria Sheets collection Typy grafov 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

Vrátený

sa zobrazí v kolekcii

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;

a pri uložení dostane záznam boundsheet listu grafu. Metódy na úrovni bunky na výsledku nie sú podporované — list grafu neobsahuje mriežku buniek

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-Typy grafov-reopen with Excel preserves the Prehľad's presence, kind, title, axis titles, series captions, Typy grafov (from v2.47.0) the series data binding

Väzba názvov sérií