في الماضي القريب، قمنا بنشر منشورات مدونة حول كيفية إضافة العلامة المائية إلى PNG و Excel برمجيًا. تشرح هذه المقالة عملية إضافة علامة مائية في مستندات Word باستخدام GroupDocs.Watermark Cloud SDKs for Java. هناك مجموعة واسعة من الميزات التي يعرضها GroupDocs.Watermark بما في ذلك Cloud SDKs وREST APIs. لذلك، سوف نقوم بإجراءات التثبيت وكذلك التنفيذ. لذلك، يرجى الاطلاع على منشور المدونة هذا بدقة لمعرفة كيفية إضافة علامة مائية إلى Word في Java برمجيًا. بحلول نهاية هذا الدليل، ستتمكن من إنشاء أداة إنشاء علامة مائية لبرنامج عملك.
سيتم تغطية النقاط التالية في منشور المدونة هذا:
تثبيت API للعلامة المائية
عملية تثبيت مكتبة Java هذه بسيطة للغاية. ومع ذلك، يمكنك إضافة علامة مائية في مستندات Word دون الاعتماد على أي تبعية لجهة خارجية. لذلك، يمكنك تثبيته عن طريق تنزيل ملف JAR هذا أو يمكنك استخدام تكوينات Maven التالية:
<repository>
<id>groupdocs-artifact-repository</id>
<name>GroupDocs Artifact Repository</name>
<url>https://repository.groupdocs.cloud/repo</url>
</repository>
<dependency>
<groupId>com.groupdocs</groupId
<artifactId>groupdocs-watermark-cloud</artifactId>
<version>22.3</version>
<scope>compile</scope>
</dependency>
بمجرد التثبيت، فإن الخطوة التالية هي الحصول على بيانات اعتماد API من API Cloud لوحة المعلومات. ولهذا الغرض، يرجى زيارة هذا الدليل في حالة مواجهة أي صعوبة.
إضافة علامة مائية إلى Word في Java
لقد قمنا الآن بتحميل ملف MS Word المصدر إلى لوحة معلومات API Cloud والذي يمكنك تحميله يدويًا أو برمجيًا عن طريق استدعاء طريقة UploadFile هذه.
توضح الخطوات التالية كيفية إدراج علامة مائية في مستند Word برمجياً:
- قم بإنشاء مثيل لفئة التكوين وقم بتهيئته باستخدام معرف العميل وسر العميل.
- قم بتهيئة كائن من فئة WatermarkApi بمثيل التكوين.
- قم بإنشاء كائن من فئة FileInfo.
- قم بتعيين مسار ملف Word عن طريق استدعاء الأسلوب setFilePath.
- قم بتعيين خيارات العلامة المائية عن طريق إنشاء مثيل لفئة WatermarkOptions.
- قم باستدعاء الأسلوب setFileInfo لتحديد الملف المصدر.
- حدد خيارات العلامة المائية النصية مثل عائلة الخطوط ونص العلامة المائية وحجم الخط وما إلى ذلك.
- قم بإنشاء كائن من فئة اللون وقم بتعيين لون نص العلامة المائية عن طريق استدعاء طريقة setForegroundColor.
- حدد تفاصيل العلامة المائية عن طريق استدعاء طريقة setTextWatermarkOptions لفئة WatermarkDetails.
- قم بإنشاء مثيل لفئة الموضع وقم بتعيين موضع العلامة المائية.
- قم بإنشاء طلب لإضافة علامة مائية عن طريق إنشاء مثيل لفئة AddRequest.
- اتصل بالطريقة add الخاصة بفئة WatermarkApi لإضافة علامة مائية إلى Word.
انسخ والصق الكود التالي في ملفك الرئيسي:
package com.example;
import com.groupdocs.cloud.watermark.client.*;
import com.groupdocs.cloud.watermark.model.*;
import com.groupdocs.cloud.watermark.model.requests.AddRequest;
import com.groupdocs.cloud.watermark.api.WatermarkApi;
import java.util.*;
public class Main {
public static void main(String[] args) {
String ClientId = "xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx";
String ClientSecret = "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx";
String myStorage = "test";
// قم بإنشاء مثيل لفئة التكوين وقم بتهيئته باستخدام معرف العميل وسر العميل.
Configuration configuration = new Configuration(ClientId, ClientSecret);
// قم بتهيئة كائن من فئة WatermarkApi بمثيل التكوين.
WatermarkApi apiInstance = new WatermarkApi(configuration);
// قم بإنشاء كائن من فئة FileInfo.
FileInfo fileInfo = new FileInfo();
// قم بتعيين مسار ملف Word عن طريق استدعاء الأسلوب setFilePath.
fileInfo.setFilePath("sample.docx");
fileInfo.setStorageName(myStorage);
// قم بتعيين خيارات العلامة المائية عن طريق إنشاء مثيل لفئة WatermarkOptions.
WatermarkOptions options = new WatermarkOptions();
// قم باستدعاء الأسلوب setFileInfo لتحديد الملف المصدر.
options.setFileInfo(fileInfo);
// حدد خيارات العلامة المائية النصية مثل عائلة الخطوط ونص العلامة المائية وحجم الخط وما إلى ذلك.
TextWatermarkOptions textWatermarkOptions = new TextWatermarkOptions();
textWatermarkOptions.setText("GroupDocs watermark");
textWatermarkOptions.setFontFamilyName("Arial");
textWatermarkOptions.setFontSize(12d);
textWatermarkOptions.setTextAlignment("Center");
// إنشاء كائن من فئة اللون وتعيين لون نص العلامة المائية عن طريق استدعاء طريقة setForegroundColor.
Color color = new Color();
color.setName("White");
textWatermarkOptions.setForegroundColor(color);
// حدد تفاصيل العلامة المائية عن طريق استدعاء طريقة setTextWatermarkOptions لفئة WatermarkDetails.
WatermarkDetails watermarkDetails = new WatermarkDetails();
watermarkDetails.setTextWatermarkOptions(textWatermarkOptions);
// قم بإنشاء مثيل لفئة الموضع وقم بتعيين موضع العلامة المائية.
Position position = new Position();
position.setX(180.0);
position.setY(450.0);
watermarkDetails.setPosition(position);
// ضبط تفاصيل العلامة المائية
List<WatermarkDetails> watermarkDetailsList = new ArrayList<WatermarkDetails>();
watermarkDetailsList.add(watermarkDetails);
options.setWatermarkDetails(watermarkDetailsList);
// قم بإنشاء طلب لإضافة علامة مائية عن طريق إنشاء مثيل لفئة AddRequest.
AddRequest request = new AddRequest(options);
WatermarkResult response;
try {
// اتصل بأسلوب الإضافة الخاص بفئة WatermarkApi لإضافة علامة مائية إلى Word.
response = apiInstance.add(request);
System.out.println("Resultant file path: " + response.getPath());
} catch (ApiException e) {
// TODO كتلة الالتقاط التي تم إنشاؤها تلقائيًا
e.printStackTrace();
}
}
}
بمجرد تشغيل ملف الخادم، سيظهر لك الملف الذي تم إنشاؤه في لوحة معلومات API Cloud كما هو موضح في الصورة أدناه:
مولد العلامة المائية على الإنترنت
علاوة على ذلك، يمكنك الاستفادة من أداة عبر الإنترنت لإنشاء علامة مائية عبر الإنترنت وهي مدعومة GroupDocs.Watermark. يتميز منشئ العلامات المائية عبر الإنترنت بكفاءة عالية ويوفر واجهة سهلة الاستخدام حيث يمكن للمستخدمين سحب الملفات وإفلاتها بسهولة. قبل كل شيء، فهو مجاني ويمكنك استخدام هذه الأداة عبر الإنترنت لإضافة علامة مائية إلى مستندات Word.
خاتمة
هذه هي نهاية مشاركة المدونة هذه. لقد مررنا بـ GroupDocs.Watermark Cloud SDKs for Java وأيضًا عملية التنفيذ. بالإضافة إلى ذلك، تعلمنا كيفية إضافة علامة مائية إلى Word في Java برمجياً. علاوة على ذلك، يمكنك زيارة الوثائق ودليل البدء في حالة رغبتك في بدء التطوير. في النهاية، لا تنس التفاعل مع واجهات برمجة التطبيقات المباشرة الخاصة بنا هنا.
أخيرًا، يقوم groupdocs.cloud بكتابة مقالات جديدة. لذا، يرجى البقاء على اتصال للحصول على التحديثات المنتظمة.
المساعدة متاحة
يمكنك إخبارنا بأسئلتك أو استفساراتك على المنتدى.
الأسئلة المتداولة – الأسئلة الشائعة
كيف أقوم بإدراج علامة مائية في مستند Word؟
يمكنك إدراج علامة مائية في مستندات Word باستخدام GroupDocs.Watermark Cloud SDKs for Java. يرجى زيارة هذا الرابط لمعرفة المزيد.
كيف يمكنني الحصول على علامة مائية مجانية عبر الإنترنت؟
هذا عبر الإنترنت منشئ العلامات المائية يعتمد على الويب وهو مجاني للاستخدام.