Робота з посиланнями та довідниками

Робота з посиланнями та довідниками

Робота з посиланнями та посиланнями

Кодові поля посилань і перехресних посилань Word – HYPERLINK, REF, PAGEREF, NOTEREF, STYLEREF, SET, ASK, FILLIN, CITATION, BIBLIOGRAPHY, і ще – реалізовані як окремі Field підклас у Aspose.Words FOSS for .NET. Усі ці класи розташовані в Aspose.Words.Fields просторі імен разом з усіма іншими типами полів; ця сторінка групує ті, які спеціально стосуються посилань, перехресних посилань, запитуваних значень та цитувань, і описує, що кожен з них розкриває.


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-посилання, додаючи 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 (дивіться довідник полів) перед оновленням документа, що містить FieldAsk or FieldFillIn поля в автоматизованому конвеєрі.
  • FieldDde і FieldDdeAuto моделюють застарілий механізм зв’язування Windows OLE — сприймайте AutoUpdate і IsLinked як інформативні при обробці документів поза Windows, оскільки зовнішній застосунок, з якого вони зазвичай оновлюються, недоступний.
  • Поля цитування та бібліографії відображаються правильно лише тоді, коли існують базові записи документа 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 простір імен, той самий простір імен, охоплений у довідник полів.

Як поля цитування пов’язані з моделлю даних бібліографії?

FieldCitation and FieldBibliography виводити вміст, шукаючи SourceTag проти Source записами, описаними у довіднику з бібліографії – класи полів обробляють рендеринг, і Source / Contributor класи зберігають базові дані.


API Reference Огляд

КласОпис
FieldHyperlinkHYPERLINK поле; Address, SubAddress, ScreenTip, OpenInNewWindow
FieldRef / FieldPageRef / FieldNoteRefREF / PAGEREF / NOTEREF поля; отримати вміст у BookmarkName
FieldStyleRefSTYLEREF поле; розв’язується до найближчого абзацу у заданому стилі
FieldSetSET поле; визначає закладене текстове значення для REF для розв’язку
FieldAsk / FieldFillInASK / FILLIN поля; запитати значення під час оновлення
FieldDde / FieldDdeAuto / FieldLinkDDE / DDEAUTO / LINK поля; застарілий зовнішній вміст, пов’язаний OLE
FieldImport / FieldIncludePictureIMPORT / INCLUDEPICTURE поля; зовнішній графічний вміст
FieldInclude / FieldIncludeTextINCLUDE / INCLUDETEXT поля; зовнішній документ або XML вміст
FieldAutoText / FieldAutoTextList / FieldGlossaryAUTOTEXT / AUTOTEXTLIST / GLOSSARY поля; посилання на записи будівельних блоків
FieldCitation / FieldBibliographyCITATION / BIBLIOGRAPHY поля; вивести дані джерела бібліографії
FieldQuote / FieldShapeQUOTE / SHAPE поля; буквальний текст поля
DocumentBuilder.InsertHyperlinkКомбінація клавіш для вставки гіперпосилання високого рівня
DocumentBuilder.StartBookmark / EndBookmark / MoveToBookmarkСтворення закладок і навігація до цільових посилань

Дивіться також

 Українська