استخدام خيارات التحميل في Aspose.Words للغة Java

مقدمة حول العمل مع خيارات التحميل في Aspose.Words للغة Java

في هذا البرنامج التعليمي، سنستكشف كيفية العمل مع خيارات التحميل في Aspose.Words for Java. تتيح لك خيارات التحميل تخصيص كيفية تحميل المستندات ومعالجتها. سنغطي سيناريوهات مختلفة، بما في ذلك تحديث الحقول المتسخة، وتحميل المستندات المشفرة، وتحويل الأشكال إلى Office Math، وتعيين إصدار MS Word، وتحديد مجلد مؤقت، ومعالجة التحذيرات، وتحويل الملفات التعريفية إلى PNG. دعنا نتعمق خطوة بخطوة.

تحديث الحقول المتسخة

LoadOptions loadOptions = new LoadOptions();
loadOptions.setUpdateDirtyFields(true);

Document doc = new Document("Your Directory Path" + "Dirty field.docx", loadOptions);
doc.save("Your Directory Path" + "WorkingWithLoadOptions.UpdateDirtyFields.docx");

يوضح مقتطف التعليمات البرمجية هذا كيفية تحديث الحقول المتسخة في مستند.setUpdateDirtyFields(true) يتم استخدام الطريقة للتأكد من تحديث الحقول المتسخة أثناء تحميل المستند.

تحميل المستند المشفر

@Test
public void loadEncryptedDocument() throws Exception {
    Document doc = new Document("Your Directory Path" + "Encrypted.docx", new LoadOptions("docPassword"));
    doc.save("Your Directory Path" + "WorkingWithLoadOptions.LoadAndSaveEncryptedOdt.odt", new OdtSaveOptions("newPassword"));
}

هنا، نقوم بتحميل مستند مشفر باستخدام كلمة مرور.LoadOptions يقبل المنشئ كلمة مرور المستند، ويمكنك أيضًا تحديد كلمة مرور جديدة عند حفظ المستند باستخدامOdtSaveOptions.

تحويل الشكل إلى رياضيات مكتبية

LoadOptions loadOptions = new LoadOptions();
loadOptions.setConvertShapeToOfficeMath(true);

Document doc = new Document("Your Directory Path" + "Office math.docx", loadOptions);
doc.save("Your Directory Path" + "WorkingWithLoadOptions.ConvertShapeToOfficeMath.docx", SaveFormat.DOCX);

يوضح هذا الكود كيفية تحويل الأشكال إلى كائنات Office Math أثناء تحميل المستند.setConvertShapeToOfficeMath(true)تمكن هذه الطريقة من التحويل.

تعيين إصدار MS Word

@Test
public void setMsWordVersion() throws Exception {
    LoadOptions loadOptions = new LoadOptions();
    loadOptions.setMswVersion(MsWordVersion.WORD_2010);

    Document doc = new Document("Your Directory Path" + "Document.docx", loadOptions);
    doc.save("Your Directory Path" + "WorkingWithLoadOptions.SetMsWordVersion.docx");
}

يمكنك تحديد إصدار MS Word لتحميل المستند. في هذا المثال، قمنا بتعيين الإصدار إلى Microsoft Word 2010 باستخدامsetMswVersion.

استخدم المجلد المؤقت

@Test
public void useTempFolder() throws Exception {
    LoadOptions loadOptions = new LoadOptions();
    loadOptions.setTempFolder("Your Directory Path");

    Document doc = new Document("Your Directory Path" + "Document.docx", loadOptions);
}

عن طريق تعيين المجلد المؤقت باستخدامsetTempFolderيمكنك التحكم في مكان تخزين الملفات المؤقتة أثناء معالجة المستندات.

استدعاء تحذيري

@Test
public void warningCallback() throws Exception {
    LoadOptions loadOptions = new LoadOptions();
    loadOptions.setWarningCallback(new DocumentLoadingWarningCallback());

    Document doc = new Document("Your Directory Path" + "Document.docx", loadOptions);
}

public static class DocumentLoadingWarningCallback implements IWarningCallback {
    public void warning(WarningInfo info) {
        // تعامل مع التحذيرات فور ظهورها أثناء تحميل المستندات.
        System.out.println(MessageFormat.format("WARNING: {0}, source: {1}", info.getWarningType(), info.getSource()));
        System.out.println(MessageFormat.format("\tDescription: {0}", info.getDescription()));
    }
}

يوضح هذا الكود كيفية إعداد معاودة اتصال تحذيرية للتعامل مع التحذيرات أثناء تحميل المستندات. يمكنك تخصيص سلوك التطبيق الخاص بك عند ظهور التحذيرات.

تحويل ملفات التعريف إلى PNG

@Test
public void convertMetafilesToPng() throws Exception {
    LoadOptions loadOptions = new LoadOptions();
    loadOptions.setConvertMetafilesToPng(true);

    Document doc = new Document("Your Directory Path" + "WMF with image.docx", loadOptions);
}

لتحويل ملفات التعريف (على سبيل المثال، WMF) إلى صور PNG أثناء تحميل المستند، يمكنك استخدامsetConvertMetafilesToPng(true) طريقة.

