استخدام المخططات البيانية في Aspose.Words للغة Java

مقدمة حول استخدام المخططات البيانية في Aspose.Words للغة Java

في هذا البرنامج التعليمي، سنستكشف كيفية العمل مع المخططات باستخدام Aspose.Words for Java. ستتعلم كيفية إنشاء أنواع مختلفة من المخططات، وتخصيص خصائص المحور، وتنسيق تسميات البيانات، والمزيد. لنبدأ!

إنشاء مخطط خطي

لإنشاء مخطط خطي، استخدم الكود التالي:

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
Shape shape = builder.insertChart(ChartType.LINE, 432.0, 252.0);
Chart chart = shape.getChart();
chart.getTitle().setText("Data Labels With Different Number Format");

// حذف السلسلة المولدة افتراضيا.
chart.getSeries().clear();

// إضافة سلسلة تحتوي على بيانات وعناوين بيانات.
ChartSeries series1 = chart.getSeries().add("Aspose Series 1", 
    new String[] { "Category 1", "Category 2", "Category 3" }, 
    new double[] { 2.5, 1.5, 3.5 });

series1.hasDataLabels(true);
series1.getDataLabels().setShowValue(true);
series1.getDataLabels().get(0).getNumberFormat().setFormatCode("\"$\"#,##0.00");
series1.getDataLabels().get(1).getNumberFormat().setFormatCode("dd/mm/yyyy");
series1.getDataLabels().get(2).getNumberFormat().setFormatCode("0.00%");

// أو قم بربط كود التنسيق بخلية المصدر.
series1.getDataLabels().get(2).getNumberFormat().isLinkedToSource(true);

doc.save("Your Directory Path" + "WorkingWithCharts.FormatNumberOfDataLabel.docx");

إنشاء أنواع أخرى من المخططات البيانية

يمكنك إنشاء أنواع مختلفة من المخططات مثل المخطط العمودي والمخطط المساحي والمخطط الفقاعي والمخطط المبعثر وغير ذلك باستخدام تقنيات مماثلة. فيما يلي مثال لإدراج مخطط عمودي بسيط:

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
Shape shape = builder.insertChart(ChartType.COLUMN, 432.0, 252.0);
Chart chart = shape.getChart();

// حذف السلسلة المولدة افتراضيا.
chart.getSeries().clear();

// إنشاء الفئات وإضافة البيانات.
String[] categories = new String[] { "Category 1", "Category 2" };
chart.getSeries().add("Aspose Series 1", categories, new double[] { 1.0, 2.0 });
chart.getSeries().add("Aspose Series 2", categories, new double[] { 3.0, 4.0 });

doc.save("Your Directory Path" + "WorkingWithCharts.InsertSimpleColumnChart.docx");

تخصيص خصائص المحور

يمكنك تخصيص خصائص المحور، مثل تغيير نوع المحور، وتعيين علامات التجزئة، وتنسيق العلامات، والمزيد. فيما يلي مثال لتحديد خصائص المحور X وY:

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
Shape shape = builder.insertChart(ChartType.AREA, 432.0, 252.0);
Chart chart = shape.getChart();

// مسح السلسلة الافتراضية وإضافة البيانات الخاصة بك.

ChartAxis xAxis = chart.getAxisX();
ChartAxis yAxis = chart.getAxisY();

// تغيير المحور X ليكون فئة بدلاً من التاريخ.
xAxis.setCategoryType(AxisCategoryType.CATEGORY);
xAxis.setCrosses(AxisCrosses.CUSTOM);
xAxis.setCrossesAt(3.0); // يتم قياسها بوحدات العرض لمحور Y (المئات).
xAxis.setReverseOrder(true);
xAxis.setMajorTickMark(AxisTickMark.CROSS);
xAxis.setMinorTickMark(AxisTickMark.OUTSIDE);
xAxis.setTickLabelOffset(200);

yAxis.setTickLabelPosition(AxisTickLabelPosition.HIGH);
yAxis.setMajorUnit(100.0);
yAxis.setMinorUnit(50.0);
yAxis.getDisplayUnit().setUnit(AxisBuiltInUnit.HUNDREDS);
yAxis.getScaling().setMinimum(new AxisBound(100.0));
yAxis.getScaling().setMaximum(new AxisBound(700.0));

doc.save("Your Directory Path" + "WorkingWithCharts.DefineXYAxisProperties.docx");

تنسيق تسميات البيانات

يمكنك تنسيق تسميات البيانات باستخدام تنسيقات أرقام مختلفة. إليك مثال:

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
Shape shape = builder.insertChart(ChartType.COLUMN, 432.0, 252.0);
Chart chart = shape.getChart();

// مسح السلسلة الافتراضية وإضافة البيانات الخاصة بك.

chart.getAxisY().getNumberFormat().setFormatCode("#,##0");

doc.save("Your Directory Path" + "WorkingWithCharts.NumberFormatForAxis.docx");

تخصيصات إضافية للرسم البياني

يمكنك تخصيص مخططاتك بشكل أكبر عن طريق ضبط الحدود ووحدات الفاصل بين العلامات وإخفاء محاور المخطط والمزيد. استكشف مقتطفات التعليمات البرمجية المقدمة لمعرفة المزيد حول هذه الخيارات.

خاتمة

في هذا البرنامج التعليمي، استكشفنا كيفية العمل مع المخططات باستخدام Aspose.Words for Java. لقد تعلمت كيفية إنشاء أنواع مختلفة من المخططات، وتخصيص خصائص المحور، وتنسيق تسميات البيانات، والمزيد. يوفر Aspose.Words for Java أدوات قوية لإضافة تمثيلات مرئية للبيانات إلى مستنداتك، مما يعزز الطريقة التي تقدم بها المعلومات.

الأسئلة الشائعة

كيف يمكنني إضافة سلاسل متعددة إلى مخطط؟

يمكنك إضافة سلاسل متعددة إلى مخطط باستخدامchart.getSeries().add() الطريقة. تأكد من تحديد اسم السلسلة والفئات وقيم البيانات.

كيف يمكنني تنسيق تسميات البيانات باستخدام تنسيقات الأرقام المخصصة؟

يمكنك تنسيق تسميات البيانات عن طريق الوصول إلىDataLabels خصائص السلسلة وتعيين كود التنسيق المطلوب باستخدامgetNumberFormat().setFormatCode().

كيف أقوم بتخصيص خصائص المحور في الرسم البياني؟

يمكنك تخصيص خصائص المحور مثل النوع وعلامات التجزئة والعلامات والمزيد من خلال الوصول إلىChartAxis خصائص مثلsetCategoryType(), setCrosses() ، وsetMajorTickMark().

كيف يمكنني إنشاء أنواع أخرى من الرسوم البيانية مثل الرسوم البيانية المنتشرة أو الرسوم البيانية المساحية؟

يمكنك إنشاء أنواع مختلفة من المخططات من خلال تحديد النوع المناسبChartType عند إدخال الرسم البياني باستخدامbuilder.insertChart(ChartType.TYPE, width, height).

كيف يمكنني إخفاء محور الرسم البياني؟

يمكنك إخفاء محور الرسم البياني عن طريق ضبطsetHidden(true) خاصية المحور.