Linkek és hivatkozások kezelése

Linkek és hivatkozások kezelése

Hivatkozások és referenciaelemek kezelése

A Word link és kereszt-hivatkozás mezőkódjai – HYPERLINK, REF, PAGEREF, NOTEREF, STYLEREF, SET, ASK, FILLIN, CITATION, BIBLIOGRAPHY, és továbbiak – mindegyik külön dedikált Field alosztályban Aspose.Words FOSS for .NET. Mindezen osztályok a Aspose.Words.Fields névtérben együtt minden más mezőtípussal; ez az oldal csoportosítja azokat, amelyek kifejezetten linkekkel, kereszt-hivatkozásokkal, felkért értékekkel és idézetekkel foglalkoznak, és bemutatja, hogy minden egyes mi mindent tesz elérhetővé.


Hyperlinks

FieldHyperlink a HYPERLINK mezőt jelenti: Address és SubAddress tárolják a cél URL-t vagy a dokumentumban lévő helyet, ScreenTip állítja be a lebegő tooltipet, OpenInNewWindow és IsImageMap megjelenítési jelzők, és Target egy böngészőkeretet nevez meg. Egyszerű esetekben a DocumentBuilder.InsertHyperlink() közvetlenül beilleszti a hiperhivatkozás mezőt anélkül, hogy kézzel felépítené a Field objektumot.


Keresztreferenciák könyvjelzőkhöz

FieldRef (a REF mező), FieldPageRef (PAGEREF), és FieldNoteRef (NOTEREF) mindegyik a nevű könyvjelzőnél lévő tartalmat oldja fel a BookmarkName tulajdonságukon keresztül, a InsertHyperlink és InsertRelativePosition szabályozzák, hogy a referencia kattintható-e és hogy relatív pozíciót jelent-e („fölötte” / „alatt”). FieldRef bevezet bekezdésszámozási lehetőségeket (InsertParagraphNumber, InsertParagraphNumberInFullContext, InsertParagraphNumberInRelativeContext, NumberSeparator) és IncludeNoteOrComment. FieldStyleRef (STYLEREF) ehelyett a legközelebbi bekezdéshez tér vissza, amely adott StyleName formázással rendelkezik, a SearchFromBottom segítségével visszafelé keresve a mező pozíciójától. A mezők által célzott könyvjelzőket a DocumentBuilder.StartBookmark() és EndBookmark() hozza létre, és a MoveToBookmark() segítségével navigálhatóak. FieldSet (SET) egy könyvjelölt szövegértéket definiál – BookmarkName és BookmarkText –, amelyet egy másik REF mező fel tud oldani.


Felkért-érték mezők

FieldAsk (ASK) és FieldFillIn (FILLIN) kér egy értéket attól, aki frissíti a mezőt: PromptText megjelenik a felhasználó számára, DefaultResponse biztosít egy tartalékot, PromptOnceOnMailMerge korlátozza az ismételt kérdezést a levél-egyesítés során. FieldAsk továbbá tárolja a válaszát a BookmarkName más mezők számára referenciaként. Lásd a mezők útmutatója for IFieldUserPromptRespondent, a visszahívás, amely programozott módon szolgáltatja a válaszokat ezekhez a mezőkhöz ahelyett, hogy interaktívan kérdezne.


Külső és kapcsolt tartalom

FieldDde (DDE) és FieldDdeAuto (DDEAUTO) másik alkalmazásban lévő tartalomra hivatkoznak a ProgId, SourceFullName és SourceItem segítségével, a InsertAsText, InsertAsHtml, InsertAsPicture, InsertAsRtf, InsertAsUnicode és InsertAsBitmap választják ki a beillesztett ábrázolást, míg a AutoUpdate / IsLinked szabályozza a frissítési viselkedést. FieldLink (LINK) az OLE-link megfelelője, amely FormatUpdateType-t ad hozzá. FieldImport (IMPORT) és FieldIncludePicture (INCLUDEPICTURE) külső grafikát húznak be a SourceFullName és GraphicFilter segítségével. FieldInclude (INCLUDE) és FieldIncludeText (INCLUDETEXT) külső dokumentumtartalmat importálnak, a BookmarkName meghatározza a beillesztett tartományt, a LockFields pedig megakadályozza a frissítést; FieldIncludeText továbbá támogatja a XML forrásokat a Encoding, MimeType, NamespaceMappings, XPath és XslTransformation révén.


