Inbyggda vektordiagram

THPDFChart kombinerar dataserier, axlar, teman, legender, etiketter och tillgänglighetstext i en återanvändbar diagrammodell som renderas av THPDFPage.DrawChart

Renderaren avger PDF-sökvägs- och textoperatorer direkt, så diagram förblir skarpa vid alla zoomnivåer och skapar inga bild-XObjects

Diagrammodell

THPDFChart äger sina THPDFChartSeries-instanser och sina två THPDFChartAxis-objekt, medan varje serie växer sin punktlagring geometriskt för amorterad konstant-tid-append

Anropa THPDFChart.AddSeries med ett THPDFChartKind-värde och lägg sedan till ändliga koordinater genom THPDFChartSeries.AddPoint

THPDFChart.ClearSeries frigör alla ägda serier, medan THPDFChartSeries.Clear behåller seriekonfigurationen och endast tar bort punkterna

Egenskaperna SeriesCount, Series, Count och Points ger indexerad läsåtkomst till modellen

Serier och axlar

• hckLine ritar sammanhängande sökvägar med valfria vektormarkörer och punkteetiketter
• hckBar ritar grupperade staplar runt varje numerisk X-koordinat och inkluderar noll i de automatiska Y-gränserna
• hckArea stänger varje serie mot den synliga nollbaslinjen och använder en temamedveten blandad fyllning
• hckPie ritar en serie med enbart positiva värden som individuellt färgade vektorkliv
• hckScatter ritar oberoende vektormarkörer vid numeriska koordinater

Linje-, stapel-, area- och punktdiagram kan dela ett gemensamt kartesiskt diagram, medan ett cirkeldiagram måste innehålla exakt en hckPie-serie

THPDFChartAxis.AutomaticMinimum och AutomaticMaximum väljer datadrivna gränser; att inaktivera någon av egenskaperna aktiverar motsvarande Minimum- eller Maximum-värde

TickCount begränsas till 2 till 20 vid renderingstillfället, ShowGrid styr axelns rutnätslinjer och NumberFormat levererar det numeriska formatet för tickar och genererade etiketter

Utseende och etiketter

THPDFChartTheme väljer paletterna hctLight, hctDark eller hctMonochrome

THPDFChartLegendPosition väljer ingen legend, en högerlegend eller en bottenlegend genom hclNone, hclRight och hclBottom

Varje serie exponerar Name, Kind, Color, LineWidth, ShowMarkers, ShowLabels och märkt THPDFChartPoint-data

Ställ Color på en riktig TColor för en explicit serie färg eller behåll standardvärdet för att använda den aktiva paletten

Tillgänglighet

THPDFChart.BuildAccessibleText returnerar explicit AlternativeText när det finns, eller bygger en begränsad sammanfattning av titel, serie, etikett, X och Y, med oberoende punkt- och bytegränser

Skicka en strukturförälder till den utökade DrawChart-överlagringen för att omsluta hela diagrammet i en taggad Figure med en Alt-post och en layoutbegränsningsruta

Strukturföräldern bör normalt vara ett element av typ Document, Sect eller en figurbärande layoutelement skapad för den aktuella sidan

Budgetar och statistik

THPDFChartRenderOptions.Default tillåter 64 serier, 100 000 punkter per serie, 1 000 000 totala punkter, 512 synliga etiketter, 64 punkter i genererad tillgänglighetstext och 8 192 tillgänglighetsbyte

Ogiltig geometri, icke-ändliga koordinater, blandat cirkelinnehåll och överskridna serie- eller punktbudgetar avger ett undantag innan ritningen börjar

THPDFChartRenderStatistics rapporterar renderade serier, punkter, etiketter, sökvägssegment, figurtaggning och etikettförkortning

Validerings- och renderingspassen är linjära i antalet serier och punkter, med begränsat etikett- och tillgänglighetsarbete

Stödtyper

Den offentliga ytan består av THPDFChartKind, THPDFChartTheme, THPDFChartLegendPosition, THPDFChartPoint, THPDFChartSeries, THPDFChartAxis, THPDFChart, THPDFChartRenderOptions och THPDFChartRenderStatistics

Exempel

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 även: THPDFPage.DrawChart, Vector Graphics Overview, Automatic PDF/UA Structure