Вмъкване и добавяне на документи

Понякога е необходимо да се комбинират няколко документа в един. Можете да направите това ръчно или можете да използвате Aspose.Words вмъкване или добавяне на функция.

Операцията за вмъкване ви позволява да въведете съдържанието на предварително създадените документи в нов или съществуващ.

От своя страна, функцията за добавяне ви позволява да добавяте документ само в края на друг документ.

Тази статия обяснява как да се вмъкне или да се добави документ към друг по различни начини и описва общите свойства, които можете да приложите, докато вмъквате или добавяте документи.

Вмъкване на документ

Както бе споменато по- горе, в Aspose.Words документ е представен като дърво от възли, а действието на поставянето на един документ в друг е копиране на възли от първото дърво на документа до второто.

Можете да поставите документи по различни начини. Например, можете да поставите документ чрез замяна операция, сливане поле по време на сливане операция, или чрез отметки.

Можете също така да използвате insert_document или insert_document_inline метод, който е подобен на въвеждането на документ в Microsoft Word, да се въведе цял документ в текущата позиция на курсора без никакъв предишен внос.

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

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

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

Вмъкване на документ в отметките

Можете да импортирате текстов файл в документ и да го поставите веднага след отметките, които сте определили в документа. За да направите това, създайте отметки, където искате да бъде поставен документът.

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

Имайте предвид, че отметките не трябва да съдържат няколко абзаца или текст, които искате да бъдат включени във Вашия окончателен резултатен документ.

Добавяне на документ

Може да имате случай на използване, когато трябва да включите допълнителни страници от документ до края на съществуващ документ. За да направите това, просто трябва да се обадите на append_document метод за добавяне на документ към края на друг.

Имайте предвид, че append_child е метод на ниво възел в рамките на документ. Например, можете да създадете параграф, да зададете форматиращи свойства, и след това да го добавите като дете към тялото с помощта на append_child метод.

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

Импортиране и въвеждане на възли ръчно

Aspose.Words позволява автоматично въвеждане и добавяне на документи без никакви предишни изисквания за внос. Въпреки това, ако трябва да въведете или да добавите конкретен възел на вашия документ, като например раздел или параграф, тогава първо трябва да внесете този възел ръчно.

Когато трябва да вмъкнете или да добавите един раздел или параграф в друг, по същество трябва да внесете възлите на първото дърво на документния възел във втория с помощта на import_node метод. След внос на възлите, трябва да използвате insert_after / insert_before метод за поставяне на нов възел след/преди референтния възел. Това ви позволява да персонализирате процеса на вмъкване чрез внос на възли от документ и поставянето му на дадени позиции.

Можете също така да използвате append_child метод за добавяне на нов определен възел към края на списъка на възлите на деца, например, ако искате да добавите съдържание на ниво параграф вместо на ниво раздел.

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

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

Съдържание се внася в раздела по раздел на документа на местоназначението, което означава, че настройките, като например настройка на страниците, заглавни части или подметки, се запазват по време на вноса. Също така е полезно да се отбележи, че можете да дефинирате настройките за форматиране, когато вкарвате или добавяте документ, за да уточните как се свързват два документа.

Общи свойства за вмъкване и добавяне на документи

И двете. insert_document както и append_document методите се приемат ImportFormatMode както и ImportFormatOptions като входящи параметри. На ImportFormatMode позволява да контролирате как се слива форматирането на документи, когато внасяте съдържание от един документ в друг, като избирате различни режими на форматиране като USE_DESTINATION_STYLES, KEEP_SOURCE_FORMATTING, както и KEEP_DIFFERENT_STYLES. На ImportFormatOptions ви позволява да изберете различни опции за внос като ignore_header_footer, ignore_text_boxes, keep_source_numbering, merge_pasted_lists, както и smart_style_behavior.

Aspose.Words ви позволява да коригирате визуализацията на получения документ, когато два документа се добавят заедно в дадена вложка или операция, като използвате Section както и PageSetup. На page_setup имот съдържа всички атрибути на раздел като section_start restart_page_numbering, page_starting_number, orientation, и други. Най- често използваният случай е да се определи section_start свойство за определяне дали добавеното съдържание ще се появи на същата страница или ще се раздели на нова.

Имайте предвид, че Section както и PageSetup не се контролира как два документа се добавят/прилагат заедно. Позволяват ви само да променяте външния вид на документа с резултатите.

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