العمل مع الإشارات المرجعية
تحدد الإشارات المرجعية في مستند Microsoft Word المواقع أو الأجزاء التي تقوم بتسميتها وتحديدها للرجوع إليها مستقبلاً. على سبيل المثال، يمكنك استخدام إشارة مرجعية لتحديد النص الذي تريد مراجعته لاحقًا. بدلاً من التمرير عبر المستند لتحديد موقع النص، يمكنك الانتقال إليه باستخدام مربع الحوار “إشارة مرجعية”.
الإجراءات التي يمكن تنفيذها باستخدام الإشارات المرجعية باستخدام Aspose.Words هي نفس الإجراءات التي يمكنك تنفيذها باستخدام Microsoft Word. يمكنك إدراج إشارة مرجعية جديدة، أو حذفها، أو الانتقال إليها، أو الحصول على اسم إشارة مرجعية أو تعيينه، أو الحصول على نص محاط بها أو تعيينه.
أدخل إشارة مرجعية
استخدم StartBookmark وEndBookmark لإنشاء إشارة مرجعية عن طريق تحديد بدايتها ونهايتها، على التوالي. لا تنس تمرير نفس اسم الإشارة المرجعية إلى كلا الطريقتين. يمكن أن تتداخل الإشارات المرجعية الموجودة في المستند وتمتد إلى أي نطاق. سيتم تجاهل الإشارات المرجعية التي تم تكوينها بشكل سيئ أو الإشارات المرجعية ذات الأسماء المكررة عند حفظ المستند.
يوضح مثال التعليمات البرمجية التالي كيفية إنشاء إشارة مرجعية جديدة:
الحصول على الإشارات المرجعية
في بعض الأحيان يكون من الضروري الحصول على مجموعة إشارات مرجعية للتكرار من خلال الإشارات المرجعية أو لأغراض أخرى. استخدم خاصية Node.Range التي تم الكشف عنها بواسطة أي عقدة مستند تقوم بإرجاع كائن Range يمثل جزء المستند الموجود في هذه العقدة. استخدم هذا الكائن لاسترداد BookmarkCollection ثم استخدم مفهرس المجموعة للحصول على إشارة مرجعية محددة.
يوضح مثال التعليمات البرمجية التالي كيفية الحصول على الإشارات المرجعية من مجموعة الإشارات المرجعية:
يوضح مثال التعليمات البرمجية التالي كيفية الحصول على اسم ونص الإشارة المرجعية أو تعيينهما:
يوضح مثال التعليمات البرمجية التالي كيفية وضع إشارة مرجعية على جدول:
إذا قمت بتغيير اسم الإشارة المرجعية إلى اسم موجود بالفعل في المستند، فلن يتم إنشاء أي خطأ وسيتم تخزين الإشارة المرجعية الأولى فقط عند حفظ المستند.
لاحظ أنه تم تعيين بعض الإشارات المرجعية في المستند لحقول النموذج. يؤدي الانتقال إلى هذه الإشارة المرجعية وإدراج النص هناك إلى إدراج النص في رمز حقل النموذج. على الرغم من أن هذا لن يؤدي إلى إبطال حقل النموذج، إلا أن النص المدرج لن يكون مرئيًا لأنه يصبح جزءًا من رمز الحقل.
يوضح مثال التعليمات البرمجية التالي كيفية الوصول إلى أعمدة الجدول الذي تم وضع إشارة مرجعية عليه:
الانتقال إلى إشارة مرجعية
إذا كنت بحاجة إلى إدراج محتوى منسق (وليس مجرد نص عادي) في إشارة مرجعية، فيجب عليك استخدام MoveToBookmark لتحريك المؤشر إلى الإشارة المرجعية ثم استخدام أساليب وخصائص DocumentBuilder’s لإدراج المحتوى.
إظهار إخفاء محتوى الإشارة المرجعية
يمكن تغليف الإشارة المرجعية بأكملها (بما في ذلك المحتوى الذي تم وضع إشارة مرجعية) داخل الجزء الحقيقي من حقل IF باستخدام Aspose.Words. يمكن أن يحتوي حقل IF على حقل دمج متداخل في التعبير (يسار المشغل) واعتمادًا على قيمة حقل الدمج، يعرض حقل IF محتوى الإشارة المرجعية في مستند Word أو يخفيها.
يوضح مثال الكود التالي كيفية إظهار/إخفاء الإشارات المرجعية: