लिंक और संदर्भों के साथ काम करना
लिंक्स और संदर्भों के साथ काम करना
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-link के समकक्ष है, जो 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) दस्तावेज़ की ग्रंथसूची डेटा से प्राप्त सामग्री को रेंडर करता है। 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एक पुरानी Windows OLE लिंकिंग मेकेनिज्म को मॉडल करते हैं – Windows के बाहर दस्तावेज़ प्रोसेस करते समयAutoUpdateऔरIsLinkedको सूचना संबंधी मानें, क्योंकि वह बाहरी एप्लिकेशन जिससे वे सामान्यतः रीफ़्रेश होते हैं, उपलब्ध नहीं है।- उद्धरण और ग्रंथसूची फ़ील्ड्स केवल तभी सही रूप से रेंडर होते हैं जब दस्तावेज़ के अंतर्निहित
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 namespace, वही namespace जो … में कवर किया गया फ़ील्ड्स गाइड.
उद्धरण फ़ील्ड्स ग्रंथसूची डेटा मॉडल से कैसे संबंधित हैं?
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 | संदर्भ लक्ष्यों के लिए बुकमार्क निर्माण और नेविगेशन |