AutoText és szószedet hivatkozások

FieldAutoText (AUTOTEXT), FieldAutoTextList (AUTOTEXTLIST) és FieldGlossary (GLOSSARY) mindegyike egy névvel ellátott építőelemet hivatkozik a EntryName segítségével; FieldAutoTextList hozzáadja a ListStyle és a ScreenTip elemeket a lista-stílusú megjelenítéshez.


Hivatkozási és bibliográfiai mezők

FieldCitation (CITATION) és FieldBibliography (BIBLIOGRAPHY) a dokumentum bibliográfiai adataiból származó tartalmat jeleníti meg. FieldCitation.SourceTag (és a helyettesítő AnotherSourceTag) azonosítja, hogy mely forrást idézi, a Prefix, Suffix, PageNumber, VolumeNumber, és a Suppress* kapcsolók (SuppressAuthor, SuppressTitle, SuppressYear) szabályozzák, hogyan formázódik a hivatkozás. FieldBibliography.SourceTag, FilterLanguageId, és FormatLanguageId szabályozzák, hogy mely források jelenjenek meg a megjelenített bibliográfiában és milyen nyelven. Az alapszintű forrás rögzíti ezeket a mezőket, amelyek megjelennek – Source, Contributor, Person – le vannak fedve a irodalomjegyzék útmutató.


Idézet és alakzat szövegmezők

FieldQuote (QUOTE) és FieldShape (SHAPE) egyaránt egy Text tulajdonságot kínál, amely szó szerinti mezőszöveget tartalmaz – a FieldQuote közvetlenül a mező pozíciójába illeszti be, míg a FieldShape egy rajz alakzat szöveget hordozó mezőkóddal társítja.


Tippek és bevált gyakorlatok

  • A DocumentBuilder.InsertHyperlink() használata előnyösebb az egyszerű hiperhivatkozás beszúrásához; csak akkor térj át egy FieldHyperlink közvetlen létrehozására, ha olyan tulajdonságokra van szükséged, mint a ScreenTip vagy a IsImageMap, amelyeket az építő gyorsbillentyű nem tesz elérhetővé.
  • FieldRef, FieldPageRef, FieldNoteRef és FieldSet mind koordinál BookmarkName segítségével – győződj meg róla, hogy a célkönyvjelző létezik (a DocumentBuilder.StartBookmark() / EndBookmark() segítségével), mielőtt a rá hivatkozó mező frissül.
  • Halmaz FieldOptions.UserPromptRespondent (lásd a mezők útmutató) mielőtt frissítene egy dokumentumot, amely tartalmaz FieldAsk or FieldFillIn mezők egy felügyelet nélküli pipeline-ban.
  • FieldDde és FieldDdeAuto egy régi Windows OLE összekapcsolási mechanizmust modelleznek – kezeld a AutoUpdate és IsLinked értékeket információs jellegűnek, amikor Windowson kívül dolgozol a dokumentumokkal, mivel a külső alkalmazás, amelyből általában frissítenének, nem érhető el.
  • A hivatkozási és bibliográfiai mezők csak akkor jelennek meg helyesen, amikor a dokumentum alapjául szolgáló Source rekordok léteznek – lásd a bibliográfia útmutató azok létrehozásához.

Gyakori problémák

