إدارة خصائص المستند
مقدمة
يوفر Microsoft Excel القدرة على إضافة خصائص إلى ملفات جداول البيانات. توفر هذه الخصائص المستندية معلومات مفيدة وتنقسم إلى فئتين كما هو موضح أدناه.
- الخصائص المعرفة مسبقًا (المدمجة): الخصائص المدمجة تحتوي على معلومات عامة حول المستند مثل عنوان المستند واسم المؤلف وإحصائيات المستند وما إلى ذلك.
- الخصائص المخصصة (المخصصة): الخصائص المخصصة المحددة من قبل المستخدم النهائي في شكل زوج اسم-قيمة.
إدارة خصائص المستند باستخدام Microsoft Excel
يتيح Microsoft Excel إدارة خصائص المستند في ملفات Excel بطريقة WYSIWYG. يرجى اتباع الخطوات التالية لفتح حوار Properties في Excel 2016.
- من القائمة ملف, حدد معلومات.
| اختيار قائمة المعلومات |
|---|
 |
- انقر على عنوان الخصائص وحدد “الخصائص المتقدمة”.
| النقر على اختيار الخصائص المتقدمة |
|---|
 |
- إدارة خصائص مستند الملف.
| مربع الحوار الخصائص |
|---|
 |
| في مربع حوار الخصائص، هناك علامات تبويب مختلفة، مثل العامة، والملخص، والإحصائيات، والمحتويات، والمخصصة. تساعد كل علامة تبويب في تكوين أنواع مختلفة من المعلومات ذات الصلة بالملف. تُستخدم علامة التبويب المخصصة لإدارة الخصائص المخصصة. |
العمل مع خصائص المستند باستخدام Aspose.Cells
يمكن للمطورين إدارة خصائص الوثيقة بشكل ديناميكي باستخدام واجهات برمجة التطبيقات Aspose.Cells. تساعد هذه الميزة المطورين في تخزين معلومات مفيدة إلى جانب الملف، مثل متى تم استلام الملف ومعالجته وتسجيل الوقت وما إلى ذلك.
يكتب Aspose.Cells for Java مباشرة المعلومات حول واجهة برمجة التطبيقات ورقم الإصدار في المستندات الناتجة. على سبيل المثال، عند تحويل المستند إلى ملف PDF، يملأ Aspose.Cells for Java حقل التطبيق بالقيمة ‘Aspose.Cells’ وحقل منتج PDF بالقيمة، على سبيل المثال ‘Aspose.Cells for Java v17.9’.
يرجى ملاحظة أنه لا يمكنك توجيه Aspose.Cells for Java لتغيير أو إزالة هذه المعلومات من المستندات الناتجة.
الوصول إلى خصائص المستند
تدعم واجهات برمجة التطبيقات Aspose.Cells كلا من أنواع خصائص المستند، المدمجة والمخصصة. يمثل Workbook لـ Aspose.Cells ملف Excel و، مثل ملف Excel، يمكن أن يحتوي Workbook الفصول المتعددة، يمثل كل منها بواسطة فئة Worksheet في حين أن مجموعة الفصول تمثل بواسطة فئة WorksheetCollection.
استخدم WorksheetCollection للوصول إلى خصائص المستند كما هو موضح أدناه.
- للوصول إلى خصائص المستند المدمجة، استخدم WorksheetCollection.BuiltInDocumentProperties.
- للوصول إلى خصائص المستند المخصصة، استخدم WorksheetCollection.CustomDocumentProperties.
كل من WorksheetCollection.BuiltInDocumentProperties وWorksheetCollection.CustomDocumentProperties تعيد نموذجًا من صنف DocumentPropertyCollection. تحتوي هذه المجموعة على DocumentProperty كائن، كل منها يُمثل خاصية مستند مدمجة أو مخصصة واحدة.
من متطلبات التطبيق كيفية الوصول إلى الخاصية ، أي؛ باستخدام فهرس أو اسم الخاصية من DocumentPropertyCollection كما هو موضح في المثال أدناه.
يتيح فئة DocumentProperty استرداد اسم وقيمة ونوع خاصية المستند:
- للحصول على اسم الخاصية ، استخدم DocumentProperty.Name.
- للحصول على قيمة الخاصية ، استخدم DocumentProperty.Value. DocumentProperty.Value يعيد القيمة ككائن.
- للحصول على نوع الخاصية، استخدم DocumentProperty.Type. يعيد هذا واحدة من قيم تعددات PropertyType.
إضافة أو إزالة الخصائص المخصصة للمستند
كما وصفنا في وقت سابق في بداية هذا الموضوع ، لا يمكن للمطورين إضافة أو إزالة الخصائص المدمجة لأن هذه الخصائص محددة من النظام ولكن من الممكن إضافة أو إزالة الخصائص المخصصة لأنها معرفة من قبل المستخدم.
إضافة الخصائص المخصصة
قدمت واجهات برمجة التطبيقات الخاصة بـ Aspose.Cells الطريقة add لفئة CustomDocumentPropertyCollection من أجل إضافة خصائص مخصصة إلى المجموعة. تقوم الطريقة add بإضافة الخاصية إلى ملف Excel وتُرجع مرجعًا لخاصية المستند الجديدة ككائن DocumentProperty.
تكوين خاصية مخصصة “ربط بالمحتوى”
لإنشاء خاصية مخصصة مرتبطة بمحتوى نطاق محدد ، اتصل بالطريقة CustomDocumentPropertyCollection.addLinkToContent وقم بتمرير اسم الخاصية والمصدر. يمكنك التحقق مما إذا كانت الخاصية مكونة كمرتبطة بالمحتوى باستخدام الخاصية DocumentProperty.isLinkedToContent. علاوة على ذلك ، من الممكن أيضًا الحصول على نطاق المصدر باستخدام الخاصية Source من فئة DocumentProperty.
نحن نستخدم ملف نموذجي بسيط لبرنامج Microsoft Excel في المثال. يحتوي دفتر العمل على نطاق مسمى محدد يحمل التسمية MyRange والذي يشير إلى قيمة الخلية.
إزالة الخصائص المخصصة
لإزالة الخصائص المخصصة باستخدام Aspose.Cells، قم بالاتصال بالطريقة DocumentPropertyCollection.remove وقم بتمرير اسم خاصية المستند التي تريد إزالتها.