توليد معاينات بصرية لبيانات الجداول الإلكترونية هو طلب شائع عند بناء لوحات تقارير أو ملخصات بريد إلكتروني. Conholdate.Total for Java يوفر مجموعة تطوير برمجيات قوية تُبسّط عملية تحويل Excel إلى صورة في تطبيقات Java. في هذا الدليل ستتعرف على كيفية تحميل مصنف XLSX ، وتكوين إخراج JPEG ، وعرض صفحات ورقة العمل كملفات صورة. في النهاية ستحصل على عينة شفرة جاهزة للتنفيذ يمكنك تعديلها لمشاريعك الخاصة.

ما يتطلبه تحويل ملفات Excel إلى صورة من تطبيقك

غالبًا ما يحتاج المطورون إلى تحويل محتوى جداول البيانات إلى صور ثابتة لمعاينات الويب، أو تقارير PDF، أو صور مصغرة للهواتف المحمولة. عادةً ما تشمل المتطلبات الحفاظ على تنسيق الخلية، وعرض محتوى ورقة العمل بدقة، والتحكم في دقة الصورة. التعامل مع هذه المهام يدويًا بفتح Excel، وأخذ لقطات شاشة، وحفظها لا يتناسب مع الحجم وقد يؤدي إلى نتائج غير متسقة.

القيود التقنية لحل موثوق هي: دعم ملفات XLSX، عرض دقيق لتخطيط ورقة العمل، إمكانية ضبط دقة الصورة، والقدرة على معالجة أوراق العمل التي تمتد عبر صفحات مطبوعة متعددة. يجب أن يتم تشغيل التحويل على خادم أو بيئة سطح مكتب دون الحاجة إلى Microsoft Office.

اختيار Conholdate.Total for Java للوظيفة

Conholdate.Total for Java يقدم واجهة برمجة تطبيقات بسيطة تغطي جميع القدرات المطلوبة. تمنحك فئات Workbook و Worksheet وصولًا مباشرًا إلى محتوى جداول البيانات، بينما توفر ImageOrPrintOptions تحكمًا دقيقًا في الدقة وتنسيق الصورة، وتتعامل SheetRender مع عملية العرض الفعلية صفحة بصفحة. يعمل SDK على أي بيئة تشغيل Java، ويتطلب فقط تبعية Maven، ويتعامل بكفاءة مع دفاتر العمل الكبيرة.

للاطلاع على تفاصيل استخدام API راجع الوثائق الرسمية. المرجع الكامل للفئات مثل Workbook و Worksheet و ImageOrPrintOptions و SheetRender متاح في مرجع API. يمكنك تنزيل أحدث مكتبة من صفحة الإصدار.

تنفيذ تحويل Excel إلى صورة في Java

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

تثبيت Conholdate.Total for Java عبر Maven

أضف مستودع Maven الخاص بـ Conholdate واعتماد SDK إلى ملف pom.xml الخاص بك:

<repositories>
  <repository>
    <id>conholdate-repo</id>
    <name>Conholdate Maven Repository</name>
    <url>https://repository.conholdate.com/repo/</url>
  </repository>
</repositories>

<dependency>
  <groupId>com.conholdate</groupId>
  <artifactId>conholdate-total</artifactId>
  <version>24.9</version>
  <type>pom</type>
</dependency>

تحميل ملف Excel والوصول إلى ورقة العمل

قم بتحميل المصنف باستخدام الفئة Workbook، ثم احصل على مرجع إلى ورقة العمل التي تريد تحويلها:

// Load Excel file
com.aspose.cells.Workbook book = new com.aspose.cells.Workbook("input.xlsx");

// Get the reference of the desired worksheet
com.aspose.cells.Worksheet sheet = book.getWorksheets().get(0);

تكوين خيارات إخراج الصورة لتنسيق JPEG

