تخصيص جداول بيانات المخططات في العروض التقديمية باستخدام Java

نظرة عامة

يتيح لك Aspose.Slides for Java عرض جدول بيانات المخطط وتخصيص تنسيق النص والحدود ومفاتيح الأسطورة. يشرح هذا المقال كيفية تمكين الجدول وتنسيق نصه والتحكم في كل نوع من الحدود وعرض أو إخفاء مفاتيح الأسطورة. تُحفظ الأمثلة المخططات المُكوَّنة في ملفات PPTX.

تعيين خصائص الخط

لعرض جدول بيانات المخطط، مرّر true إلى setDataTable. استخدم getChartDataTable للوصول إلى الجدول وتكوين تنسيق النص الخاص به.

  1. حمل العرض التقديمي باستخدام الفئة Presentation.
  2. أضف مخطط عمودي مجمع إلى الشريحة الأولى.
  3. فعّل جدول بيانات المخطط.
  4. فعّل النص الغامق باستخدام setFontBold ومرّر 20 إلى setFontHeight للنص بحجم 20 نقطة.
  5. احفظ العرض التقديمي المُعدل.

المثال التالي يتطلب وجود test.pptx في دليل العمل مع وجود شريحة واحدة على الأقل. يضيف مخططًا ببيانات افتراضية في الموضع (50, 50)، بعرض 600 نقطة وارتفاع 400 نقطة. يحتوي ملف output.pptx المحفوظ على المخطط مع تمكين جدول البيانات وتطبيق إعدادات الخط المحددة.

import com.aspose.slides.*;

Presentation presentation = new Presentation("test.pptx");
try {
    ISlide slide = presentation.getSlides().get_Item(0);

    IChart chart = slide.getShapes().addChart(ChartType.ClusteredColumn, 50, 50, 600, 400);
    chart.setDataTable(true);

    IChartPortionFormat portionFormat = chart.getChartDataTable().getTextFormat().getPortionFormat();
    portionFormat.setFontBold(NullableBool.True);
    portionFormat.setFontHeight(20);

    presentation.save("output.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

تخصيص حدود جدول البيانات

فعّل الجدول باستخدام IChart.setDataTable وادخله عبر IChart.getChartDataTable. يمكنك التحكم في ثلاثة أنواع من الحدود بشكل مستقل:

مرّر true إلى كل طريقة لعرض حدودها أو false لإخفائها. المثال التالي ينشئ مخطط عمودي مجمع ببيانات افتراضية، يعرض الحدود الأفقية والحد الخارجي، ويخفي الحدود العمودية. لا يتطلب أي ملف إدخال. يتم تحديد موضع وحجم المخطط بالنقاط.

import com.aspose.slides.*;

Presentation presentation = new Presentation();
try {
    ISlide slide = presentation.getSlides().get_Item(0);

    IChart chart = slide.getShapes().addChart(ChartType.ClusteredColumn, 50, 50, 600, 400);
    chart.setDataTable(true);

    IDataTable dataTable = chart.getChartDataTable();
    dataTable.setBorderHorizontal(true);
    dataTable.setBorderVertical(false);
    dataTable.setBorderOutline(true);

    presentation.save("data-table-borders.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

المقارنة أدناه تستخدم نفس بيانات المخطط وإعدادات مفتاح الأسطورة في جميع الحالات الأربعة. يبدأ بتمكين جميع الحدود، ثم يعطّل كل متغيّر حد واحد فقط. المتغيّر في الأسفل الأيسر يطابق إعدادات الحدود في المثال.

جداول بيانات المخطط مع تمكين جميع الحدود، بدون حدود أفقية، بدون حدود عمودية، وبدون حد خارجي

عرض أو إخفاء مفاتيح الأسطورة

مفاتيح الأسطورة هي علامات ملونة صغيرة بجانب أسماء السلاسل في جدول البيانات. تساعد القارئ على مطابقة كل صف في الجدول مع سلسلة المخطط. مرّر true إلى setShowLegendKey لعرض هذه العلامات أو false لإخفائها.

يتم التحكم في الأسطورة المنفصلة للمخطط عبر IChart.setLegend. هذه الإعدادات مستقلة: إخفاء الأسطورة المنفصلة لا يخفي المفاتيح داخل جدول البيانات، وإخفاء مفاتيح الجدول لا يخفي الأسطورة المنفصلة.

المثال التالي ينشئ مخططًا ببيانات افتراضية، يفعّل جدول بياناته، ويظهر مفاتيح الأسطورة داخله مع إخفاء الأسطورة المنفصلة. جميع حدود الجدول مفعلة صراحةً. لا يلزم أي عرض تقديمي كمدخل. لإخفاء مفاتيح الجدول فقط، مرّر false إلى setShowLegendKey.

import com.aspose.slides.*;

Presentation presentation = new Presentation();
try {
    ISlide slide = presentation.getSlides().get_Item(0);

    IChart chart = slide.getShapes().addChart(ChartType.ClusteredColumn, 50, 50, 600, 400);
    chart.setDataTable(true);
    chart.setLegend(false);

    IDataTable dataTable = chart.getChartDataTable();
    dataTable.setBorderHorizontal(true);
    dataTable.setBorderVertical(true);
    dataTable.setBorderOutline(true);
    dataTable.setShowLegendKey(true);

    presentation.save("data-table-legend-keys.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

المقارنة أدناه تُظهر نفس الجدول مع تمكين مفاتيح الأسطورة وتعطيلها. تبقى جميع الحدود مفعلة، وتكون الأسطورة المنفصلة للمخطط مخفية في الحالتين.

جداول بيانات المخطط مع إظهار مفاتيح الأسطورة على اليسار وإخفائها على اليمين

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

هل يمكنني عرض مفاتيح الأسطورة في جدول بيانات المخطط؟

نعم. مرّر true إلى setShowLegendKey لعرض مفاتيح الأسطورة أو false لإخفائها.

هل سيُحافظ على جدول البيانات عند تصدير العرض التقديمي إلى PDF أو HTML أو صور؟

نعم. يقوم Aspose.Slides برندرة المخطط وجدول البيانات المعروض كجزء من الشريحة عند التصدير إلى PDF، HTML، أو الصور.

هل يمكنني العمل مع جداول البيانات في المخططات التي تم تحميلها من قالب؟

نعم. بالنسبة لمخطط تم تحميله من عرض تقديمي أو قالب موجود، استخدم hasDataTable وsetDataTable للتحقق أو تغيير ما إذا كان جدول البيانات الخاص به معروضًا.

كيف يمكنني العثور على المخططات التي لديها جدول بيانات مفعّل؟

قم بالتكرار عبر الأشكال في كل شريحة، حدد المخططات، واستدعِ طريقة hasDataTable. القيمة true تشير إلى أن جدول البيانات مفعَّل.