العمل مع إعدادات المستند

العمل مع إعدادات المستند

العمل مع إعدادات المستند

ما وراء المحتوى، يحمل مستند Word إعدادات على مستوى التطبيق – مفاتيح توافق قديمة، تفضيلات التهجئة، تكوين دمج البريد المخزن، خيارات العرض، وحالة الحماية من الكتابة. Aspose.Words FOSS لـ .NET يكشف عن هذه عبر Aspose.Words.Settings المجال و مجموعة قليلة من الخصائص على Document. تغطي هذه الصفحة كل مجموعة إعدادات وما تتحكم فيه وما لا تتحكم فيه.


خيارات التوافق

Document.CompatibilityOptions هو مثال CompatibilityOptions يحتوي على عشرات مفاتيح منطقية تعيد إنتاج سلوكيات تخطيط وتباعد محددة لإصدارات Word القديمة – على سبيل المثال GrowAutofit, UseWord2010TableStyleRules, UseWord2002TableStyleRules, AdjustLineHeightInTable, AlignTablesRowByRow, NoExtraLineSpacing, SuppressSpacingAtTopOfPage, SpacingInWholePoints, UseFELayout, وBalanceSingleByteDoubleByteWidth. اضبط الخصائص التي تحتاجها مباشرةً لتطابق خصائص العرض الخاصة بإصدار Word معين في الأدوات اللاحقة التي تقرأ المستند.


تفضيلات التجزئة

Document.HyphenationOptions هو مثال HyphenationOptions (AutoHyphenation, ConsecutiveHyphenLimit, HyphenateCaps, HyphenationZone) الذي يخزن تفضيلات التجزئة في Word للمستند. هذه الخصائص تنقل الطلب ذهابًا وإيابًا؛ ولأن هذا الإصدار لا يتضمن محرك تخطيط الصفحات، فإن Aspose.Words FOSS لا يحسب فواصل التجزئة بنفسه – حيث يقوم Word بتطبيقها عند فتح الملف وتصفح الصفحات.


تكوين دمج البريد

Document.MailMergeSettings هو مثال MailMergeSettings يخزن تكوين الدمج البريدي المسجل في المستند: MainDocumentType, CheckErrors, Destination, DataSource, DataType, Query, ConnectString, MailSubject, MailAsAttachment, ActiveRecord, و ViewMergedData, بالإضافة إلى Clear() و Clone(). بالنسبة لمصادر البيانات الخارجية المتصلة عبر آلية كائن مصدر البيانات في Office لكلمة Word، يعرّف MailMergeSettings.Odso مثال Odso (DataSource, DataSourceType, TableName, ColumnDelimiter, FirstRowContainsColumnNames) الذي تصف FieldMapDatas (OdsoFieldMapDataCollection من OdsoFieldMapData: Name, MappedName, Column, Type) وRecipientDatas (OdsoRecipientDataCollection من OdsoRecipientData: Active, Column, Hash, UniqueTag) تخطيط الحقول وقائمة المستلمين.


إعدادات عرض المستند

Document.ViewOptions هو مثال ViewOptions يتحكم في كيفية عرض Word للملف عند فتحه: ViewType, ZoomType, ZoomPercent, DisplayBackgroundShape, DoNotDisplayPageBoundaries, و FormsDesign. هذه الخصائص تؤثر فقط على عرض Word الخاص بالمستند – ولا تؤثر على طريقة معالجة Aspose.Words FOSS له.


حماية الكتابة

Document.WriteProtection هو مثال WriteProtection (IsWriteProtected, ReadOnlyRecommended) يحتوي على SetPassword() لتحديد كلمة مرور الحماية وValidatePassword() للتحقق من كلمة مرور مرشحة مقابلها.


وحدات القياس

تحدد تعداد MeasurementUnits وحدة القياس التي يجب أن يستخدمها Word في واجهته للمستند.


