Документи

Іноді необхідно об’єднати кілька документів в одну. Ви можете зробити це вручну або ви можете використовувати 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 майно містить всі атрибути розділу, такі як <span notrans="<span notrans=" section_start"="">, > restart_page_numbering, page_starting_number, orientation, та інші. Найпоширеніший випадок використання - встановити section_start властивість визначити, чи з’явиться доданий контент на одній сторінці або розбитись на нову.

Зверніть увагу, що Section і PageSetup не контролює, як вставляється два документи. Вони тільки дозволяють змінити зовнішній вигляд документа.

Приклад коду показує, як застосувати один документ на інший, зберігаючи вміст від розщеплення через дві сторінки: