أدخل رأس وتذييل في Excel باستخدام Apache POI لجافا

Apache POI هي مكتبة Java شهيرة تتيح لك العمل مع تنسيقات Microsoft Office ، بما في ذلك جداول بيانات Excel. تعمل وحدة XSSF (تنسيق جدول بيانات XML) من Apache POI مع ملفات Excel بتنسيق XML الأحدث ، المعروف باسم . XLSX . الرؤوس والتذييلات في Excel هي المناطق الموجودة في أعلى وأسفل كل صفحة في ورقة عمل حيث يمكنك وضع محتوى مثل العناوين وأرقام الصفحات والتواريخ والمعلومات الأخرى ذات الصلة. يوفر Apache POI وظائف للعمل مع رؤوس وتذييلات باستخدام وحدة XSSF. إليك كيف يمكنك العمل مع الرؤوس والتذييلات باستخدام Apache POI XSSF.

إنشاء رؤوس وتذييلات في Excel باستخدام Java

لإنشاء رؤوس وتذييلات ، تحتاج أولاً إلى الحصول على مثيل لفئة XSSFSHEET من مصنفك. بعد ذلك ، يمكنك استخدام أساليب Getheader () و getFooter () للوصول إلى كائنات الرأس والتذييل على التوالي. يمكنك تعيين محتوى مختلف للأجزاء اليسرى والوسط والأجزاء اليمنى من الرأس/التذييل باستخدام طرق مثل setLeft () ، setCenter () ، و setRight () .

Apache Poi Java Code لإضافة رؤوس وتذييلات إلى ملفات Excel في Java

يمكن استخدام رمز Java التالي من Apache POI لإدراج الرؤوس والتذييلات لإثارة الملفات.

XSSFWorkbook wb = new XSSFWorkbook();
XSSFSheet sheet = (XSSFSheet) wb.createSheet("new sheet");
// Create a first page header
Header header = sheet.getFirstHeader();
header.setCenter("Center First Page Header");
header.setLeft("Left First Page Header");
header.setRight("Right First Page Header");
// Create an even page header
Header header2 = sheet.getEvenHeader();
header2.setCenter("Center Even Page Header");
header2.setLeft("Left Even Page Header");
header2.setRight("Right Even Page Header");
// Create an odd page header
Header header3 = sheet.getOddHeader();
header3.setCenter("Center Odd Page Header");
header3.setLeft("Left Odd Page Header");
header3.setRight("Right Odd Page Header");
// Set/Remove Header properties
XSSFHeaderFooterProperties prop = sheet.getHeaderFooterProperties();
prop.setAlignWithMargins(true);
prop.setScaleWithDoc(true);
prop.removeDifferentFirst(); // This does not remove first page headers or footers
prop.removeDifferentOddEven(); // This does not remove even headers or footers
//Working with Footer
Footer footer = sheet.getFooter();
footer.setLeft("Left Footer");
footer.setCenter("Center Footer");
footer.setRight("Right Footer");
try (FileOutputStream fileOut = new FileOutputStream("workbook.xlsx")) {
    wb.write(fileOut);
}

تحصل عينة الرمز أعلاه على ثلاثة أنواع من الرؤوس من الورقة ، أي المركز ، وحتى الصفحة ، ورؤوس الصفحات الفردية. يتم استخدام فئة الرأس لهذا الغرض. يوفر Apache POI الخيارات للحصول على رؤوس الصفحات المتساوية والغريبة لتعيينها بشكل صريح. هذا يتيح لك السيطرة على رؤوس الصفحات المختلفة والغريبة. يتم استخدام طرق getVevenheader و getoddheader لفئة xssfsheet للحصول على كائنات الرأس هذه للمعالجة.

أحرف خاصة وتنسيق

يمكن أن تحتوي الرؤوس والتذييلات على تنسيق خاص وذات نائبة للحصول على معلومات ديناميكية. يدعم Apache POI العناصر النائبة مثل & [page] و & date] و & [time] لإدراج أرقام الصفحات والتواريخ والأوقات تلقائيًا.

footer.setCenter("Page &[Page] of &[Pages]");

مختلف للصفحة الأولى

يمكن أن تكون الرؤوس والتذييلات مختلفة في الصفحة الأولى والصفحات الفردية/حتى. يمكنك استخدام setfirsTheader () ، setfirstfooter () ، setoddheader () ، و Methodddfooter () طرق لضبط محتوى مختلف لسيناريوهات مختلفة.

header.setFirstHeader("First Page Header");
footer.setOddFooter("Odd Page Footer");

إعداد رأس/تذييل

يمكنك أيضًا التحكم في حجم الرأس/التذييل باستخدام طرق setheadermargin () و setFooterMargin () .

sheet.getHeader().setHeaderMargin(0.5); // Set header margin to 0.5 inches
sheet.getFooter().setFooterMargin(0.5); // Set footer margin to 0.5 inches

تطهير الرؤوس والتذييل

إذا كنت ترغب في إزالة الرأس أو التذييل ، فيمكنك استخدام طريقة Clear () .

header.clear(); // Clear the header content
footer.clear(); // Clear the footer content

الخاتمة

يتيح لك العمل مع الرؤوس والتذييلات في Apache Poi XSSF تخصيص ظهور أوراق عمل Excel وإضافة معلومات مهمة إلى المستندات المطبوعة أو المحفوظة. من خلال الاستفادة من الميزات التي توفرها Apache POI ، يمكنك بسهولة إدارة الرؤوس والتذييلات لتلبية متطلباتك المحددة. لمزيد من الأمثلة على العمل مع Apache POI لمعالجة مستندات Excel الخاصة بك في Java ، يرجى ترقب.