Wstaw i dołącz dokumenty

Czasami wymagane jest połączenie kilku dokumentów w jeden. Możesz to zrobić ręcznie lub możesz użyć funkcji wstawiania lub dołączania Aspose.Words.

Operacja wstawiania umożliwia wstawienie treści wcześniej utworzonych dokumentów do nowego lub istniejącego.

Z kolei funkcja dołączania pozwala na dodanie dokumentu dopiero na końcu innego dokumentu.

W tym artykule wyjaśniono, jak wstawić lub dołączyć dokument do innego na różne sposoby i opisano typowe właściwości, które można zastosować podczas wstawiania lub dołączania dokumentów.

Wstaw dokument

Jak wspomniano powyżej, w Aspose.Words dokument jest reprezentowany jako drzewo węzłów, a operacja wstawienia jednego dokumentu do drugiego polega na skopiowaniu węzłów z pierwszego drzewa dokumentu do drugiego.

Dokumenty można wstawiać w różnych lokalizacjach na różne sposoby. Można na przykład wstawić dokument poprzez operację zamiany, pole scalania podczas operacji scalania lub poprzez zakładkę.

Możesz także użyć metody insert_document lub insert_document_inline, która jest podobna do wstawiania dokumentu w formacie Microsoft Word, aby wstawić cały dokument w bieżącej pozycji kursora bez wcześniejszego importowania.

Poniższy przykład kodu pokazuje, jak wstawić dokument przy użyciu metody wstaw_dokument:

Poniższy przykład kodu pokazuje, jak wstawić dokument przy użyciu metody wstaw_dokument_w wierszu:

W poniższych podrozdziałach opisano możliwości wstawiania jednego dokumentu do drugiego.

Wstaw dokument w zakładce

Możesz zaimportować plik tekstowy do dokumentu i wstawić go zaraz za zakładką zdefiniowaną w dokumencie. Aby to zrobić, utwórz zakładkę akapitu, w którym chcesz wstawić dokument.

Poniższy przykład kodowania pokazuje, jak wstawić zawartość jednego dokumentu do zakładki w innym dokumencie:

Pamiętaj, że zakładka nie powinna zawierać wielu akapitów ani tekstu, który ma się pojawić w ostatecznym dokumencie wynikowym.

Dołącz dokument

Może się zdarzyć, że zajdzie potrzeba dołączenia dodatkowych stron z dokumentu na końcu istniejącego dokumentu. Aby to zrobić, wystarczy wywołać metodę append_document, aby dodać dokument na końcu innego.

Należy pamiętać, że append_child jest metodą na poziomie węzła w dokumencie. Można na przykład utworzyć akapit, ustawić właściwości formatowania, a następnie dołączyć go jako element podrzędny do treści, korzystając z metody append_child.

Poniższy przykład kodu pokazuje, jak dołączyć dokument na końcu innego dokumentu:

Importuj i wstawiaj węzły ręcznie

Aspose.Words umożliwia automatyczne wstawianie i dołączanie dokumentów bez konieczności wcześniejszego importowania. Jeśli jednak chcesz wstawić lub dołączyć określony węzeł dokumentu, na przykład sekcję lub akapit, musisz najpierw ręcznie zaimportować ten węzeł.

Kiedy chcesz wstawić lub dołączyć jedną sekcję lub akapit do drugiej, zasadniczo musisz zaimportować węzły pierwszego drzewa węzłów dokumentu do drugiego przy użyciu metody import_node. Po zaimportowaniu węzłów należy użyć metody insert_after/insert_before, aby wstawić nowy węzeł za/przed węzłem referencyjnym. Pozwala to dostosować proces wstawiania poprzez import węzłów z dokumentu i wstawianie ich w określonych pozycjach.

Możesz także użyć metody append_child, aby dodać nowy określony węzeł na końcu listy węzłów podrzędnych, na przykład jeśli chcesz dołączyć treść na poziomie akapitu, a nie sekcji.

Poniższy przykład kodu pokazuje, jak ręcznie importować węzły i wstawiać je po określonym węźle przy użyciu metody insert_after:

Import tworzy nowy węzeł będący kopią węzła pierwotnego i nadający się do wstawienia do dokumentu docelowego.

Treść jest importowana do dokumentu docelowego sekcja po sekcji, co oznacza, że ustawienia, takie jak ustawienia strony oraz nagłówki i stopki, zostaną zachowane podczas importu. Warto również pamiętać, że podczas wstawiania lub dołączania dokumentu można zdefiniować ustawienia formatowania, aby określić sposób łączenia dwóch dokumentów.

Wspólne właściwości wstawiania i dołączania dokumentów

Obie metody insert_document i append_document akceptują ImportFormatMode i ImportFormatOptions jako parametry wejściowe. Plik ImportFormatMode pozwala kontrolować sposób łączenia formatowania dokumentu podczas importowania treści z jednego dokumentu do drugiego, wybierając różne tryby formatu, takie jak USE_DESTINATION_STYLES, KEEP_SOURCE_FORMATTING i KEEP_DIFFERENT_STYLES. ImportFormatOptions umożliwia wybranie różnych opcji importu, takich jak ignore_header_footer, ignore_text_boxes, keep_source_numbering, merge_pasted_lists i smart_style_behavior.

Aspose.Words umożliwia dostosowanie wizualizacji dokumentu wynikowego po dodaniu dwóch dokumentów podczas operacji wstawiania lub dołączania przy użyciu formatów Section i PageSetup. Właściwość page_setup zawiera wszystkie atrybuty sekcji, takie jak section_start, restart_page_numbering, page_starting_number, orientation i inne. Najczęstszym przypadkiem użycia jest ustawienie właściwości section_start w celu określenia, czy dodana treść pojawi się na tej samej stronie, czy zostanie podzielona na nową.

Należy pamiętać, że Section i PageSetup nie kontrolują sposobu wstawiania/dołączenia dwóch dokumentów. Pozwalają jedynie na zmianę wyglądu dokumentu wynikowego.

Poniższy przykład kodu pokazuje, jak dołączyć jeden dokument do drugiego, jednocześnie zapobiegając podziałowi treści na dwie strony: