العمل مع الروابط والمراجع
نظرة عامة
أكواد حقول الروابط والإشارات المتقاطعة في Word – HYPERLINK, REF, PAGEREF, NOTEREF, STYLEREF, SET, ASK, FILLIN, CITATION, BIBLIOGRAPHY, وأكثر – يتم تنفيذ كل منها كفئة مخصصة Field فئة فرعية في Aspose.Words FOSS for .NET. جميع هذه الفئات موجودة في Aspose.Words.Fields namespace إلى جانب كل نوع حقل آخر؛ تُجمع هذه الصفحة الفئات التي تهتم تحديدًا بالروابط، والإشارات المتقاطعة، والقيم المستدعاة، والاستشهادات، وتغطي ما تُكشفه كل منها.
Hyperlinks
FieldHyperlink يمثل حقل HYPERLINK: Address وSubAddress يحتفظان بعنوان URL الهدف أو موقع داخل المستند، ScreenTip يحدد تلميح التمرير، OpenInNewWindow وIsImageMap هما أعلام العرض، وTarget يحدد إطار المتصفح. في الحالات البسيطة، DocumentBuilder.InsertHyperlink() يُدرج حقل رابط تشعبي مباشرةً دون إنشاء كائن Field يدوياً.
الإحالات المتقاطعة إلى العلامات المرجعية
FieldRef (حقل REF)، FieldPageRef (PAGEREF)، وFieldNoteRef (NOTEREF) كلٌ منها يُحل إلى المحتوى عند علامة مرجعية مسماة عبر خاصية BookmarkName، مع InsertHyperlink وInsertRelativePosition يتحكمان في ما إذا كان الإشارة قابلة للنقر وما إذا كانت تُظهر موقعًا نسبيًا (“أعلى” / “أسفل”). FieldRef يضيف خيارات ترقيم الفقرات (InsertParagraphNumber, InsertParagraphNumberInFullContext, InsertParagraphNumberInRelativeContext, NumberSeparator) وIncludeNoteOrComment. FieldStyleRef (STYLEREF) بدلاً من ذلك يُحل إلى أقرب فقرة مُنسقة باستخدام StyleName معين، مع SearchFromBottom للبحث إلى الوراء من موضع الحقل. العلامات المرجعية التي تستهدفها هذه الحقول تُنشأ باستخدام DocumentBuilder.StartBookmark() وEndBookmark()، ويمكن الانتقال إليها باستخدام MoveToBookmark(). FieldSet (SET) يعرّف قيمة نصية مُعلّمة – BookmarkName وBookmarkText – يمكن لحقل REF في مكان آخر أن يحلها.
حقول القيم المُطالبة
FieldAsk (ASK) و FieldFillIn (FILLIN) يطلب قيمة من أي شخص يحدّث الحقل: PromptText يُعرض على المستخدم، DefaultResponse يُوفر احتياطيًا، و PromptOnceOnMailMerge يحدّ من تكرار الطلبات أثناء دمج البريد. FieldAsk يخزن إجابته أيضًا في BookmarkName ليتم الإشارة إليه من قبل الحقول الأخرى. انظر دليل الحقول for IFieldUserPromptRespondent, رد الاتصال الذي يزوّد إجابات لهذه الحقول برمجيًا بدلاً من طلبها بشكل تفاعلي.
المحتوى الخارجي والمرتبط
FieldDde (DDE) و FieldDdeAuto (DDEAUTO) يربطان المحتوى في تطبيق آخر عبر ProgId، SourceFullName، و SourceItem، مع InsertAsText، InsertAsHtml، InsertAsPicture، InsertAsRtf، InsertAsUnicode، و InsertAsBitmap لاختيار التمثيل المُدرج، و AutoUpdate / IsLinked للتحكم في سلوك التحديث. FieldLink (LINK) هو المكافئ لرابط OLE، مع إضافة FormatUpdateType. FieldImport (IMPORT) و FieldIncludePicture (INCLUDEPICTURE) يجلبان رسماً بيانياً خارجيًا عبر SourceFullName و GraphicFilter. FieldInclude (INCLUDE) و FieldIncludeText (INCLUDETEXT) يجلبان محتوى مستند خارجي، مع BookmarkName لتحديد نطاق الإدراج و LockFields لمنع تحديثه؛ كما يدعم FieldIncludeText مصادر XML عبر Encoding، MimeType، NamespaceMappings، XPath، و XslTransformation.
AutoText ومراجع القاموس
FieldAutoText (AUTOTEXT)، و FieldAutoTextList (AUTOTEXTLIST)، و FieldGlossary (GLOSSARY) جميعها تشير إلى إدخال كتلة بناء مسماة عبر EntryName؛ يضيف FieldAutoTextList ListStyle و ScreenTip لتقديمها بنمط القائمة.
حقول الاقتباس وقائمة المراجع
FieldCitation (CITATION) و FieldBibliography (BIBLIOGRAPHY) عرض المحتوى المستمد من بيانات bibliography الخاص بالمستند. FieldCitation.SourceTag (والبديل AnotherSourceTag) يحدد أي مصدر يتم الاستشهاد به، مع Prefix, Suffix, PageNumber, VolumeNumber، وال Suppress* العلامات (SuppressAuthor, SuppressTitle, SuppressYear) التي تتحكم في طريقة تنسيق الاقتباس. FieldBibliography.SourceTag, FilterLanguageId، و FormatLanguageId تتحكم في المصادر التي تظهر في قائمة المراجع المصدرة وبأي لغة. سجلات المصدر الأساسية لهذه الحقول تُظهر – Source, Contributor, Person – مغطاة في الـ دليل المراجع.
حقول اقتباس وتشكيل النص
FieldQuote (QUOTE) وFieldShape (SHAPE) كلاهما يُظهر خاصية Text التي تحتفظ بنص الحقل الحرفي – FieldQuote يدرجه مباشرةً في موضع الحقل، بينما FieldShape يربطه برمز الحقل النصي داخل شكل رسومي.
نصائح وأفضل الممارسات
- يفضَّل استخدام
DocumentBuilder.InsertHyperlink()لإدراج الروابط التشعبية بطريقة مباشرة؛ انتقل إلى بناءFieldHyperlinkمباشرةً فقط عندما تحتاج إلى خصائص مثلScreenTipأوIsImageMapالتي لا يتيحها اختصار المُنشئ. - يتنسيق كل من
FieldRefوFieldPageRefوFieldNoteRefوFieldSetعبرBookmarkName– تأكد من وجود إشارة مرجعية الهدف (من خلالDocumentBuilder.StartBookmark()/EndBookmark()) قبل تحديث الحقل الذي يشير إليها. - ضبط
FieldOptions.UserPromptRespondent(انظر الـ دليل الحقول) قبل تحديث مستند يحتوي علىFieldAskorFieldFillInالحقول في خط أنابيب غير مراقب. - يُنمذج
FieldDdeوFieldDdeAutoآلية ربط OLE قديمة في Windows – اعتبرAutoUpdateوIsLinkedمعلوماتية عند معالجة المستندات خارج Windows، لأن التطبيق الخارجي الذي يُجدد منه عادةً غير متوفر. - حقول الاستشهاد والببليوغرافيا تُعرض بشكل صحيح فقط عندما تكون بنية المستند الأساسية
Sourceالسجلات موجودة – راجع ال دليل الببليوغرافيا لبنائها.
مشكلات شائعة
| مشكلة | السبب | الإصلاح |
|---|---|---|
حقل REF / PAGEREF / NOTEREF يُظهر نتيجة خطأ | الـBookmarkName الذي يستهدفه غير موجود في المستند | أنشئ الإشارة المرجعية باستخدام DocumentBuilder.StartBookmark() / EndBookmark() قبل تحديث الحقل |
حقل ASK / FILLIN يمنع التحديث غير المراقب | لم يتم تعيين IFieldUserPromptRespondent | قم بتعيين FieldOptions.UserPromptRespondent، أو اضبط DefaultResponse على الحقل |
حقل CITATION أو BIBLIOGRAPHY يعرض فراغًا | الـSourceTag لا يتطابق مع أي Source في بيانات المراجع الخاصة بالمستند | أضف المطابقة Source – انظر ال دليل الببليوغرافيا |
حقل DDE / DDEAUTO / LINK لا يتم تحديثه | هذه تشير إلى مصدر OLE خارجي غير متوفر في البيئة الحالية | متوقع خارج سياق Windows/OLE الأصلي – تعامل مع Result المخزن كالقيمة الأخيرة المعروفة |
FAQ
ما الفرق بين FieldRef و FieldStyleRef؟
FieldRef يَحلّ إلى المحتوى في مرجعية مسماة (BookmarkName)؛ بينما FieldStyleRef يَحلّ إلى أقرب فقرة مُنسَّقة بـ StyleName المحدد، بغض النظر عن المراجع.
كيف يمكنني إدراج رابط تشعبي بسيط دون إنشاء Field يدويًا؟
استدعِ DocumentBuilder.InsertHyperlink().
هل هذه الفئات الخاصة بالروابط وحقول الإشارة موجودة في مساحة اسم منفصلة عن الحقول الأخرى؟
لا – FieldHyperlink, FieldRef, FieldCitation، وبقية الفئات في هذه الصفحة عادية Field الفئات الفرعية في Aspose.Words.Fields المجال، نفس المجال المشمول في the دليل الحقول.
كيف ترتبط حقول الاستشهاد بنموذج بيانات الببليوغرافيا؟
FieldCitation and FieldBibliography عرض المحتوى عن طريق البحث SourceTag ضد Source السجلات الموصوفة على دليل الببليوغرافيا – تتعامل فئات الحقل مع العرض، و Source / Contributor الفئات تحتفظ بالبيانات الأساسية.
ملخص API Reference
| الفئة | وصف |
|---|---|
FieldHyperlink | HYPERLINK field; Address, SubAddress, ScreenTip, OpenInNewWindow |
FieldRef / FieldPageRef / FieldNoteRef | REF / PAGEREF / NOTEREF حقول؛ حل المحتوى في BookmarkName |
FieldStyleRef | حقل STYLEREF؛ يُحل إلى الفقرة الأقرب في نمط معين |
FieldSet | حقل SET؛ يعرّف قيمة نصية مُحددة لـ REF لتُحل |
FieldAsk / FieldFillIn | حقول ASK / FILLIN؛ يطلب قيمة أثناء التحديث |
FieldDde / FieldDdeAuto / FieldLink | حقول DDE / DDEAUTO / LINK؛ محتوى خارجي مرتبط بـ OLE قديم |
FieldImport / FieldIncludePicture | حقول IMPORT / INCLUDEPICTURE؛ محتوى رسومي خارجي |
FieldInclude / FieldIncludeText | حقول INCLUDE / INCLUDETEXT؛ مستند خارجي أو محتوى XML |
FieldAutoText / FieldAutoTextList / FieldGlossary | حقول AUTOTEXT / AUTOTEXTLIST / GLOSSARY؛ مداخل كتل البناء المرجعية |
FieldCitation / FieldBibliography | حقول CITATION / BIBLIOGRAPHY؛ عرض بيانات مصدر الببليوغرافيا |
FieldQuote / FieldShape | حقول QUOTE / SHAPE؛ نص الحقل الحرفي |
DocumentBuilder.InsertHyperlink | اختصار إدراج الرابط التشعبي عالي المستوى |
DocumentBuilder.StartBookmark / EndBookmark / MoveToBookmark | إنشاء العلامات المرجعية والتنقل إلى أهداف المراجع |