Vložit a doplnit dokumenty

Někdy je třeba kombinovat několik dokumentů do jednoho. Můžete to udělat ručně nebo můžete použít Aspose.Words vložit nebo přidat funkci.

Operace vložení umožňuje vložení obsahu dříve vytvořených dokumentů do nového nebo stávajícího dokumentu.

Funkce Append vám pak umožní přidat dokument pouze na konci jiného dokumentu.

Tento článek vysvětluje, jak vložit nebo přidat dokument k jinému jiným způsobem a popisuje společné vlastnosti, které můžete použít při vkládání nebo přidávání dokumentů.

Vložit dokument

Jak bylo uvedeno výše, Aspose.Words dokument je reprezentován jako strom uzlů a operace vložení jednoho dokumentu do druhého je kopírování uzlů od prvního stromu dokumentu do druhého.

Dokumenty můžete vkládat do různých míst různými způsoby. Například můžete dokument vložit prostřednictvím náhradní operace, pole sloučení během operace sloučení nebo prostřednictvím záložky.

Můžete také použít InsertDocument nebo InsertDocumentInline metoda, která je podobná vložení dokumentu do Microsoft Word, vložit celý dokument do aktuální polohy kurzoru bez předchozího importu.

Následující příklad kódu ukazuje, jak vložit dokument pomocí InsertDocument metoda:

Následující příklad kódu ukazuje, jak vložit dokument pomocí InsertDocumentInline metoda:

Následující pododdíly popisují možnosti, během kterých můžete vložit jeden dokument do druhého.

Vložit dokument během hledání a nahrazení operace

Můžete vložit dokumenty při provádění hledání a nahrazení operací. Například dokument může obsahovat odstavce s textem [PRODUKCE] a [CONCLUZE]. Ale v závěrečném dokumentu musíte tyto odstavce nahradit obsahem získaným z jiného vnějšího dokumentu. Abyste toho dosáhli, budete muset vytvořit spojku pro výměnu událostí.

Následující příklad kódu ukazuje, jak vytvořit manipulátor pro výměnu události použít později v procesu vložení:

Následující příklad kódu ukazuje, jak při hledání a nahrazení operace vložit obsah jednoho dokumentu do druhého:

Vložit dokument během Mail Merge Činnost

Můžete vložit dokument do pole sloučení během Mail Merge operace. Například: Mail Merge šablona může obsahovat pole sloučení jako např. [Summary]. Ale do konečného dokumentu musíte vložit obsah získaný z jiného externího dokumentu do tohoto pole sloučení. K dosažení tohoto cíle budete muset vytvořit spojku pro událost sloučení.

Následující příklad kódu ukazuje, jak vytvořit manipulátor pro fúzující událost k použití později v procesu vložení:

Následující příklad kódu ukazuje, jak vložit dokument do pole sloučení pomocí vytvořeného manipulátoru:

Vložit dokument do záložky

Můžete importovat textový soubor do dokumentu a vložit jej hned po záložce, kterou jste definovali v dokumentu. Chcete-li to udělat, vytvořte záložek odstavec, kde chcete dokument vložit.

Následující kódovací příklad ukazuje, jak vložit obsah jednoho dokumentu do záložky do jiného dokumentu:

Všimněte si, že záložka by neměla obsahovat více odstavců nebo textu, který chcete, aby se objevily ve vašem konečném výsledném dokumentu.

Přidání dokumentu

Můžete mít případ použití, kde potřebujete zahrnout další stránky z dokumentu do konce stávajícího dokumentu. K tomuhle stačí zavolat AppendDocument způsob přidání dokumentu na konec jiného.

Všimněte si, že AppendChild je metoda úrovně uzel v dokumentu. Například, můžete vytvořit odstavec, nastavit formátování vlastnosti, a pak jej jako dítě k tělu pomocí AppendChild metoda.

Následující příklad kódu ukazuje, jak připojit dokument ke konci jiného dokumentu:

Importovat a vložit uzly ručně

Aspose.Words umožňuje automaticky vkládat a přidávat dokumenty bez předchozích dovozních požadavků. Pokud však potřebujete vložit nebo přidat konkrétní uzel vašeho dokumentu, jako je sekce nebo odstavec, pak nejprve musíte importovat tento uzel ručně.

Pokud potřebujete vložit nebo připojit jeden oddíl nebo odstavec k druhému, musíte v podstatě importovat uzly prvního uzel dokumentu do druhého stromu pomocí ImportNode metoda. Po importu uzlů, musíte použít InsertAfter / InsertBefore metoda pro vložení nového uzlu po/před referenčním uzlem. To vám umožní přizpůsobit proces vkládání importem uzlů z dokumentu a vložením na dané pozice.

Můžete také použít AppendChild způsob, jak přidat nový zadaný uzel na konec seznamu dětských uzlů, například, pokud chcete přidat obsah na úrovni odstavce místo na úrovni sekce.

Následující příklad kódu ukazuje, jak ručně importovat uzly a vložit je po konkrétním uzlu pomocí InsertAfter metoda:

Import vytvoří nový uzel, který je kopií původního uzlu a vhodný pro vložení do cílového dokumentu.

Obsah je importován do sekce cílového dokumentu podle oddílu, což znamená, že nastavení, jako je nastavení stránek a hlavičky nebo zápatí, jsou zachována během importu. Je také užitečné poznamenat, že můžete definovat nastavení formátování, když vložíte nebo připojíte dokument, abyste určili, jak jsou dva dokumenty spojeny dohromady.

Společné vlastnosti pro vložení a doplnění dokumentů

Oba InsertDocument a AppendDocument metody přijatelné ImportFormatMode a ImportFormatOptions jako vstupní parametry. • ImportFormatMode umožňuje kontrolovat, jak je formátování dokumentů sloučeno při importu obsahu z jednoho dokumentu do jiného výběrem různých režimů formátu, jako je UseDestinationStyles, KeepSourceFormatting, a KeepDifferentStyles. • ImportFormatOptions umožňuje vybrat různé možnosti importu, jako je IgnoreHeaderFooter, IgnoreTextBoxes, KeepSourceNumbering, MergePastedLists, a SmartStyleBehavior.

Aspose.Words umožňuje nastavit vizualizaci výsledného dokumentu, když jsou dva dokumenty přidány dohromady v insertu nebo aplikaci pomocí Section a PageSetup vlastnosti. • PageSetup vlastnost obsahuje všechny atributy sekce, jako je SectionStart, RestartPageNumbering, PageStartingNumber, Orientation, a další. Nejčastějším případem použití je nastavení SectionStart vlastnost definovat, zda se přidaný obsah objeví na stejné stránce nebo se rozdělí na nový.

Všimněte si, že Section a PageSetup vlastnosti nekontrolují, jak jsou dva dokumenty vloženy/přidány společně. Umožňují vám pouze změnit vzhled vašeho výsledného dokumentu.

Následující příklad kódu ukazuje, jak připojit jeden dokument k druhému a zároveň udržet obsah od rozdělení na dvě strany: