Praca z linkami i odwołaniami

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 tworzenia FieldHyperlink tylko wtedy, gdy potrzebujesz właściwości takich jak ScreenTip lub IsImageMap, których skrót kreatora nie udostępnia.
  • FieldRef, FieldPageRef, FieldNoteRef i FieldSet wszystkie koordynują się przez BookmarkName – upewnij się, że docelowa zakładka istnieje (poprzez DocumentBuilder.StartBookmark() / EndBookmark()) zanim pole, które do niej odwołuje, zostanie zaktualizowane.
  • Ustaw FieldOptions.UserPromptRespondent (zobacz przewodniku pól) przed aktualizacją dokumentu zawierającego FieldAsk or FieldFillIn pola w nieobsługiwanym potoku.
  • FieldDde i FieldDdeAuto modelują starszy mechanizm linkowania Windows OLE – traktuj AutoUpdate i IsLinked jako 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 Source rekordy istnieją – zobacz przewodnik bibliograficzny do ich budowania.

Typowe problemy

ProblemPrzyczynaNaprawa
REF / PAGEREF / NOTEREF pole wyświetla wynik błęduElement BookmarkName, na który wskazuje, nie istnieje w dokumencieUtwórz zakładkę z DocumentBuilder.StartBookmark() / EndBookmark() przed zaktualizowaniem pola
Pole ASK / FILLIN blokuje aktualizację bez nadzoruNie przypisano IFieldUserPromptRespondentPrzypisz 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 dokumentuDodaj 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 środowiskuOczekiwane 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

KlasaOpis
FieldHyperlinkHYPERLINK pole; Address, SubAddress, ScreenTip, OpenInNewWindow
FieldRef / FieldPageRef / FieldNoteRefREF / PAGEREF / NOTEREF pola; rozwiąż zawartość w BookmarkName
FieldStyleRefSTYLEREF pole; rozwiązuje się do najbliższego akapitu w danym stylu
FieldSetSET pole; definiuje zakładkową wartość tekstową dla REF do rozwiązania
FieldAsk / FieldFillInASK / FILLIN pola; podpowiedź o podanie wartości podczas aktualizacji
FieldDde / FieldDdeAuto / FieldLinkDDE / DDEAUTO / LINK pola; przestarzała zawartość zewnętrzna powiązana z OLE
FieldImport / FieldIncludePictureIMPORT / INCLUDEPICTURE pola; zewnętrzna zawartość graficzna
FieldInclude / FieldIncludeTextINCLUDE / INCLUDETEXT pola; zewnętrzny dokument lub zawartość XML
FieldAutoText / FieldAutoTextList / FieldGlossaryAUTOTEXT / AUTOTEXTLIST / GLOSSARY pola; odwołanie do wpisów bloków budujących
FieldCitation / FieldBibliographyCITATION / BIBLIOGRAPHY pola; renderowanie danych źródłowych bibliografii
FieldQuote / FieldShapeQUOTE / SHAPE pola; dosłowny tekst pola
DocumentBuilder.InsertHyperlinkSkrót do wstawiania hiperłącza na wysokim poziomie
DocumentBuilder.StartBookmark / EndBookmark / MoveToBookmarkTworzenie zakładek i nawigacja do celów referencyjnych

Zobacz także

 Polski