Praca z linkami i odwołaniami
Praca z odnośnikami i odniesieniami
Kody pól linków i odwołań krzyżowych w programie Word – HYPERLINK, REF, PAGEREF, NOTEREF, STYLEREF, SET, ASK, FILLIN, CITATION, BIBLIOGRAPHY, i więcej – są wszystkie implementowane jako dedykowane Field podklasa w Aspose.Words FOSS for .NET. Wszystkie te klasy znajdują się w Aspose.Words.Fields przestrzeni nazw razem ze wszystkimi innymi typami pól; ta strona grupuje te, które są szczególnie związane z linkami, odwołaniami krzyżowymi, wartościami wprowadzanymi na żądanie oraz cytatami, i opisuje, co każda z nich udostępnia.
Hyperlinks
FieldHyperlink reprezentuje pole HYPERLINK: Address i SubAddress przechowują docelowy adres URL lub lokalizację w dokumencie, ScreenTip ustawia podpowiedź po najechaniu, OpenInNewWindow i IsImageMap są flagami wyświetlania, a Target nazywa ramkę przeglądarki. W prostych przypadkach DocumentBuilder.InsertHyperlink() wstawia pole hiperłącza bezpośrednio, bez ręcznego tworzenia obiektu Field.
Odnośniki krzyżowe do zakładek
FieldRef (pole REF), FieldPageRef (PAGEREF) oraz FieldNoteRef (NOTEREF) każdy rozwiązuje się do treści w nazwanej zakładce poprzez ich właściwość BookmarkName, przy czym InsertHyperlink i InsertRelativePosition kontrolują, czy odwołanie jest klikalne oraz czy raportuje pozycję względną („powyżej” / „poniżej”). FieldRef dodaje opcje numeracji akapitów (InsertParagraphNumber, InsertParagraphNumberInFullContext, InsertParagraphNumberInRelativeContext, NumberSeparator) oraz IncludeNoteOrComment. FieldStyleRef (STYLEREF) zamiast tego rozwiązuje się do najbliższego akapitu sformatowanego określonym StyleName, przy czym SearchFromBottom umożliwia wyszukiwanie wstecz od pozycji pola. Zakładki, do których te pola się odwołują, są tworzone za pomocą DocumentBuilder.StartBookmark() i EndBookmark(), i można do nich przejść przy użyciu MoveToBookmark(). FieldSet (SET) definiuje wartość tekstową zakładki — BookmarkName i BookmarkText — którą pole REF w innym miejscu może rozwiązać.
Pola wartości podpowiadanej
FieldAsk (ASK) oraz FieldFillIn (FILLIN) żądają wartości od osoby, która aktualizuje pole: PromptText jest wyświetlane użytkownikowi, DefaultResponse zapewnia awaryjną opcję, i PromptOnceOnMailMerge ogranicza powtarzające się wywoływanie pytań podczas scalania korespondencji. FieldAsk dodatkowo zapisuje swoją odpowiedź w BookmarkName aby inne pola mogły się do niej odwołać. Zobacz przewodnik po polach for IFieldUserPromptRespondent, wywołanie zwrotne (callback), które dostarcza odpowiedzi do tych pól programowo zamiast wyświetlać interaktywne pytania.
Zewnętrzna i połączona zawartość
FieldDde (DDE) i FieldDdeAuto (DDEAUTO) łączą się z zawartością w innej aplikacji za pośrednictwem ProgId, SourceFullName i SourceItem, przy czym InsertAsText, InsertAsHtml, InsertAsPicture, InsertAsRtf, InsertAsUnicode i InsertAsBitmap wybierają wstawioną reprezentację, a AutoUpdate / IsLinked kontrolują zachowanie odświeżania. FieldLink (LINK) jest odpowiednikiem łącza OLE, dodając FormatUpdateType. FieldImport (IMPORT) i FieldIncludePicture (INCLUDEPICTURE) wprowadzają zewnętrzną grafikę za pośrednictwem SourceFullName i GraphicFilter. FieldInclude (INCLUDE) i FieldIncludeText (INCLUDETEXT) wprowadzają zawartość zewnętrznego dokumentu, przy czym BookmarkName określa zakres włączonego fragmentu, a LockFields zapobiega jego odświeżeniu; FieldIncludeText dodatkowo obsługuje źródła XML poprzez Encoding, MimeType, NamespaceMappings, XPath i XslTransformation.
AutoText i odwołania do glosariusza
FieldAutoText (AUTOTEXT), FieldAutoTextList (AUTOTEXTLIST) i FieldGlossary (GLOSSARY) odwołują się do nazwanej pozycji bloku konstrukcyjnego poprzez EntryName; FieldAutoTextList dodaje ListStyle i ScreenTip dla prezentacji w stylu listy.
Pola cytowań i bibliografii
FieldCitation (CITATION) i FieldBibliography (BIBLIOGRAPHY) renderuje zawartość pochodzącą z danych bibliografii dokumentu. FieldCitation.SourceTag (i alternatywny AnotherSourceTag) identyfikuje, które źródło jest cytowane, z Prefix, Suffix, PageNumber, VolumeNumber, i Suppress* flagi (SuppressAuthor, SuppressTitle, SuppressYear) kontrolujące, jak cytat jest formatowany. FieldBibliography.SourceTag, FilterLanguageId, i FormatLanguageId kontrolują, które źródła pojawiają się w renderowanej bibliografii i w jakim języku. Podstawowe źródło rejestruje te pola renderowania – Source, Contributor, Person – są omówione w przewodniku bibliograficznym.
Pola cytatu i kształtu tekstu
FieldQuote (QUOTE) i FieldShape (SHAPE) oba udostępniają właściwość Text zawierającą dosłowny tekst pola – FieldQuote wstawia ją bezpośrednio w pozycji pola, podczas gdy FieldShape kojarzy ją z kodem pola niosącym tekst w kształcie rysunku.
Wskazówki i najlepsze praktyki
- Preferuj
DocumentBuilder.InsertHyperlink()przy prostym wstawianiu hiperłącza; przejdź do bezpośredniego tworzeniaFieldHyperlinktylko wtedy, gdy potrzebujesz właściwości takich jakScreenTiplubIsImageMap, których skrót kreatora nie udostępnia. FieldRef,FieldPageRef,FieldNoteRefiFieldSetwszystkie koordynują się przezBookmarkName– upewnij się, że docelowa zakładka istnieje (poprzezDocumentBuilder.StartBookmark()/EndBookmark()) zanim pole, które do niej odwołuje, zostanie zaktualizowane.- Ustaw
FieldOptions.UserPromptRespondent(zobacz przewodniku pól) przed aktualizacją dokumentu zawierającegoFieldAskorFieldFillInpola w nieobsługiwanym potoku. FieldDdeiFieldDdeAutomodelują starszy mechanizm linkowania Windows OLE – traktujAutoUpdateiIsLinkedjako informacyjne przy przetwarzaniu dokumentów poza systemem Windows, ponieważ zewnętrzna aplikacja, z której normalnie by były odświeżane, nie jest dostępna.- Pola cytowania i bibliografii renderują się prawidłowo dopiero po tym, jak podstawowy
Sourcerekordy istnieją – zobacz przewodnik bibliograficzny do ich budowania.
Typowe problemy
| Problem | Przyczyna | Naprawa |
|---|---|---|
REF / PAGEREF / NOTEREF pole wyświetla wynik błędu | Element BookmarkName, na który wskazuje, nie istnieje w dokumencie | Utwórz zakładkę z DocumentBuilder.StartBookmark() / EndBookmark() przed zaktualizowaniem pola |
Pole ASK / FILLIN blokuje aktualizację bez nadzoru | Nie przypisano IFieldUserPromptRespondent | Przypisz FieldOptions.UserPromptRespondent lub ustaw DefaultResponse w polu |
Pole CITATION lub BIBLIOGRAPHY wyświetla pustą wartość | Element SourceTag nie pasuje do żadnego Source w danych bibliograficznych dokumentu | Dodaj pasujący Source – zobacz przewodnik bibliograficzny |
DDE / DDEAUTO / LINK pole nie odświeża się | Odwołują się do zewnętrznego źródła OLE, które nie jest dostępne w bieżącym środowisku | Oczekiwane poza oryginalnym kontekstem Windows/OLE – traktuj przechowywane Result jako ostatnio znaną wartość |
FAQ
Jaka jest różnica między FieldRef a FieldStyleRef?
FieldRef odwołuje się do treści w nazwanym zakładce (BookmarkName); FieldStyleRef natomiast odwołuje się do najbliższego akapitu sformatowanego przy użyciu podanego StyleName, niezależnie od zakładek.
Jak wstawić prosty hiperłącze bez ręcznego tworzenia Field?
Wywołaj DocumentBuilder.InsertHyperlink().
Czy te klasy pól linku i odniesienia znajdują się w oddzielnej przestrzeni nazw od innych pól?
Nie – FieldHyperlink, FieldRef, FieldCitation, a pozostałe klasy na tej stronie są zwykłe Field podklasy w Aspose.Words.Fields przestrzeń nazw, ta sama przestrzeń nazw omówiona w przewodniku po polach.
Jak pola cytowań odnoszą się do modelu danych bibliografii?
FieldCitation and FieldBibliography renderuj treść, wyszukując SourceTag w stosunku do Source rekordy opisane w przewodniku bibliograficznym – klasy pól obsługują renderowanie, a Source / Contributor klasy przechowują podstawowe dane.
API Reference Podsumowanie
| Klasa | Opis |
|---|---|
FieldHyperlink | HYPERLINK pole; Address, SubAddress, ScreenTip, OpenInNewWindow |
FieldRef / FieldPageRef / FieldNoteRef | REF / PAGEREF / NOTEREF pola; rozwiąż zawartość w BookmarkName |
FieldStyleRef | STYLEREF pole; rozwiązuje się do najbliższego akapitu w danym stylu |
FieldSet | SET pole; definiuje zakładkową wartość tekstową dla REF do rozwiązania |
FieldAsk / FieldFillIn | ASK / FILLIN pola; podpowiedź o podanie wartości podczas aktualizacji |
FieldDde / FieldDdeAuto / FieldLink | DDE / DDEAUTO / LINK pola; przestarzała zawartość zewnętrzna powiązana z OLE |
FieldImport / FieldIncludePicture | IMPORT / INCLUDEPICTURE pola; zewnętrzna zawartość graficzna |
FieldInclude / FieldIncludeText | INCLUDE / INCLUDETEXT pola; zewnętrzny dokument lub zawartość XML |
FieldAutoText / FieldAutoTextList / FieldGlossary | AUTOTEXT / AUTOTEXTLIST / GLOSSARY pola; odwołanie do wpisów bloków budujących |
FieldCitation / FieldBibliography | CITATION / BIBLIOGRAPHY pola; renderowanie danych źródłowych bibliografii |
FieldQuote / FieldShape | QUOTE / SHAPE pola; dosłowny tekst pola |
DocumentBuilder.InsertHyperlink | Skrót do wstawiania hiperłącza na wysokim poziomie |
DocumentBuilder.StartBookmark / EndBookmark / MoveToBookmark | Tworzenie zakładek i nawigacja do celów referencyjnych |