Робота з посиланнями та довідниками
Робота з посиланнями та посиланнями
Кодові поля посилань і перехресних посилань 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(дивіться довідник полів) перед оновленням документа, що міститьFieldAskorFieldFillInполя в автоматизованому конвеєрі. 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 Огляд
| Клас | Опис |
|---|---|
FieldHyperlink | HYPERLINK поле; Address, SubAddress, ScreenTip, OpenInNewWindow |
FieldRef / FieldPageRef / FieldNoteRef | REF / PAGEREF / NOTEREF поля; отримати вміст у BookmarkName |
FieldStyleRef | STYLEREF поле; розв’язується до найближчого абзацу у заданому стилі |
FieldSet | SET поле; визначає закладене текстове значення для REF для розв’язку |
FieldAsk / FieldFillIn | ASK / FILLIN поля; запитати значення під час оновлення |
FieldDde / FieldDdeAuto / FieldLink | DDE / DDEAUTO / LINK поля; застарілий зовнішній вміст, пов’язаний OLE |
FieldImport / FieldIncludePicture | IMPORT / INCLUDEPICTURE поля; зовнішній графічний вміст |
FieldInclude / FieldIncludeText | INCLUDE / INCLUDETEXT поля; зовнішній документ або XML вміст |
FieldAutoText / FieldAutoTextList / FieldGlossary | AUTOTEXT / AUTOTEXTLIST / GLOSSARY поля; посилання на записи будівельних блоків |
FieldCitation / FieldBibliography | CITATION / BIBLIOGRAPHY поля; вивести дані джерела бібліографії |
FieldQuote / FieldShape | QUOTE / SHAPE поля; буквальний текст поля |
DocumentBuilder.InsertHyperlink | Комбінація клавіш для вставки гіперпосилання високого рівня |
DocumentBuilder.StartBookmark / EndBookmark / MoveToBookmark | Створення закладок і навігація до цільових посилань |