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 egyFieldHyperlinkközvetlen létrehozására, ha olyan tulajdonságokra van szükséged, mint aScreenTipvagy aIsImageMap, amelyeket az építő gyorsbillentyű nem tesz elérhetővé. FieldRef,FieldPageRef,FieldNoteRefésFieldSetmind koordinálBookmarkNamesegítségével – győződj meg róla, hogy a célkönyvjelző létezik (aDocumentBuilder.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 tartalmazFieldAskorFieldFillInmezők egy felügyelet nélküli pipeline-ban. FieldDdeésFieldDdeAutoegy régi Windows OLE összekapcsolási mechanizmust modelleznek – kezeld aAutoUpdateésIsLinkedé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ó
Sourcerekordok léteznek – lásd a bibliográfia útmutató azok létrehozásához.
Gyakori problémák
| Probléma | Ok | Javítás |
|---|---|---|
REF / PAGEREF / NOTEREF mező hibás eredményt mutat | A BookmarkName, amelyre hivatkozik, nem létezik a dokumentumban | Hozzon 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ést | Nincs IFieldUserPromptRespondent hozzárendelve | Rendeljen FieldOptions.UserPromptRespondent értéket, vagy állítsa be a DefaultResponse mezőt |
CITATION vagy BIBLIOGRAPHY mező üresen jelenik meg | A SourceTag nem egyezik egyetlen Source sem a dokumentum bibliográfiai adatában | Add hozzá a megfelelő Source – lásd a bibliográfiai útmutatót |
DDE / DDEAUTO / LINK mező nem frissül | Ezek egy külső OLE forrást hivatkoznak, amely nem érhető el a jelenlegi környezetben | Az 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ály | Leírás |
|---|---|
FieldHyperlink | HYPERLINK mező; Address, SubAddress, ScreenTip, OpenInNewWindow |
FieldRef / FieldPageRef / FieldNoteRef | REF / PAGEREF / NOTEREF mezők; oldja fel a tartalmat egy BookmarkName |
FieldStyleRef | STYLEREF mező; megoldja a legközelebbi bekezdést egy adott stílusban |
FieldSet | SET mező; definiál egy könyvjelzőzött szövegértéket a REF feloldásához |
FieldAsk / FieldFillIn | ASK / FILLIN mezők; kérjen értéket a frissítés során |
FieldDde / FieldDdeAuto / FieldLink | DDE / DDEAUTO / LINK mezők; régi OLE-összekapcsolt külső tartalom |
FieldImport / FieldIncludePicture | IMPORT / INCLUDEPICTURE mezők; külső grafikus tartalom |
FieldInclude / FieldIncludeText | INCLUDE / INCLUDETEXT mezők; külső dokumentum vagy XML tartalom |
FieldAutoText / FieldAutoTextList / FieldGlossary | AUTOTEXT / AUTOTEXTLIST / GLOSSARY mezők; referencia építőelemek bejegyzései |
FieldCitation / FieldBibliography | CITATION / BIBLIOGRAPHY mezők; bibliográfiai forrásadatok megjelenítése |
FieldQuote / FieldShape | QUOTE / SHAPE mezők; szó szerinti mezőszöveg |
DocumentBuilder.InsertHyperlink | Magas szintű hiperhivatkozás beszúrási gyorsbillentyű |
DocumentBuilder.StartBookmark / EndBookmark / MoveToBookmark | Könyvjelző létrehozása és navigálás a hivatkozási célpontokhoz |