العمل مع الرسوم البيانية
العمل مع الرسوم البيانية
Aspose.Cells FOSS for Java preserves embedded charts when loading and saving XLSX workbooks. You can inspect existing charts, query their type and position, and add new standard-type charts programmatically. ChartEx types such as Waterfall, Treemap, Sunburst, Histogram, Box and Whisker, Funnel, and Map are preserved on round-trip but cannot be created through the API.
نظرة عامة
يتم إدارة الرسوم البيانية في ورقة عمل من خلال الموقع الإلكتروني. ChartCollection يمكن الوصول إليها عبر: Worksheet.getCharts().كل واحد منهم Chart مثال يعرض اسمه، نوع الرسم البياني., ووضع الصلع المكون من خلية اثنين. يتم إدراج مخطط جديد مع ChartCollection.add(type, dataRange, upperLeftRow, upperLeftColumn, lowerRightRow, lowerRightColumn), الذي يعيد مؤشر الرسم البياني الجديد.
المجلس الوزاري ChartType يحدد enum نوع الرسم البياني (البار، الخط، الفطيرة، الخ). طرق مساعدة ChartCollection.parseChartType(string) و ChartCollection.chartTypeToString(ChartType) تحويل بين enum و تمثيل السلسلة الخاصة بها في حالات استخدام التسلسلية.
الدرجات الرئيسية
| الفئة | وصف |
|---|---|
Chart | يمثل مخططًا مدمجًة في ورقة عمل. قراءة الوصول إلى الاسم، النوع، وموقع الركيز الخلية. |
ChartCollection | مجموعة من جميع الرسوم البيانية على ورقة عمل. يدعم العد، الوصول المؤشر، إضافة، ونوع المخططات مساعدة التحويل. |
ChartType | إينوم يحدد متغير الرسم البياني (الصف، العمود، الخط، الفطيرة، التبديل، الخ). |
ChartModel | نموذج التسلسلية الداخلية للشريحة. يعرض حقول XML الخام المستخدمة أثناء تحميل / حفظ. |
الوصول إلى المخططات على ورقة عمل
استعادة الملفات ChartCollection من أيّ Worksheet كائن عبر Worksheet.getCharts().استخدمها . ChartCollection.getCount() لتحديد عدد يتم الوصول إلى الرسوم البيانية الفردية بواسطة مؤشر قائم على الصفر من خلال ChartCollection.get(index).
بمجرد أن تمسك بـ… Chart الإشارة التي يمكنك قراءتها:
Chart.getName()السلسلة الداخلية للاسم في المخطط.Chart.getChartType()المنتدىChartTypeقيمة enum.Chart.getUpperLeftRow()/Chart.getUpperLeftColumn()خلية المراسي العليا اليسرى.Chart.getLowerRightRow()/Chart.getLowerRightColumn()خلية المراسي في الأسفل اليمنى.Chart.getExtentCx()/Chart.getExtentCy()الرسم البياني يمتد في وحدات النقد الأوروبي.
إضافة مخطط جديد
استخدام ChartCollection.add(type, dataRange, upperLeftRow, upperLeftColumn, lowerRightRow, lowerRightColumn) لإدراج مخطط جديد. تعيد الطريقة مؤشر عدد كامل من الرسم البياني داخل جمع. ChartType قيمة المعدل type حجة وخلية سلسلة نطاق (على سبيل المثال: A1:B5) لـ dataRange.
ملاحظة: يتم الحفاظ على أنواع عائلة ChartEx (Waterfall ، Treemap ، Sunburst ، Histogram ، Box and Whisker ، Funnel ، Map) عند تحميل ملفات XLSX ولكن لا يمكن إنشاؤها برمجياً عبر هذا API.
إشارة API
الرسم البياني
| طريقة | نوع الإرجاع | وصف |
|---|---|---|
getName() | String | الاسم الداخلي للمخطط. |
getChartType() | ChartType | قيمة enum المتغير في الرسم البياني. |
getUpperLeftRow() | int | مؤشر الصف في الرفع الأيسر. |
getUpperLeftColumn() | int | مؤشر العمود في الرفع الأيسر. |
getLowerRightRow() | int | مؤشر الصف في أسفل اليمين. |
getLowerRightColumn() | int | مؤشر العمود في أسفل اليمين. |
getExtentCx() | long | عرض الرسم البياني في وحدات النقد الأوروبي. |
getExtentCy() | long | ارتفاع الرسم البياني في وحدات النقد الأوروبي. |
ChartCollection
| طريقة | نوع الإرجاع | وصف |
|---|---|---|
getCount() | int | عدد المخططات على ورقة العمل. |
get(index) | Chart | يعيد الرسم البياني عند المؤشر المحدد على أساس الصفر. |
add(type, dataRange, ...) | int | يضيف مخطط جديد، يعيد فهرسه. |
parseChartType(string) | ChartType | يحول اسم السلسلة إلى a ChartType قيمة enum. |
chartTypeToString(type) | String | تحويل a ChartType قيمة enum إلى اسم السلسلة. |
القيود
- أنواع ChartEx (Waterfall ، Treemap ، Sunburst ، Histogram ، Box and Whisker ، Funnel ، Map) هي عبارة عن إعادة تدوير حرفيًا ولكن لا يمكن إنشاؤها عبر API.
- لا يمكن تعديل ربط سلسلة بيانات الرسم البياني في هذا الإصدار؛ يقدم الرسوم البيانية استنادا إلى نطاق البیان الأصلي المقدم عند إنشاءها.
