العمل مع خصائص المستند
تسمح خصائص المستند بتخزين بعض المعلومات المفيدة حول المستند. يمكن تقسيم هذه الخصائص إلى مجموعتين:
- نظام أو مدمج يحتوي على قيم مثل عنوان المستند واسم المؤلف وإحصائيات المستند وغيرها.
- المعرفة من قبل المستخدم أو العرف، كما قدمت أزواج اسم القيمة حيث يمكن للمستخدم تحديد كل من الاسم والقيمة.
من المفيد معرفة أن المعلومات حول API ورقم الإصدار مكتوبة مباشرة إلى مستندات الإخراج. على سبيل المثال، عند تحويل مستند إلى PDF، يملأ Aspose.Words حقل “التطبيق” بـ “Aspose.Words”، وحقل “PDF المنتج” بـ “Aspose.Words لـ Java YY.م. ن “، حيث YY.M.N هي نسخة Aspose.Words المستخدمة للتحويل. لمزيد من التفاصيل، انظر اسم المولد أو المنتج المضمن في مستندات الإخراج.
الوصول إلى خصائص المستند
للوصول إلى خصائص المستند في Aspose.Words استخدم:
-
BuiltInDocumentProperties للحصول على خصائص مدمجة.
-
CustomDocumentProperties للحصول على خصائص مخصصة.
BuiltInDocumentProperties
BuiltInDocumentProperties
تتيح لك فئة DocumentProperty الحصول على اسم وقيمة ونوع خاصية المستند. [القيمة]https://reference.aspose.com/words/java/com.aspose.words/documentproperty#Value) إرجاع كائن، ولكن هناك مجموعة من الأساليب التي تسمح لك للحصول على قيمة الخاصية تحويلها إلى نوع معين. بعد التعرف على نوع الخاصية، يمكنك استخدام إحدى طرق DocumentProperty.ToXXX، مثل DocumentProperty.ToString و DocumentProperty.ToInt، للحصول على قيمة النوع المناسب.
يوضح مثال التعليمات البرمجية التالية كيفية تعداد كافة الخصائص المضمنة والمخصصة في مستند:
في Microsoft Word، يمكنك الوصول إلى خصائص المستند باستخدام قائمة “ملف Properties خصائص”.
إضافة أو إزالة خصائص المستند
لا يمكنك إضافة أو إزالة خصائص المستند المضمنة باستخدام Aspose.Words. يمكنك فقط تغيير أو تحديث قيمها.
لإضافة خصائص وثيقة مخصصة مع Aspose.Words، استخدم طريقة Add، وتمرير اسم الخاصية الجديدة وقيمة النوع المناسب. تقوم الطريقة بإرجاع الكائن DocumentProperty الذي تم إنشاؤه حديثا.
لإزالة الخصائص المخصصة، استخدم طريقة Remove، مرورا باسم الخاصية المراد إزالتها، أو طريقة RemoveAt لإزالة الخاصية حسب الفهرس. يمكنك أيضا إزالة جميع الخصائص باستخدام طريقة Clear.
يتحقق مثال الكود التالي مما إذا كانت خاصية مخصصة باسم معين موجودة في مستند ويضيف بعض خصائص المستند المخصصة الأخرى:
يوضح مثال التعليمات البرمجية التالية كيفية إزالة خاصية مستند مخصص:
تحديث خصائص المستند المضمنة
لا يقوم Aspose.Words بتحديث خصائص المستند تلقائيا، كما يفعل Microsoft Word مع بعض الخصائص، ولكنه يوفر طريقة لتحديث بعض خصائص المستند المضمنة الإحصائية. استدعاء طريقة UpdateWordCount لإعادة حساب وتحديث الخصائص التالية:
إنشاء خاصية مخصصة جديدة مرتبطة بالمحتوى
Aspose.Words يوفر طريقة AddLinkToContent لإنشاء خاصية مستند مخصص جديدة مرتبطة بالمحتوى. تقوم هذه الخاصية بإرجاع كائن الخاصية الذي تم إنشاؤه حديثا أو لاغية إذا كان LinkSource غير صالح.
يوضح مثال التعليمات البرمجية التالية كيفية تكوين ارتباط إلى خاصية مخصصة:
احصل على متغيرات المستند
يمكنك الحصول على مجموعة من متغيرات المستند باستخدام خاصية Variables. أسماء المتغيرات والقيم هي سلاسل.
يوضح مثال الكود التالي كيفية تعداد متغيرات المستند:
إزالة المعلومات الشخصية من المستند
إذا كنت ترغب في مشاركة مستند ورد مع أشخاص آخرين، فقد ترغب في إزالة المعلومات الشخصية مثل اسم المؤلف والشركة. للقيام بذلك، استخدم خاصية RemovePersonalInformation لتعيين العلامة التي تشير إلى أن Microsoft Word ستزيل جميع معلومات المستخدم من التعليقات والمراجعات وخصائص المستند عند حفظ المستند.