كود المصدر الكامل للعمل مع خيارات التحميل في Aspose.Words لـ Java

public void updateDirtyFields() throws Exception {
	LoadOptions loadOptions = new LoadOptions();
	{
		loadOptions.setUpdateDirtyFields(true);
	}
	Document doc = new Document("Your Directory Path" + "Dirty field.docx", loadOptions);
	doc.save("Your Directory Path" + "WorkingWithLoadOptions.UpdateDirtyFields.docx");
}
@Test
public void loadEncryptedDocument() throws Exception {
	Document doc = new Document("Your Directory Path" + "Encrypted.docx", new LoadOptions("docPassword"));
	doc.save("Your Directory Path" + "WorkingWithLoadOptions.LoadAndSaveEncryptedOdt.odt", new OdtSaveOptions("newPassword"));
}
@Test
public void convertShapeToOfficeMath() throws Exception {
	LoadOptions loadOptions = new LoadOptions();
	{
		loadOptions.setConvertShapeToOfficeMath(true);
	}
	Document doc = new Document("Your Directory Path" + "Office math.docx", loadOptions);
	doc.save("Your Directory Path" + "WorkingWithLoadOptions.ConvertShapeToOfficeMath.docx", SaveFormat.DOCX);
}
@Test
public void setMsWordVersion() throws Exception {
	// إنشاء كائن LoadOptions جديد، والذي سيقوم بتحميل المستندات وفقًا لمواصفات MS Word 2019 افتراضيًا
	// وتغيير إصدار التحميل إلى Microsoft Word 2010.
	LoadOptions loadOptions = new LoadOptions();
	{
		loadOptions.setMswVersion(MsWordVersion.WORD_2010);
	}
	Document doc = new Document("Your Directory Path" + "Document.docx", loadOptions);
	doc.save("Your Directory Path" + "WorkingWithLoadOptions.SetMsWordVersion.docx");
}
@Test
public void useTempFolder() throws Exception {
	LoadOptions loadOptions = new LoadOptions();
	{
		loadOptions.setTempFolder("Your Directory Path");
	}
	Document doc = new Document("Your Directory Path" + "Document.docx", loadOptions);
}
@Test
public void warningCallback() throws Exception {
	LoadOptions loadOptions = new LoadOptions();
	{
		loadOptions.setWarningCallback(new DocumentLoadingWarningCallback());
	}
	Document doc = new Document("Your Directory Path" + "Document.docx", loadOptions);
}
public static class DocumentLoadingWarningCallback implements IWarningCallback {
	public void warning(WarningInfo info) {
		//يطبع التحذيرات وتفاصيلها فور ظهورها أثناء تحميل المستندات.
		System.out.println(MessageFormat.format("WARNING: {0}, source: {1}", info.getWarningType(), info.getSource()));
		System.out.println(MessageFormat.format("\tDescription: {0}", info.getDescription()));
	}
}
@Test
public void convertMetafilesToPng() throws Exception {
	LoadOptions loadOptions = new LoadOptions();
	{
		loadOptions.setConvertMetafilesToPng(true);
	}
	Document doc = new Document("Your Directory Path" + "WMF with image.docx", loadOptions);
}
@Test
public void loadChm() throws Exception {
	LoadOptions loadOptions = new LoadOptions();
	{
		loadOptions.setEncoding(Charset.forName("windows-1251"));
	}
	Document doc = new Document("Your Directory Path" + "HTML help.chm", loadOptions);
}

خاتمة

في هذا البرنامج التعليمي، تعمقنا في جوانب مختلفة من العمل باستخدام خيارات التحميل في Aspose.Words for Java. تلعب خيارات التحميل دورًا حاسمًا في تخصيص كيفية تحميل المستندات ومعالجتها، مما يسمح لك بتخصيص معالجة المستندات وفقًا لاحتياجاتك المحددة. دعنا نلخص النقاط الرئيسية التي يغطيها هذا الدليل:

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

كيف يمكنني التعامل مع التحذيرات أثناء تحميل المستند؟

يمكنك إعداد مكالمة تحذيرية كما هو موضح فيwarningCallback() الطريقة المذكورة أعلاه. قم بتخصيصDocumentLoadingWarningCallback فئة للتعامل مع التحذيرات وفقًا لمتطلبات تطبيقك.

هل يمكنني تحويل الأشكال إلى كائنات Office Math عند تحميل مستند؟

نعم، يمكنك تحويل الأشكال إلى كائنات Office Math باستخدامloadOptions.setConvertShapeToOfficeMath(true).

كيف أحدد إصدار MS Word لتحميل المستند؟

يستخدمloadOptions.setMswVersion(MsWordVersion.WORD_2010) لتحديد إصدار MS Word لتحميل المستند.

ما هو الغرض من ذلك؟setTempFolder method in Load Options?

الsetTempFolderتسمح لك الطريقة بتحديد المجلد الذي سيتم تخزين الملفات المؤقتة فيه أثناء معالجة المستندات.