THPDFPage.DrawChart
render ข้อมูลแบบ line, bar, area, pie หรือ scatter ออกมาเป็น vector และ text ของ PDF แท้ ๆ ภายใน rect ที่ผู้เรียกกำหนด
การประกาศ
procedure DrawChart(Chart: THPDFChart;
X, Y, Width, Height: Single); overload;
procedure DrawChart(Chart: THPDFChart;
X, Y, Width, Height: Single;
const Options: THPDFChartRenderOptions;
out Statistics: THPDFChartRenderStatistics); overload;
procedure DrawChart(Chart: THPDFChart;
X, Y, Width, Height: Single;
const Options: THPDFChartRenderOptions;
out Statistics: THPDFChartRenderStatistics;
StructureParent: THPDFDictionaryObject); overload;
พารามิเตอร์
| ชื่อ | คำอธิบาย |
|---|---|
Chart | chart model ที่ผู้เรียกเป็นเจ้าของ สำหรับ validate แล้ว render |
X, Y | ตำแหน่งซ้ายบนของ chart ในระบบพิกัดของหน้า |
Width, Height | rect ของ chart ต้องกว้าง x สูงอย่างน้อย 120 x 100 พอยต์ |
Options | เพดานหรือสวิตช์ของ series, point, label, accessibility, title, axis และ grid |
Statistics | รับจำนวน object ที่ render งาน path สถานะ tagging และการตัด label |
StructureParent | structure parent ของหน้าปัจจุบันแบบเลือกได้ ใช้สร้าง Figure ที่มี tagging พร้อม alternate text |
ค่าที่ส่งกลับ
procedure นี้ไม่คืนค่า ส่วน overload แบบขยายจะรายงานผลผ่าน Statistics
หมายเหตุการใช้งาน
- overload แบบง่ายใช้
THPDFChartRenderOptions.Default - renderer จะ validate model ทั้งชุดก่อน แล้วจึง save graphics state หรือ emit operator สั่งวาด
- series แบบ Cartesian ผสมกันได้ แต่ pie chart ต้องมี pie series เดียวเท่านั้น
- ค่า pie ที่เป็นศูนย์หรือติดลบจะถูกข้าม และต้องมีค่าบวกอย่างน้อยหนึ่งค่า
- label ที่แสดงจะหยุดที่
MaxLabelsโดยไม่ทิ้ง path หรือ point ใด ๆ - accessibility text ที่สร้างขึ้นอัตโนมัติมีงบ point กับ byte แยกกัน
- ถ้า
StructureParentไม่ใช่ nil หน้านี้ต้องเป็น current page ของเอกสารด้วย - ผู้เรียกเป็นเจ้าของ chart object ส่วน chart เป็นเจ้าของ series และ storage ของ point เอง