Вмъкване на полета
Има няколко различни начина за вмъкване на полета в документ:
- използване DocumentBuilder
- използване FieldBuilder
- използване Aspose.Words Document Object Model (DOM)
В тази статия ще разгледаме по-подробно всеки начин и ще анализираме как да вмъкнем определени полета, използвайки тези опции.
Вмъкване на полета в документ с помощта на Document Builder
В Aspose.Words на InsertField метод се използва за въвеждане на нови полета в документ. Първият параметър приема да бъде поставен пълният код на полето. Вторият параметър е незадължителен и позволява ръчно да се зададе резултатът от полето. Ако това не е доставено, полето се актуализира автоматично. Можете да преминете нула или празно към този параметър, за да въведете поле с празна стойност на полето. Ако не сте сигурни за конкретния код синтаксис, създайте полето в Microsoft Word Първо превключи, за да видиш кода на полето.
Следният пример за код показва как да се вмъкне поле за сливане в документ, като се използва DocumentBuilder:
Същата техника се използва за вмъкване на полета в други полета.
Следният пример за код показва как да вмъкнете полета в друго поле, като използвате DocumentBuilder:
Посочване на местоположението на ниво поле
Езиковият идентификатор е стандартно международно цифрово съкращение за езика в държава или географски регион. С Aspose.Words, Можете да посочите Locale на нивото на полето с помощта на LocaleId имот, който получава или определя местоположението на полето.
Следният пример за код показва как да използвате тази опция:
Вмъкване на нетипично/специфично поле
Ако искате да въведете нетипизирани/празни полета ({}) Точно като Microsoft Word позволява, можете да използвате InsertField метод с FieldType.FieldNone параметър. За да вмъкнете поле в Word документ, можете да натиснете Ctrl + F9.
Следният пример за код показва как да се постави празно поле в документа:
Вмъкване COMPARE
Поле
На COMPARE
полето сравнява две стойности и връща числовата стойност 1, ако сравнението е true или 0, ако сравнението е false.
Следният пример с код показва как да добавите COMPARE
полета, използващи DocumentBuilder:
Вмъкване IF
Поле
На IF
полето може да се използва за оценка на аргументите условно.
Следният пример с код показва как да добавите IF
полета, използващи DocumentBuilder:
Вмъкване на полета в документ с помощта на 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)
- посочете името на страната/региона
- посочете името и формата на адреса
- посочете езика ID, използван за форматиране на адреса
Следният пример с код показва как да добавите Mail Merge ADDRESSBLOCK
Използване на поле DOM към параграф в документ:
Вмъкване ADVANCE
поле в документ без използване на DocumentBuilder
На ADVANCE
полето се използва за компенсиране на последващия текст в линия наляво, надясно, нагоре или надолу. ADVANCE
полето в документа на Word може да бъде представено от FieldAdvance Клас. Можеш да използваш FieldAdvance клас за извършване на следните операции:
- посочете броя на точките, с които текстът, който следва полето трябва да се премества вертикално от горния край на страницата
- посочете броя на точките, с които текстът, който следва полето трябва да се премества хоризонтално от левия край на колоната, рамката или текстовата кутия
- посочете броя на точките, с които текстът, който следва полето, трябва да се премести наляво, надясно, нагоре или надолу
Следният пример с код показва как да добавите ADVANCE
Използване на поле DOM към параграф в документ:
Вмъкване ASK
поле в документ без използване на DocumentBuilder
На ASK
полето се използва за подканване на потребителя за текст за присвояване на отметка в Word документ. ASK
полето в документа на Word може да бъде представено от FieldAsk Клас. Можеш да използваш FieldAsk клас за извършване на следните операции:
- посочете името на отметките
- посочете отговора на потребителя по подразбиране (първоначална стойност, съдържаща се в бързия прозорец)
- посочете дали потребителският отговор трябва да се получи веднъж на a mail merge експлоатация
- да се посочи бърз текст (титуляр на бърз прозорец)
Следният пример с код показва как да добавите ASK
Използване на поле DOM към параграф в документ:
Вмъкване AUTHOR
поле в документ без използване на DocumentBuilder
На AUTHOR
поле се използва за определяне на името на автора на документа от Document
имоти. AUTHOR
полето в документа на Word може да бъде представено от FieldAuthor Клас. Можеш да използваш FieldAuthor клас за извършване на следните операции:
- посочете името на автора на документа
Следният пример с код показва как да добавите AUTHOR
Използване на поле DOM към параграф в документ:
Вмъкване INCLUDETEXT
поле в документ без използване на DocumentBuilder
На INCLUDETEXT
полето вмъква текста и графиките, съдържащи се в документа, посочен в кода на полето. Можете да поставите целия документ или част от документа, посочен с отметки. Тази област в Word документ е представена от ВКЛЮЧИТЕЛНО ЕТЕКСТ. Можеш да използваш FieldIncludeText клас за извършване на следните операции:
- посочете името на отметките на включения документ
- посочете местоположението на документа
Следният пример с код показва как да добавите INCLUDETEXT
поле за използване DOM към параграф в документ:
Вмъкване TOA
поле в документ без използване на DocumentBuilder
На TOA
(Таблица на органите) полето изгражда и вмъква таблица от органи. На TOA
поле събира записи, маркирани с TA
(Таблица на органите за влизане) полета. Microsoft Office Word вмъква TOA
поле, когато кликнете * Таблица на органите група на References Сметка. Когато видите TOA
В този документ синтаксисът изглежда така:
{ TOA
[Switches ] }
Следният пример с код показва как да добавите TOA
поле за използване DOM на параграф в документ.