Вставити поля
Є кілька різних способів вставити поля в документ:
- використання DocumentBuilder
- використання FieldBuilder
- використання Aspose.Words Document Object Model (DOM)
У цій статті ми розглянемо кожен спосіб більш детально і аналізуємо, як вставляти певні поля за допомогою цих параметрів.
Введення полів у документ з використанням DocumentBuilder
У Aspose.Words Про нас insert_field метод використовується для вставки нових полів в документ. Перший параметр приймає повне поле коду поля, щоб бути вставленим. Другий параметр є обов’язковим і дозволяє польовий результат поля, щоб встановити вручну. Якщо це не подається, то поле автоматично оновлюється. Ви можете пройти null або порожній до цього параметра, щоб вставити поле з порожнім значенням поля. Якщо ви не впевнені, що конкретний код поля синтаксису, створюємо поле в Microsoft Word спочатку і переключіть, щоб побачити свій код поля.
Приклад наступного коду показує, як вставити поле злиття в документ, використовуючи DocumentBuilder:
Приклад коду показує, як вставляти об’єднане поле з німецькою локалізацією в документ, використовуючи DocumentBuilder:
Така ж техніка використовується для вставок полів, що приводяться в інші поля.
Наприклад, наступний код показує, як вставити поля, що містяться в іншому полі за допомогою DocumentBuilder:
Вказати місцевість на рівні поля
English, Українська, Français… З Aspose.Words, Ви можете вказати Локація на рівні поля. Про нас locale_id майно отримує або встановлює місцевий ідентифікатор поля.
Приклад наступного коду показує, як використовувати цей варіант:
Вставити нетипове поле
Якщо ви хочете вставити нетипові / порожні поля ({}) так само як Microsoft Word дозволяє, ви можете використовувати insert_field метод з FieldType.FIELD_NONE параметр. Щоб вставити поле в документ Word, ви можете натиснути клавішу “Ctrl + F9”.
Приклад коду показує, як вставити порожні поля в документ:
Введення полів в документ з використанням FieldBuilder
Альтернативний спосіб вставити поля в Aspose.Words є FieldBuilder клас. Він надає швидкий інтерфейс, щоб вказати значення поля та значення аргументів, як текст, вершини або навіть вкладені поля.
Приклад наступного коду показує, як вставити поле в документ, використовуючи FieldBuilder:
Вставки поля з використанням DOM
Ви також можете вставляти різні види полів Aspose.Words Document Object Model (DOM)й В цьому розділі ми розглянемо кілька прикладів.
Вставки Поле в документ з використанням DOM
Про нас MERGEFIELD
поле в документі Word може бути представлений FieldMergeField клас. Ви можете використовувати FieldMergeField Клас виконання наступних операцій:
- вказати ім’я поля злиття
- вказати форматування поля злиття
- вкажіть текст, який знаходиться між польовим сепаратором і польовим закінченням об’єднання поля
- вказати текст, який буде вставлений після об’єднання поля, якщо поле не порожній
- вкажіть текст, який буде вставлятися до поля злиття, якщо поле не порожній
Приклад наступного коду показує, як додати Merge
Використання поля DOM до пункту у документі:
Вставки Mail Merge ADDRESSBLOCK
поле в Документ, використовуючи DOM
Про нас ADDRESSBLOCK
поле використовується для вставки Mail Merge адресний блок у документі Word. ADDRESSBLOCK
поле в документі Word може бути представлений FieldAddressBlock клас. Ви можете використовувати FieldAddressBlock Клас виконання наступних операцій:
- вкажіть, чи вкажіть ім’я країни/регіон в полі
- вкажіть, чи відформатувати адресу відповідно до країни/регіону одержувача, визначеної POST*CODE (Універсальний поштовий союз 2006)
- вкажіть назву виключеної країни/регіону
- вказати назву та формат адреси
- вказати ідентифікатор мови, який використовується для форматування адреси
Приклад наступного коду показує, як додати Mail Merge ADDRESSBLOCK
Використання поля DOM до пункту у документі:
Вставки ADVANCE
JavaScript licenses API Веб-сайт Go1.13.8
Про нас ADVANCE
поле використовується для відключення наступного тексту в рядок зліва, праворуч, вгору або вниз. Про нас ADVANCE
поле в документі Word може бути представлений FieldAdvance клас. Ви можете використовувати FieldAdvance Клас виконання наступних операцій:
- вказати кількість точок, за допомогою яких текст, який слід перенести поле вертикально з верхнього краю сторінки
- вкажіть кількість точок, за допомогою яких текст, який слід перенести поле горизонтально з лівого краю стовпчика, рамки або текстової коробки
- вказати кількість точок, за допомогою яких текст, який слід перенести зліва, праворуч, вгору або вниз
Приклад наступного коду показує, як додати ADVANCE
Використання поля DOM до пункту у документі.
Вставки ASK
JavaScript licenses API Веб-сайт Go1.13.8
Про нас ASK
поле використовується для підказки користувача для тексту, щоб призначити закладку у документі Word. ASK
поле в документі Word може бути представлений FieldAsk клас. Ви можете використовувати FieldAsk Клас виконання наступних операцій:
- вказати ім’я закладки
- вказати відповідь користувача за замовчуванням (ініційне значення, що міститься в вікні запиту)
- вкажіть, чи мається відповідь користувача Mail Merge робота
- вказати підказковий текст (голова вікна підказки)
Приклад наступного коду показує, як додати ASK
Використання поля DOM до пункту у документі:
Вставки AUTHOR
JavaScript licenses API Веб-сайт Go1.13.8
Про нас AUTHOR
поле використовується для позначення імені автора документа з документа Document
властивості. Про нас AUTHOR
поле в документі Word може бути представлений FieldAuthor клас. Ви можете використовувати FieldAuthor Клас виконання наступних операцій:
- вказати ім’я автора документа
Приклад наступного коду показує, як додати AUTHOR
Використання поля DOM до пункту у документі:
Вставки INCLUDETEXT
JavaScript licenses API Веб-сайт Go1.13.8
Про нас INCLUDETEXT
поле вставляє текст і графіку, що міститься в документі, зазначеному в полі коду. Ви можете вставляти весь документ або частину документа, зазначеного у закладці. Це поле в документі Word представлена INCLUDETEXT. Ви можете використовувати FieldIncludeText Клас виконання наступних операцій:
- вказати ім’я закладки вказаного документа
- вказати розташування документа
Приклад наступного коду показує, як додати INCLUDETEXT
використання поля DOM до пункту у документі:
Вставки TOA
JavaScript licenses API Веб-сайт Go1.13.8
Про нас TOA
(Включення повноважень) польових споруд та вставок таблиці органів влади. Про нас TOA
поле збирає записи, позначені TA
(Увімкнення полів авторських прав) Microsoft Office Word вставляє TOA
поле, коли ви натискаєте Вставити таблицю авторів в Зміст група на References Увійти Коли ви переглядаєте TOA
поле у вашому документі, синтаксис виглядає так:
{ TOA
[Switches ] }
Ви можете використовувати FieldToa клас для виконання операцій з TOA
поле.
Приклад наступного коду показує, як додати TOA
використання поля DOM до пункту у документі: