Indbyggede vektordiagrammer

THPDFChart samler dataserier, akser, temaer, forklaringer, etiketter og tilgængelighedstekst i en genbrugelig diagrammodel, der gengives af THPDFPage.DrawChart

Gengiveren udsender PDF-sti- og tekstopratorer direkte, så diagrammer forbliver skarpe på ethvert zoomniveau og ikke opretter Image XObjects

Diagrammodel

THPDFChart ejer sine THPDFChartSeries-instanser og sine to THPDFChartAxis-objekter, mens hver serie udvider punktlageret geometrisk for amortiseret konstanttids-tilføjelse

Kald THPDFChart.AddSeries med en THPDFChartKind-værdi, og tilføj derefter endelige koordinater med THPDFChartSeries.AddPoint

THPDFChart.ClearSeries frigiver alle ejede serier, mens THPDFChartSeries.Clear bevarer seriekonfigurationen og kun fjerner dens punkter

Egenskaberne SeriesCount, Series, Count og Points giver indekseret læseadgang til modellen

Serier og akser

• hckLine tegner sammenhængende stier med valgfrie vektormarkører og punktetiketter
• hckBar tegner grupperede søjler omkring hver numerisk X-koordinat og medtager nul i automatiske Y-grænser
• hckArea lukker hver serie mod den synlige nulgrundlinje og bruger en temabevidst blandet udfyldning
• hckPie tegner én serie med positive værdier som individuelt farvede vektorkiler
• hckScatter tegner uafhængige vektormarkører ved numeriske koordinater

Linje-, søjle-, område- og punktserier kan dele ét kartesisk plot, mens et cirkeldiagram skal indeholde præcis én hckPie-serie

THPDFChartAxis.AutomaticMinimum og AutomaticMaximum vælger datadrevne grænser; deaktivering af en egenskab aktiverer den tilsvarende værdi Minimum eller Maximum

TickCount begrænses til 2 til 20 ved gengivelse, ShowGrid styrer aksegitterlinjer, og NumberFormat leverer det numeriske format for mærker og genererede etiketter

Udseende og etiketter

THPDFChartTheme vælger paletterne hctLight, hctDark eller hctMonochrome

THPDFChartLegendPosition vælger ingen forklaring, en forklaring til højre eller en forklaring i bunden gennem hclNone, hclRight og hclBottom

Hver serie eksponerer Name, Kind, Color, LineWidth, ShowMarkers, ShowLabels og mærkede THPDFChartPoint-data

Angiv Color til en reel TColor for en eksplicit seriefarve, eller behold standardværdien for at bruge den aktive palette

Tilgængelighed

THPDFChart.BuildAccessibleText returnerer eksplicit AlternativeText, når den findes, eller bygger en afgrænset oversigt over titel, serie, etiket, X og Y med uafhængige grænser for punkter og bytes

Send en strukturforælder til den udvidede DrawChart-overbelastning for at indpakke hele diagrammet i en mærket Figure med en Alt-post og layoutafgrænsningsfelt

Strukturforælderen bør normalt være et Document, Sect eller et layoutelement med figurindhold, som er oprettet for den aktuelle side

Budgetter og statistik

THPDFChartRenderOptions.Default tillader 64 serier, 100.000 punkter pr. serie, 1.000.000 punkter i alt, 512 synlige etiketter, 64 punkter i genereret tilgængelighedstekst og 8.192 tilgængelighedsbytes

Ugyldig geometri, ikke-endelige koordinater, blandet cirkelindhold og overskredne serie- eller punktbudgetter udløser en undtagelse, før tegningen begynder

THPDFChartRenderStatistics rapporterer gengivne serier, punkter, etiketter, stisegmenter, figurmærkning og afkortning af etiketter

Validerings- og gengivelsesgennemløbene er lineære i antallet af serier og punkter med afgrænset arbejde for etiketter og tilgængelighed

Understøttende typer

Den offentlige overflade omfatter THPDFChartKind, THPDFChartTheme, THPDFChartLegendPosition, THPDFChartPoint, THPDFChartSeries, THPDFChartAxis, THPDFChart, THPDFChartRenderOptions og THPDFChartRenderStatistics

Eksempel

Chart := THPDFChart.Create;
try
  Chart.Title := 'Quarterly revenue';
  Chart.XAxis.Title := 'Quarter';
  Chart.YAxis.Title := 'Revenue';
  Chart.Theme := hctLight;

  SeriesItem := Chart.AddSeries(hckBar, 'North');
  SeriesItem.ShowLabels := True;
  SeriesItem.AddPoint(1, 120, 'Q1');
  SeriesItem.AddPoint(2, 175, 'Q2');
  SeriesItem.AddPoint(3, 164, 'Q3');

  Options := THPDFChartRenderOptions.Default;
  Document.CurrentPage.DrawChart(
    Chart, 48, 72, 500, 320, Options, Statistics
  );
finally
  Chart.Free;
end;

Se også: THPDFPage.DrawChart, Oversigt over vektorgrafik, Automatisk PDF/UA-struktur