ProblémaOkJavítás
REF / PAGEREF / NOTEREF mező hibás eredményt mutatA BookmarkName, amelyre hivatkozik, nem létezik a dokumentumbanHozzon létre könyvjelzőt DocumentBuilder.StartBookmark() / EndBookmark() segítségével a mező frissítése előtt
A ASK / FILLIN mező megakadályozza a felügyelet nélküli frissítéstNincs IFieldUserPromptRespondent hozzárendelveRendeljen FieldOptions.UserPromptRespondent értéket, vagy állítsa be a DefaultResponse mezőt
CITATION vagy BIBLIOGRAPHY mező üresen jelenik megA SourceTag nem egyezik egyetlen Source sem a dokumentum bibliográfiai adatábanAdd hozzá a megfelelő Source – lásd a bibliográfiai útmutatót
DDE / DDEAUTO / LINK mező nem frissülEzek egy külső OLE forrást hivatkoznak, amely nem érhető el a jelenlegi környezetbenAz eredeti Windows/OLE kontextuson kívül várható – tekintse a tárolt Result értéket az utolsó ismert értéknek

FAQ

Mi a különbség a FieldRef és a FieldStyleRef között?

FieldRef a névvel ellátott könyvjelzőn (BookmarkName) található tartalomra mutat; a FieldStyleRef ehelyett a legközelebbi, adott StyleName formázású bekezdésre mutat, a könyvjelzőktől függetlenül.

Hogyan szúrhatok be egy egyszerű hiperhivatkozást anélkül, hogy kézzel építenék egy Field?

Hívja meg a DocumentBuilder.InsertHyperlink().

Külön névtérben vannak-e ezek a link- és referencia-mező osztályok a többi mezőtől?

Nem – FieldHyperlink, FieldRef, FieldCitation, és az ezen az oldalon lévő osztályok többi része szokványos Field alosztályok a Aspose.Words.Fields névtérben, ugyanaz a névtér, amelyet a mezők útmutatója.

Hogyan kapcsolódnak a hivatkozási mezők a bibliográfiai adatmodellhez?

FieldCitation and FieldBibliography tartalmat renderel a keresés alapján SourceTag szemben a Source a leírt rekordok bibliográfiai útmutató – a mezőosztályok kezelik a renderelést, és a Source / Contributor az osztályok tárolják az alapszintű adatokat.


API Reference Összegzés

OsztályLeírás
FieldHyperlinkHYPERLINK mező; Address, SubAddress, ScreenTip, OpenInNewWindow
FieldRef / FieldPageRef / FieldNoteRefREF / PAGEREF / NOTEREF mezők; oldja fel a tartalmat egy BookmarkName
FieldStyleRefSTYLEREF mező; megoldja a legközelebbi bekezdést egy adott stílusban
FieldSetSET mező; definiál egy könyvjelzőzött szövegértéket a REF feloldásához
FieldAsk / FieldFillInASK / FILLIN mezők; kérjen értéket a frissítés során
FieldDde / FieldDdeAuto / FieldLinkDDE / DDEAUTO / LINK mezők; régi OLE-összekapcsolt külső tartalom
FieldImport / FieldIncludePictureIMPORT / INCLUDEPICTURE mezők; külső grafikus tartalom
FieldInclude / FieldIncludeTextINCLUDE / INCLUDETEXT mezők; külső dokumentum vagy XML tartalom
FieldAutoText / FieldAutoTextList / FieldGlossaryAUTOTEXT / AUTOTEXTLIST / GLOSSARY mezők; referencia építőelemek bejegyzései
FieldCitation / FieldBibliographyCITATION / BIBLIOGRAPHY mezők; bibliográfiai forrásadatok megjelenítése
FieldQuote / FieldShapeQUOTE / SHAPE mezők; szó szerinti mezőszöveg
DocumentBuilder.InsertHyperlinkMagas szintű hiperhivatkozás beszúrási gyorsbillentyű
DocumentBuilder.StartBookmark / EndBookmark / MoveToBookmarkKönyvjelző létrehozása és navigálás a hivatkozási célpontokhoz

Lásd még:

 Magyar