أضف علامة مائية إلى ورقة Excel في Java

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

يتم تناول الموضوعات التالية أدناه:

Java API إلى Watermark Excel Sheets

GroupDocs.Watermark for Java هي واجهة برمجة التطبيقات لأتمتة العلامات المائية للمستندات والعروض التقديمية والصور والعديد من تنسيقات الملفات الأخرى. القائمة الكاملة لتنسيقات المستندات المدعومة متاحة في الوثائق.

يمكنك تنزيل ملف JAR من قسم التنزيلات أو استخدام أحدث تكوينات التبعية Maven داخل تطبيقات Java الخاصة بك.

<repository>
	<id>GroupDocsJavaAPI</id>
	<name>GroupDocs Java API</name>
	<url>https://repository.groupdocs.com/repo/</url>
</repository>
<dependency>
        <groupId>com.groupdocs</groupId>
        <artifactId>groupdocs-watermark</artifactId>
        <version>21.3</version> 
</dependency>

علامة مائية على أوراق Excel باستخدام Java

توفر واجهة برمجة التطبيقات الخاصة بالعلامة المائية التخصيص أثناء إدراج العلامة المائية في جداول البيانات كنص. فيما يلي خطوات إضافة علامات مائية إلى مصنفات Excel في Java.

  • قم بتحميل جدول البيانات المصدر باستخدام Watermarker و SpreadsheetLoadOptions.
  • حدد خصائص نص العلامة المائية والمظهر باستخدام TextWatermark.
  • أضف العلامة المائية المحددة إلى ورقة عمل Excel باستخدام add () mehtod.
  • احفظ جدول البيانات الناتج بالعلامة المائية باستخدام طريقة save ().

يضيف نموذج كود Java التالي العلامة المائية النصية إلى جميع أوراق مصنف Excel مع التدوير والتعتيم ومحاذاة المجموعة.

/*
 * أضف علامة مائية إلى جميع أوراق Excel Workbook في Java
 */
// قم بتحميل جدول البيانات
String filename = "path/spreadsheet.xlsx";
Watermarker watermarker = new Watermarker(filename, new SpreadsheetLoadOptions());

// تعيين مظهر نص العلامة المائية
TextWatermark watermark = new TextWatermark("DRAFT", new Font("Segoe UI", 19));
watermark.setHorizontalAlignment(HorizontalAlignment.Center);
watermark.setVerticalAlignment(VerticalAlignment.Center);
watermark.setRotateAngle(-45);
watermark.setSizingType(SizingType.ScaleToParentDimensions);
watermark.setScaleFactor(0.5);
watermark.setOpacity(0.5);

// أضف علامة مائية واحفظ جدول البيانات بعلامة مائية
watermarker.add(watermark);
watermarker.save("path/watermark-all-spreadsheet.xlsx");
watermarker.close();

ورقة إكسل محددة باستخدام علامة مائية باستخدام Java

وبالمثل ، يمكنك أيضًا إدراج علامات مائية في أي ورقة مفردة من المصنف. دليل الخطوات التالية حول كيفية تطبيق علامة مائية نصية على ورقة معينة من مصنف Excel في Java.

  • قم بتحميل جدول البيانات باستخدام Watermarker.
  • اضبط مظهر العلامة المائية والنص باستخدام TextWatermark.
  • قم بتعيين فهرس ورقة العمل بحيث يتم تطبيق العلامة المائية على الورقة المذكورة فقط.
  • أضف العلامة المائية النصية إلى ورقة عمل Excel باستخدام add () mehtod مع خيارات العلامة المائية.
  • احفظ جدول البيانات الناتج الذي يحتوي على العلامة المائية باستخدام طريقة save ().

يطبق مقتطف كود Java التالي العلامة المائية النصية على الورقة المذكورة فقط من مصنف Excel.

/*
 * أضف العلامة المائية فقط إلى الورقة المذكورة من مصنف Excel باستخدام Java
 */
// قم بتحميل جدول البيانات
String filename = "path/spreadsheet.xlsx";
Watermarker watermarker = new Watermarker(filename, new SpreadsheetLoadOptions());

// تعيين نص العلامة المائية وفهرس ورقة العمل الخاصة به
TextWatermark watermark = new TextWatermark("DRAFT", new Font("Segoe UI", 19));
SpreadsheetWatermarkModernWordArtOptions options = new SpreadsheetWatermarkModernWordArtOptions();               
options.setWorksheetIndex(0);

// أضف علامة مائية واحفظ جدول البيانات بعلامة مائية
watermarker.add(watermark, options);
watermarker.save("path/watermark-single-sheet.xlsx");
watermarker.close();

علامة مائية على أوراق Excel كخلفية باستخدام Java

وبالمثل ، يمكننا أيضًا إضافة علامات مائية كخلفية لجدول البيانات. سيكون هناك بعض التعديل على النهج أعلاه لتطبيق العلامات المائية. فيما يلي الخطوات التي تقوم بإدراج علامة مائية نص الخلفية في جدول بيانات Excel في Java.

  • قم بتحميل جدول البيانات باستخدام Watermarker.
  • تحضير نص العلامة المائية ومظهرها باستخدام TextWatermark.
  • اضبط إعدادات العلامة المائية لجعلها خلفية باستخدام خيارات العلامة المائية عن طريق الحصول على المحتوى وتعيين الأبعاد.
  • أضف العلامة المائية إلى أوراق المصنف باستخدام add () mehtod.
  • أخيرًا ، احفظ جدول البيانات الذي يحمل علامة مائية باستخدام طريقة save ().

يمكن استخدام نموذج التعليمات البرمجية التالي لإضافة علامة مائية نصية في الخلفية إلى جدول بيانات Excel في Java.

/*
 * أضف علامة مائية كخلفية إلى Excel Workbook في Java
 */
// قم بتحميل جدول البيانات
String filename = "path/spreadsheet.xlsx";
Watermarker watermarker = new Watermarker(filename, new SpreadsheetLoadOptions());

// تعيين مظهر نص العلامة المائية
TextWatermark watermark = new TextWatermark("DRAFT", new Font("Segoe UI", 19));
watermark.setHorizontalAlignment(HorizontalAlignment.Center);
watermark.setVerticalAlignment(VerticalAlignment.Center);
watermark.setRotateAngle(-45);
watermark.setSizingType(SizingType.ScaleToParentDimensions);
watermark.setScaleFactor(0.5);
watermark.setOpacity(0.5);

// أضف علامة مائية إلى الخلفية
SpreadsheetContent content = watermarker.getContent(SpreadsheetContent.class);
SpreadsheetBackgroundWatermarkOptions options = new SpreadsheetBackgroundWatermarkOptions();
options.setBackgroundWidth(content.getWorksheets().get_Item(0).getContentAreaWidthPx()); /* set background width */
options.setBackgroundHeight(content.getWorksheets().get_Item(0).getContentAreaHeightPx()); /* set background height */

// احفظ جدول البيانات بعلامة مائية
watermarker.add(watermark, options);
watermarker.save("path/watermark-background-spreadsheet.xlsx");
watermarker.close();
أوراق إكسل المائية برمجيًا

احصل على ترخيص API مجاني

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

استنتاج

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

تعرف على المزيد حول API من الوثائق. للاستفسارات ، اتصل بنا عبر المنتدى.

أنظر أيضا