العمل مع الإشارات المرجعية
تحدد الإشارات المرجعية في مستند Microsoft Word المواقع أو الأجزاء التي تسميها وتحديدها للرجوع إليها في المستقبل. على سبيل المثال، يمكنك استخدام إشارة مرجعية لتحديد النص الذي تريد مراجعته لاحقا. بدلا من التمرير عبر المستند لتحديد موقع النص، يمكنك الانتقال إليه باستخدام مربع حوار الإشارة المرجعية.
باستخدام Aspose.Words، يمكنك استخدام الإشارات المرجعية في التقارير أو المستندات لإدراج بعض البيانات في الإشارة المرجعية أو تطبيق تنسيق خاص على محتواها. يمكنك أيضا استخدام الإشارات المرجعية لاسترداد النص من موقع معين في المستند.
الإجراءات التي يمكن تنفيذها باستخدام الإشارات المرجعية باستخدام Aspose.Words هي نفس الإجراءات التي يمكنك تنفيذها باستخدام Microsoft Word. يمكنك إدراج إشارة مرجعية جديدة أو حذفها أو الانتقال إلى إشارة مرجعية أو الحصول على اسم إشارة مرجعية أو تعيينه أو الحصول على نص مرفق به أو تعيينه.
أدخل إشارة مرجعية
استخدم startBookmark و endBookmark لإنشاء إشارة مرجعية عن طريق تحديد بدايتها ونهايتها، على التوالي. لا تنس تمرير نفس اسم الإشارة المرجعية إلى كلتا الطريقتين. يمكن أن تتداخل الإشارات المرجعية في المستند وتمتد إلى أي نطاق. سيتم تجاهل الإشارات المرجعية أو الإشارات المرجعية ذات الأسماء المكررة عند حفظ المستند.
يوضح مثال الكود التالي كيفية إنشاء إشارة مرجعية جديدة:
الحصول على الإشارات المرجعية
في بعض الأحيان يكون من الضروري الحصول على مجموعة إشارات مرجعية للتكرار من خلال الإشارات المرجعية أو لأغراض أخرى. استخدم الخاصية Node.getRange المكشوفة بواسطة أي عقدة مستند تقوم بإرجاع كائن Range يمثل جزء المستند الموجود في هذه العقدة. استخدم هذا الكائن لاسترداد BookmarkCollection ثم استخدم مفهرس المجموعة للحصول على إشارة مرجعية محددة.
يوضح مثال الكود التالي كيفية الحصول على إشارات مرجعية من مجموعة إشارات مرجعية:
يوضح مثال الكود التالي كيفية الحصول على اسم إشارة مرجعية ونص أو تعيينهما:
يوضح مثال الكود التالي كيفية وضع إشارة مرجعية على جدول:
إذا قمت بتغيير اسم إشارة مرجعية إلى اسم موجود بالفعل في المستند، فلن يتم إنشاء أي خطأ وسيتم تخزين الإشارة المرجعية الأولى فقط عند حفظ المستند.
لاحظ أنه يتم تعيين بعض الإشارات المرجعية في المستند إلى حقول النموذج. الانتقال إلى مثل هذه الإشارة المرجعية وإدراج النص هناك إدراج النص في رمز حقل النموذج. على الرغم من أن هذا لن يبطل حقل النموذج، إلا أن النص المدرج لن يكون مرئيا لأنه يصبح جزءا من رمز الحقل.
يوضح مثال الكود التالي كيفية الوصول إلى أعمدة الجدول الذي تم وضع إشارة مرجعية عليه:
الانتقال إلى إشارة مرجعية
إذا كنت بحاجة إلى إدراج محتوى غني (وليس مجرد نص عادي) في إشارة مرجعية، فيجب عليك استخدام moveToBookmark لتحريك المؤشر إلى الإشارة المرجعية ثم استخدام DocumentBuilder الأساليب والخصائص لإدراج المحتوى.
إظهار إخفاء محتوى الإشارة المرجعية
يمكن تغليف الإشارة المرجعية بأكملها (including the bookmarked content) داخل الجزء الحقيقي من حقل IF باستخدام Aspose.Words. يمكن أن يكون بطريقة تحتوي على حقل IF حقل دمج متداخل في التعبير (Left of Operator) واعتمادا على قيمة حقل الدمج، يعرض حقل IF أو يخفي محتوى الإشارة المرجعية في مستند ورد.
يوضح مثال الكود التالي كيفية إظهار / إخفاء الإشارات المرجعية.