قم بتعيين دقة الصورة المطلوبة والتنسيق باستخدام ImageOrPrintOptions:`

// Set image options
com.aspose.cells.ImageOrPrintOptions options = new com.aspose.cells.ImageOrPrintOptions();
options.setHorizontalResolution(200);
options.setVerticalResolution(200);
options.setImageType(com.aspose.cells.ImageType.JPEG);

تحويل ورقة العمل إلى صور JPEG

قم بإنشاء SheetRender للورقة وتكرار صفحاتها، مع حفظ كل صفحة كملف JPEG منفصل. قد تمتد الورقة عبر أكثر من صفحة مطبوعة، لذا فإن getPageCount() يخبرك بعدد الصور المتوقعة:

// Convert sheet to JPG image
com.aspose.cells.SheetRender sr = new com.aspose.cells.SheetRender(sheet, options);
for (int j = 0; j < sr.getPageCount(); j++)
{
    sr.toImage(j, "excel-to-jpg" + (j + 1) + ".jpg");
}

الخطوات أعلاه توضح كيفية تحويل Excel إلى صورة باستخدام Conholdate.Total for Java SDK مع منحك التحكم في الدقة، التنسيق، وأوراق العمل متعددة الصفحات.

مثال كامل للكود: تحويل Excel إلى صورة مع دعم كامل للورقة

يعرض الكود التالي التنفيذ الكامل الجاهز للتشغيل كما هو موضح في الخطوات أعلاه.

public class ExcelToImageConverter {
    public static void main(String[] args) throws Exception {
        // Load Excel file
        com.aspose.cells.Workbook book = new com.aspose.cells.Workbook("input.xlsx");

// Get the reference of the desired worksheet
        com.aspose.cells.Worksheet sheet = book.getWorksheets().get(0);

// Set image options
        com.aspose.cells.ImageOrPrintOptions options = new com.aspose.cells.ImageOrPrintOptions();
        options.setHorizontalResolution(200);
        options.setVerticalResolution(200);
        options.setImageType(com.aspose.cells.ImageType.JPEG);

// Convert sheet to JPG image
        com.aspose.cells.SheetRender sr = new com.aspose.cells.SheetRender(sheet, options);
        for (int j = 0; j < sr.getPageCount(); j++)
        {
            sr.toImage(j, "excel-to-jpg" + (j + 1) + ".jpg");
        }

System.out.println("Excel to image conversion completed successfully.");
    }
}

ملاحظة: يوضح مثال الشيفرة هذا الوظيفة الأساسية. قبل استخدامه في مشروعك، تأكد من تحديث مسار الملف (input.xlsx) ليتطابق مع موقع الملف الفعلي لديك، وتحقق من أن جميع الاعتمادات المطلوبة مثبتة بشكل صحيح، واختبر بدقة في بيئة التطوير الخاصة بك. إذا واجهت أي مشكلات، يرجى الرجوع إلى الوثائق الرسمية أو التواصل مع فريق الدعم للحصول على المساعدة.

الخلاصة

تحويل ملفات Excel إلى صورة في Java يصبح بسيطًا عندما تستفيد من Conholdate.Total for Java. يتعامل SDK مع عرض أوراق العمل وإنتاج JPEG عالي الجودة بأقل قدر من الشيفرة. باتباع دليل الخطوة‑بخطوة يمكنك دمج هذه القدرة في أدوات التقارير، مولدات البريد الإلكتروني، أو أي تطبيق يحتاج إلى تمثيلات بصرية لجداول البيانات. تذكر أن عمليات النشر في بيئة الإنتاج تتطلب ترخيصًا تجاريًا؛ يمكنك استكشاف خيارات التسعير على صفحة Conholdate.Total pricing والحصول على ترخيص مؤقت من temporary license page أثناء التقييم.

الأسئلة المتكررة

  • كيف يمكنني تحويل Excel إلى صورة في Java؟
    قم بتحميل الملف باستخدام Workbook، احصل على ورقة العمل التي تحتاجها من book.getWorksheets()، قم بتكوين ImageOrPrintOptions، ثم عرضها باستخدام SheetRender.

  • هل يمكنني تحويل ورقة عمل Excel محددة إلى صورة؟
    نعم. استخدم book.getWorksheets().get(index) لتحديد ورقة العمل، ثم مررها إلى SheetRender للتحويل.

  • لماذا أحصل على أكثر من ملف صورة من ورقة عمل واحدة؟
    يمكن أن تمتد ورقة العمل عبر عدة صفحات مطبوعة. SheetRender.getPageCount() تُعيد عدد الصفحات، وتقوم الحلقة بحفظ صورة واحدة لكل صفحة.

  • ما الترخيص المطلوب للاستخدام في الإنتاج؟
    يتطلب ترخيص تجاري. راجع التكاليف على صفحة تسعير Conholdate.Total واحصل على ترخيص مؤقت من صفحة صفحة الترخيص المؤقت.

اقرأ المزيد