نصائح وأفضل الممارسات

  • CompatibilityOptions.OptimizeFor(MsWordVersion) موجود في الفئة لكن تنفيذه غير مكتمل في هذا البناء – يؤدي إلى رمي NotImplementedException. عيّن خصائص CompatibilityOptions البوليانية الفردية التي تحتاجها مباشرةً بدلاً من الاعتماد على OptimizeFor لتطبيق ملف تعريف نسخة كامل مرة واحدة.
  • MailMergeSettings and Odso تخزين دمج البريد configuration التي تم تسجيلها في المستند – قراءة وكتابة هذا التكوين مدعومة، لكن تنفيذ دمج البريد (ملء الحقول من مصدر بيانات حي) غير متضمن في هذه النسخة مفتوحة المصدر.
  • HyphenationOptions وViewOptions كلاهما تفضيلات عرض/واجهة مستخدم يطبقها Word نفسه – لا تتوقع أن يؤدي استدعاء Document.Save() إلى تغيير طريقة لف النص أو ظهوره بناءً على هذه الإعدادات، لأن هذه النسخة لا تتضمن محرك تخطيط الصفحات.
  • استدعِ WriteProtection.SetPassword() قبل تمكين IsWriteProtected، واستخدم ValidatePassword() للتحقق من كلمة مرور مرشحة بدلاً من تخزين أو مقارنة السلسلة الخام بنفسك.
  • يمكن الوصول إلى CompatibilityOptions وHyphenationOptions وMailMergeSettings وViewOptions وWriteProtection جميعًا مباشرةً من Document – لا حاجة للبحث في شجرة العقد عنهم.

مشكلات شائعة

مشكلةالسببإصلاح
CompatibilityOptions.OptimizeFor() يرمي NotImplementedExceptionغير مُنفّذ في هذا الإصدارقم بتعيين خصائص CompatibilityOptions البوليانية الفردية بدلاً من ذلك
دمج البريد لا يملأ المستند بالبياناتMailMergeSettings يخزن فقط إعدادات الدمج؛ التنفيذ غير مشمول في هذه النسخةاقرأ تكوين مصدر البيانات المخزن وقم بتوجيه منطق تعبئة الحقول الخاص بك، أو استخدم النسخة التجارية Aspose.Words لـ .NET
تغيير ViewOptions.ZoomPercent ليس له أي تأثير مرئي عند معالجة المستندViewOptions يؤثر فقط على عرض Word، وليس على معالجة Aspose.Words الخاصة بـ FOSSالسلوك المتوقع – لا حاجة للإصلاح
WriteProtection.ValidatePassword() تُعيد false بشكل غير متوقعلم يتم استدعاء SetPassword() أولاً، أو تم تعيين كلمة مرور مختلفةاستدعِ SetPassword() لتحديد كلمة المرور المحمية قبل التحقق

FAQ

هل يمكنني استخدام Aspose.Words FOSS لتشغيل دمج بريد فعلي؟

لا. يتيح لك MailMergeSettings و Odso قراءة وكتابة تكوين الدمج المخزن في مستند، لكن تنفيذ دمج البريد — ملء الحقول من مصدر بيانات — غير متضمن في هذه النسخة المفتوحة المصدر.

هل يعمل CompatibilityOptions.OptimizeFor()؟

لا – يطلق NotImplementedException في هذا الإصدار. بدلاً من ذلك، عيّن خصائص CompatibilityOptions الفردية التي تحتاجها مباشرة.

كيف أحمي مستندًا بكلمة مرور ضد التعديلات؟

استدعِ WriteProtection.SetPassword() على Document.WriteProtection، ثم عيّن IsWriteProtected لتمكين الحماية.

هل HyphenationOptions و ViewOptions يغيّران طريقة تنسيق المستند؟

لا. كلاهما تفضيلات مخزنة يطبقها Microsoft Word عند فتحه وعرضه للملف. لا تتضمن هذه النسخة محرك تخطيط الصفحات، لذا تمر هذه الإعدادات دون أن يقوم Aspose.Words FOSS نفسه بحساب التخطيط بناءً عليها.


API Reference ملخص

فئة / تعدادوصف
CompatibilityOptionsمفاتيح تخطيط/تباعد نسخة Word القديمة، عبر Document.CompatibilityOptions
Compatibilityتعداد يحدد خيارات التوافق الفردية
MsWordVersionقيم إصدارات Word المستخدمة بواسطة CompatibilityOptions.OptimizeFor()
HyphenationOptionsتفضيلات التجزيء، عبر Document.HyphenationOptions
MailMergeSettingsإعداد دمج المراسلات المخزن، عبر Document.MailMergeSettings
Odsoإعدادات اتصال Office Data Source Object لدمج المراسلات
OdsoFieldMapData / OdsoFieldMapDataCollectionتعيين العمود إلى حقل الدمج لمصدر بيانات ODSO
OdsoRecipientData / OdsoRecipientDataCollectionحالة الإدراج/الإستبعاد لكل مستلم في دمج البريد
ViewOptionsتفضيلات عرض Word (التكبير، علامات التنسيق)، عبر Document.ViewOptions
WriteProtectionحالة حماية الكتابة للمستند، عبر Document.WriteProtection
MeasurementUnitsوحدة القياس التي يجب أن يستخدمها Word في واجهته

انظر أيضاً

 العربية