Замініть поля статичним текстом

Заміна полів часто потрібна, коли ви хочете зберегти документ як статичну копію. Наприклад, при відправці в якості вкладення в електронному листі. Перетворення таких полів, як DATE або TIME, у статичний текст дозволить відображати ту саму дату в документі, що і при поданні. Крім того, у деяких ситуаціях вам може знадобитися видалити умовні поля IF зі свого документа та замінити їх останнім текстовим результатом. Наприклад, перетворимо результат роботи поля IF в статичний текст, щоб воно більше не змінювало своє значення динамічно при оновленні полів в документі.

На наведеній нижче діаграмі показано, як поле IF зберігається в документі:

• текст оточений спеціальними вузлами полів - FieldStart і FieldEnd
• вузол FieldSeparator розділяє текст всередині поля на код поля та результат поля
• код поля визначає загальну поведінку поля, тоді як результат за полем зберігає останній результат при оновленні цього поля за допомогою Microsoft Word або Aspose.Words
• результат роботи з полем-це те, що зберігається в полі і відображається в документі при перегляді

Структуру також можна побачити нижче в ієрархічному вигляді, використовуючи демонстраційний проект “DocumentExplorer”.

Поля, які не можуть бути замінені текстом

Заміна поля статичним текстом не працює належним чином для деяких полів у верхньому або нижньому колонтитулі.

Наприклад, спроба перетворити поле PAGE у верхньому або нижньому колонтитулі в статичний текст призведе до відображення одного і того ж значення на всіх сторінках. Це пов’язано з тим, що колонтитули та колонтитули повторюються на кількох сторінках, і коли вони залишаються у вигляді полів, вони обробляються певним чином, щоб відобразити правильний результат для кожної сторінки.

Однак у заголовку поле PAGE добре перетворюється на статичний фрагмент тексту. Цей фрагмент тексту буде оцінюватися так, ніби це остання сторінка в розділі, що призведе до відображення будь-якого поля PAGE у заголовку як останньої сторінки на всіх сторінках.

Наступний приклад коду показує, як замінити поле останнім результатом:

Перетворення певних типів полів у певних частинах документа

Оскільки метод ConvertFieldsToStaticText приймає два параметри – властивості CompositeNode і перерахування FieldType, цьому методу можна передати будь-який складений вузол. Це дозволяє перетворювати поля в статичний текст лише в певних частинах документа.

Наприклад, ви можете передати об’єкт Document і перетворити поля вказаного типу з усього документа в статичний текст, або ви можете передати об’єкт Body розділу і перетворити лише поля, знайдені в цьому тексті.

Передаючи вузол на рівні блоку, наприклад Paragraph, майте на увазі, що в деяких випадках поля можуть займати кілька абзаців. У цьому випадку рекомендується передавати батьківський елемент складеного елемента, щоб уникнути цього.

Перерахування FieldType, передане методу ConvertFieldsToStaticText, вказує, який тип полів слід перетворити на статичний текст. Будь-який інший тип полів, знайдений у документі, залишиться незмінним.

Наступний приклад коду показує, як вибрати поля певного типу - targetFieldType у певному вузлі - compositeNode, а потім перетворити їх у статичний текст:

Наступний приклад коду показує, як перетворити всі поля IF у документі в статичний текст:

Наступний приклад коду показує, як перетворити всі поля PAGE у тексті документа в статичний текст:

Наступний приклад коду показує, як перетворити всі поля IF в останньому абзаці в статичний текст: