مرجع HotPDF

يجمع THPDFChart بين سلاسل البيانات (series) والمحاور والسمات (themes) والمفاتيح التوضيحية (legends) والتسميات ونص إمكانية الوصول (accessibility) في نموذج رسم بياني قابل لإعادة الاستخدام تعرضه THPDFPage.DrawChart

يُصدِر المُعرِض (renderer) مُعامِلات مسار ونص PDF مباشرة، لذا تبقى الرسوم البيانية حادة عند أي مستوى تكبير ولا تُنشئ Image XObjects

نموذج الرسم البياني

يمتلك THPDFChart نُسَخ THPDFChartSeries الخاصة به وكائنَي THPDFChartAxis، بينما تنمو مساحة تخزين النقاط لكل سلسلة بشكل هندسي لتحقيق إلحاق (append) بزمن ثابت مُستهلَك (amortised)

استدعِ THPDFChart.AddSeries بقيمة من THPDFChartKind، ثم أضف إحداثيات منتهية عبر THPDFChartSeries.AddPoint

تُحرِّر THPDFChart.ClearSeries كل السلاسل المملوكة، بينما تحتفظ THPDFChartSeries.Clear بإعدادات السلسلة وتزيل نقاطها فقط

توفر الخصائص SeriesCount وSeries وCount وPoints وصولًا للقراءة مُفهرَسًا (indexed) إلى النموذج

السلاسل والمحاور

ترسم hckLine مسارات متصلة مع علامات متجهية (vector markers) اختيارية وتسميات للنقاط
ترسم hckBar أعمدة مُجمَّعة حول كل إحداثي X رقمي، وتُضمِّن الصفر في حدود Y التلقائية
تُغلِق hckArea كل سلسلة عند خط الأساس الصفري الظاهر، وتستخدم تعبئة مُمزَجة (blended) واعية بالسمة (theme)
ترسم hckPie سلسلة واحدة موجبة القيم كقطاعات متجهية (wedges) مُلوَّنة كل على حدة
ترسم hckScatter علامات متجهية مستقلة عند إحداثيات رقمية

يمكن لسلاسل الخط والأعمدة والمساحة والتشتت (scatter) أن تشترك في رسم بياني ديكارتي (Cartesian) واحد، بينما يجب أن يحتوي الرسم البياني الدائري على سلسلة hckPie واحدة بالضبط

تحدد THPDFChartAxis.AutomaticMinimum وAutomaticMaximum حدودًا مبنية على البيانات؛ وتعطيل أي من الخاصيتين يُفعِّل قيمة Minimum أو Maximum المقابلة لها

تُقيَّد TickCount بين 2 و20 عند وقت العرض، وتتحكم ShowGrid في خطوط شبكة المحور، وتوفر NumberFormat تنسيق الأرقام للعلامات (ticks) والتسميات المولَّدة

السلاسل والمحاور

تحدد THPDFChartTheme لوحات الألوان hctLight أو hctDark أو hctMonochrome

تحدد THPDFChartLegendPosition عدم وجود مفتاح توضيحي، أو مفتاح على اليمين، أو مفتاح في الأسفل عبر hclNone وhclRight وhclBottom

تكشف كل سلسلة Name وKind وColor وLineWidth وShowMarkers وShowLabels وبيانات THPDFChartPoint المُسمَّاة

اضبط Color على قيمة TColor فعلية للحصول على لون صريح للسلسلة، أو اترك القيمة الافتراضية لاستخدام لوحة الألوان النشطة

السلاسل والمحاور

تُعيد THPDFChart.BuildAccessibleText نص AlternativeText الصريح عند وجوده، أو تبني ملخصًا محدودًا للعنوان والسلاسل والتسميات ومحوري X وY، بحدود مستقلة للنقاط والبايتات

مرِّر أبًا بنيويًا (structure parent) إلى التحميل الزائد الموسَّع لـ DrawChart لتغليف الرسم البياني بالكامل ضمن Figure مُوسوم (tagged) مع إدخال Alt ومربع إحاطة تخطيطي (layout bounding box)

يجب أن يكون الأب البنيوي عادة عنصر Document أو Sect أو عنصر تخطيط يحتوي على figure تم إنشاؤه للصفحة الحالية

السلاسل والمحاور

تسمح THPDFChartRenderOptions.Default بـ 64 سلسلة، و100,000 نقطة لكل سلسلة، ومليون نقطة إجمالاً، و512 تسمية مرئية، و64 نقطة في نص إمكانية الوصول المولَّد، و8,192 بايت لإمكانية الوصول

الهندسة غير الصالحة والإحداثيات غير المنتهية (non-finite) ومحتوى الرسم الدائري (pie) المختلط وتجاوز ميزانيات السلاسل أو النقاط، كلها تثير استثناءً قبل بدء الرسم

تُبلِّغ THPDFChartRenderStatistics عن السلاسل والنقاط والتسميات المرسومة، وأجزاء المسار، ووسم الـ figure، واقتطاع التسميات

السلاسل والمحاور

تتألف الواجهة العامة من THPDFChartKind وTHPDFChartTheme وTHPDFChartLegendPosition وTHPDFChartPoint وTHPDFChartSeries وTHPDFChartAxis وTHPDFChart وTHPDFChartRenderOptions وTHPDFChartRenderStatistics

السلاسل والمحاور

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;

انظر أيضًا: THPDFPage.DrawChart، نظرة عامة على الرسوميات المتجهية، بنية PDF/UA التلقائية