Вмъкване На Полета

Има няколко различни начина за вмъкване на полета в документ:

В тази статия ще разгледаме всеки начин по-подробно и ще анализираме как да вмъкнете определени полета, като използвате тези опции.

Вмъкване на полета в документ с DocumentBuilder

В Aspose.Words методът InsertField се използва за вмъкване на нови полета в документ. Първият параметър приема пълния код на полето, което трябва да бъде въведено. Вторият параметър е незадължителен и позволява резултатът от полето да бъде зададен ръчно. Ако това не е предоставено, полето се актуализира автоматично. Можете да подадете нулева или празна стойност към този параметър, за да вмъкнете поле със стойност на празно поле. Ако не сте сигурни за конкретния синтаксис на кода на полето, първо създайте полето в Microsoft Word и превключете, за да видите неговия код на полето.

Следващият пример за код показва как да вмъквате поле за обединяване в документ, като използвате DocumentBuilder:

Същата техника се използва за вмъкване на полета, вложени в други полета.

Следващият пример за код показва как да вмъкнете полета, вложени в друго поле, като използвате DocumentBuilder:

Задаване на локала на ниво поле

Езиков идентификатор е стандартно международно числово съкращение за езика в дадена страна или географски регион. С Aspose.Words можете да зададете езиковата променлива на ниво поле, като използвате свойството LocaleId, което получава или задава езиковата стойност на полето ID.

Следващият пример за код показва как да използвате тази опция:

Вмъкване На Непечатано / Празно Поле

Ако искате да вмъкнете непечатани / празни полета ({}) точно като Microsoft Word позволява, можете да използвате метода InsertField с параметъра FieldType.FieldNone. За да вмъкнете поле в документ Word, можете да натиснете клавишната комбинация " Цтрл + F9".

Следващият пример за код показва как да вмъкнете празно поле в документа:

Вмъкване на полета в документ с FieldBuilder

Алтернативният начин за вмъкване на полета в Aspose.Words е клас FieldBuilder. Той осигурява плавен интерфейс за задаване на превключватели на полета и стойности на аргументите като текст, възли или дори вложени полета.

Следващият пример за код показва как да вмъкнете поле в документ, като използвате FieldBuilder:

Вмъкване на полета с DOM

Можете също да вмъквате различни типове полета, като използвате Aspose.Words Документ Обектен Модел (DOM). В този раздел ще разгледаме няколко примера.

Вмъкване на поле за обединяване в документ с DOM

Полето MERGEFIELD в документа Word може да бъде представено от класа FieldMergeField. Можете да използвате клас FieldMergeField, За да изпълните следните операции::

  • задайте името на полето за обединяване
  • задаване на форматирането на полето за обединяване
  • задайте текста, който е между разделителя на полета и края на полето за обединяване
  • задайте текста, който да бъде вмъкнат след полето за обединяване, ако полето не е празно
  • задайте текста, който да бъде вмъкнат преди полето за обединяване, ако полето не е празно

Следващият пример за код показва как да добавите полето MERGE, като използвате DOM към абзац в документ:

Вмъкване на поле Mail Merge адресен блок в документ с DOM

Полето ADDRESSBLOCK се използва за вмъкване на адресен блок Mail Merge в документ Word. ADDRESSBLOCK полето в документа Word може да бъде представено от класа FieldAddressBlock. Можете да използвате клас FieldAddressBlock, За да изпълните следните операции::

  • задайте дали да включите името на страната/региона в полето
  • посочете дали да форматирате адреса според държавата/региона на получателя, както е определен от POST*CODE (всемирен Пощенски Съюз 2006 г.)
  • посочете името на изключената страна/регион
  • посочете формата на името и адреса
  • посочете езика ID, използван за форматиране на адреса

Следващият пример за код показва как да добавите полето Mail Merge ADDRESSBLOCK, като използвате DOM към абзац в документ:

Вмъкване на предварително поле в документ без използване на DocumentBuilder

Полето ADVANCE се използва за изместване на следващ текст в рамките на ред отляво, отдясно, нагоре или надолу. Полето ADVANCE в документа Word може да бъде представено от класа FieldAdvance. Можете да използвате клас FieldAdvance, За да изпълните следните операции:

  • посочете броя на точките, с които текстът, който следва полето, трябва да бъде преместен вертикално от горния край на страницата
  • задайте броя на точките, с които текстът, който следва полето, трябва да бъде преместен хоризонтално от левия край на колоната, рамката или текстовото поле
  • посочете броя на точките, с които текстът, който следва полето, трябва да бъде преместен наляво, надясно, нагоре или надолу

Следващият пример за код показва как да добавите полето ADVANCE, като използвате DOM към абзац в документ:

Вмъкване на поле ASK в документ без използване на DocumentBuilder

Полето ASK се използва, за да подканва потребителя за текст, който да присвои на отметка в документ Word. ASK полето в документа Word може да бъде представено от класа FieldAsk. Можете да използвате клас FieldAsk, За да изпълните следните операции::

  • посочете името на отметката
  • задаване на потребителски отговор по подразбиране (начална стойност, съдържаща се в прозореца на подкана)
  • посочете дали отговорът на потребителя трябва да бъде получен веднъж за операция Mail Merge
  • посочете текста на подканата (заглавието на прозореца на подканата)

Следващият пример за код показва как да добавите полето ASK, като използвате DOM към абзац в документ:

Вмъкване на поле AUTHOR в документ без използване на DocumentBuilder

Полето AUTHOR се използва за обозначаване на името на автора на документа от свойствата Document. Полето AUTHOR в документа Word може да бъде представено от класа FieldAuthor. Можете да използвате клас FieldAuthor, За да изпълните следните операции::

  • посочете името на автора на документа

Следващият пример за код показва как да добавите полето AUTHOR, като използвате DOM към абзац в документ:

Вмъкване на поле INCLUDETEXT в документ без използване на DocumentBuilder

Полето INCLUDETEXT вмъква текста и графиките, съдържащи се в документа, посочен в кода на полето. Можете да вмъкнете целия документ или част от документа, посочен с отметка. Това поле в документа Word е представено от INCLUDETEXT. Можете да използвате клас FieldIncludeText, за да изпълните следните операции::

  • посочете името на отметката на включения документ
  • посочете местоположението на документа

Следващият пример за код показва как да добавите полето INCLUDETEXT, като използвате DOM към абзац в документ:

Вмъкване на поле TOA в документ без използване на DocumentBuilder

Полето TOA (Table of Authorities) изгражда и вмъква таблица на властите. В полето TOA се събират записи, отбелязани с TA (Table of Authorities Entry) полета. Microsoft офис Word вмъква полето TOA, когато щракнете върху Insert Table of Authorities в групата Table of Authorities в раздела References. Когато видите полето TOA във вашия документ, синтаксисът изглежда така:

{ TOA [Switches ] }

Следващият пример за код показва как да добавите полето TOA, като използвате DOM към абзац в документ:

/

Преглед на полетата в C++ Как да намерите свойства на полето