K vložení prvků dokumentu použijte DocumentBuilder

DocumentBuilder se používá k úpravě dokumentů. Tento článek vysvětluje a popisuje, jak provádět řadu úkolů:

Vložení řetězce textu

Jednoduše předejte řetězec textu, který potřebujete vložit do dokumentu, metodě DocumentBuilder.Write. Formátování textu je určeno vlastností Font. Tento objekt obsahuje různé atributy písma (název písma, velikost písma, barvu atd.). Některé důležité atributy písma jsou také reprezentovány vlastnostmi DocumentBuilder, které vám umožňují přímý přístup k nim. Jedná se o Booleovské vlastnosti Font.Bold, Font.Italic a Font.Underline.

Formátování znaků, které nastavíte, se bude vztahovat na veškerý text vložený z aktuální pozice v dokumentu dále.

Níže uvedený příklad vloží formátovaný text pomocí DocumentBuilder.

Vložení odstavce

DocumentBuilder.Writeln vloží do dokumentu také řetězec textu, ale navíc přidá konec odstavce. Aktuální formátování písma je také určeno vlastností DocumentBuilder.Font a aktuální formátování odstavce je určeno vlastností DocumentBuilder.ParagraphFormat. Níže uvedený příklad ukazuje, jak vložit odstavec do dokumentu.

Vložení tabulky

Základní algoritmus pro vytvoření tabulky pomocí DocumentBuilder je jednoduchý:

1. Začněte tabulku pomocí DocumentBuilder.StartTable.
2. Vložte buňku pomocí DocumentBuilder.InsertCell. Tím se automaticky spustí nový řádek. V případě potřeby použijte vlastnost DocumentBuilder.CellFormat k určení formátování buněk.
3. Vložte obsah buňky pomocí metod DocumentBuilder.
4. Opakujte kroky 2 a 3, dokud není řádek dokončen.
5. Volání DocumentBuilder.EndRow pro ukončení aktuálního řádku. V případě potřeby použijte vlastnost DocumentBuilder.RowFormat k určení formátování řádků.
6. Opakujte kroky 2-5, dokud není tabulka kompletní.
7. Zavolejte DocumentBuilder.EndTable a dokončete stavbu stolu. Příslušné metody vytváření tabulek DocumentBuilder jsou popsány níže.

Spuštění tabulky

Volání DocumentBuilder.StartTable je prvním krokem při vytváření tabulky. Lze jej také nazvat uvnitř buňky, v takovém případě spustí vnořenou tabulku. Další způsob volání je DocumentBuilder.InsertCell.

Vložení buňky

Po volání DocumentBuilder->InsertCell se vytvoří nová buňka a veškerý obsah, který přidáte pomocí jiných metod třídy DocumentBuilder, bude přidán do aktuální buňky. Chcete-li spustit novou buňku ve stejném řádku, zavolejte znovu DocumentBuilder->InsertCell. K určení formátování buňky použijte vlastnost DocumentBuilder.CellFormat. Vrátí objekt CellFormat, který představuje veškeré formátování buňky tabulky.

Ukončení řádku

Zavolejte DocumentBuilder.EndRow a dokončete aktuální řádek. Pokud zavoláte DocumentBuilder->InsertCell ihned poté, pak tabulka pokračuje na novém řádku.

K určení formátování řádků použijte vlastnost DocumentBuilder.RowFormat. Vrátí objekt RowFormat, který představuje veškeré formátování pro řádek tabulky.

Ukončení stolu

Zavolejte DocumentBuilder.EndTable a dokončete aktuální tabulku. Tato metoda by měla být volána pouze jednou po volání DocumentBuilder->EndRow. Při volání DocumentBuilder.EndTable přesune kurzor z aktuální buňky na pozici těsně za tabulkou. Následující příklad ukazuje, jak vytvořit formátovanou tabulku, která obsahuje 2 řádky a 2 sloupce.

Vložení přestávky

Pokud chcete explicitně začít nový řádek, odstavec, sloupec, oddíl nebo stránku, zavolejte DocumentBuilder.InsertBreak. Předejte této metodě Typ přestávky, kterou potřebujete vložit, který je reprezentován výčtem BreakType. Níže uvedený příklad ukazuje, jak vložit konce stránek do dokumentu.

Vložení obrázku

DocumentBuilder poskytuje několik přetížení metody DocumentBuilder->InsertImage, která umožňuje vložit vložený nebo plovoucí obrázek. Pokud je obrázek metasoubor EMF nebo WMF, bude do dokumentu vložen ve formátu metasouboru. Všechny ostatní obrázky budou uloženy ve formátu PNG. Metoda DocumentBuilder->InsertImage může používat obrázky z různých zdrojů:

• Ze souboru nebo URL předáním parametru řetězce DocumentBuilder->InsertImage.
• Z proudu předáním parametru Stream DocumentBuilder->InsertImage.
• Z obrazového objektu předáním parametru obrázku DocumentBuilder->InsertImage.
• Z bajtového pole předáním parametru bajtového pole DocumentBuilder.InsertImage.Pro každou z metod DocumentBuilder->InsertImage existují další přetížení, která vám umožní vložit obrázek s následujícími možnostmi:
• Inline nebo plovoucí na konkrétní pozici, například DocumentBuilder->InsertImage.
• Procentuální měřítko nebo vlastní velikost, například DocumentBuilder.InsertImage. Metoda DocumentBuilder->InsertImage navíc vrací objekt Shape, který byl právě vytvořen a vložen, takže můžete dále upravovat vlastnosti tvaru.

Vložení vloženého obrázku

Předáním jednoho řetězce představujícího soubor, který obsahuje obrázek, DocumentBuilder->InsertImage vložte obrázek do dokumentu jako vloženou grafiku. Níže uvedený příklad ukazuje, jak vložit vložený obrázek na pozici kurzoru do dokumentu.

Vložení plovoucího (absolutně umístěného) obrázku

Tento příklad vloží plovoucí obrázek ze souboru nebo URL na zadanou pozici a velikost.

Vložení záložky

Chcete-li do dokumentu vložit záložku, postupujte takto:

1. Zavolejte DocumentBuilder->StartBookmark předáním požadovaného názvu záložky.
2. Vložte text záložky pomocí metod DocumentBuilder.
3. Zavolejte DocumentBuilder.EndBookmark a předejte mu stejný název, jaký jste použili s DocumentBuilder->StartBookmark.
4. Záložky se mohou překrývat a pokrývat jakýkoli rozsah. Chcete-li vytvořit platnou záložku, musíte zavolat DocumentBuilder->StartBookmark i DocumentBuilder->EndBookmark se stejným názvem záložky.

Špatně vytvořené záložky nebo záložky s duplicitními názvy budou při uložení dokumentu ignorovány.

Níže uvedený příklad ukazuje, jak vložit záložku do dokumentu pomocí nástroje pro tvorbu dokumentů.

Vložení pole Form

Pole formuláře jsou konkrétním případem polí Word, která umožňují “interakci” s uživatelem. Pole formuláře v Microsoft Word zahrnují textové pole, pole se seznamem a checkbox.DocumentBuilder poskytuje speciální metody pro vložení každého typu pole formuláře do dokumentu: DocumentBuilder.InsertTextInput, DocumentBuilder->InsertCheckBox a DocumentBuilder.InsertComboBox. Všimněte si, že pokud zadáte název pole formuláře, automaticky se vytvoří záložka se stejným názvem.

Vkládání textu

DocumentBuilder.InsertTextInput pro vložení textového pole do dokumentu. Níže uvedený příklad ukazuje, jak vložit pole formuláře pro zadávání textu do dokumentu.

Vložení zaškrtávacího políčka

Zavolejte DocumentBuilder.InsertCheckBox a vložte checkbox do dokumentu. Níže uvedený příklad ukazuje, jak vložit pole formuláře checkbox do dokumentu.

Vložení pole se seznamem

Zavolejte DocumentBuilder.InsertComboBox a vložte do dokumentu pole se seznamem. Níže uvedený příklad ukazuje, jak vložit pole formuláře se seznamem do dokumentu.

Vložení národního prostředí na úrovni pole

Zákazníci mohou nyní určit národní prostředí na úrovni pole a mohou dosáhnout lepší kontroly. ID národního prostředí lze přiřadit ke každému poli uvnitř DocumentBuilder. Níže uvedené příklady ilustrují, jak tuto možnost využít.

Vložení hypertextového odkazu

Pomocí DocumentBuilder.InsertHyperlink vložte hypertextový odkaz do dokumentu. Tato metoda přijímá tři parametry: text odkazu, který se má zobrazit v dokumentu, cíl odkazu (URL nebo název záložky uvnitř dokumentu) a booleovský parametr, který by měl být pravdivý, pokud URL je název záložky uvnitř dokumentu.DocumentBuilder.InsertHyperlink interně volá DocumentBuilder.InsertField.Metoda vždy přidává apostrofy na začátek a konec URL. Všimněte si, že musíte zadat formátování písma pro text zobrazení hypertextového odkazu explicitně pomocí vlastnosti Font. Níže uvedený příklad vloží hypertextový odkaz do dokumentu pomocí DocumentBuilder.

Vložení Ole Objektu

Pokud chcete Ole objekt volání DocumentBuilder.InsertOleObject. Předejte této metodě ProgId explicitně s dalšími parametry. Níže uvedený příklad ukazuje, jak vložit objekt Ole do dokumentu.

Při vkládání Ole objektu Nastavte název souboru a příponu

OLE package je starší a" nezdokumentovaný " způsob uložení vloženého objektu, pokud není známa obslužná rutina OLE. Rané verze Windows, jako jsou Windows 3.1, 95 a 98, měly aplikaci Packager.exe, kterou lze použít k vložení jakéhokoli typu dat do dokumentu. Nyní je tato aplikace vyloučena z Windows, ale MS Word a další aplikace ji stále používají k vložení dat, pokud OLE handler chybí nebo není znám. Třída OlePackage umožňuje přístup k vlastnostem OLE Package. Níže uvedený příklad ukazuje, jak nastavit název souboru, příponu a zobrazovaný název pro OLE Package.

Vložení HTML

Do dokumentu Word můžete snadno vložit řetězec HTML, který obsahuje fragment HTML nebo celý dokument HTML. Stačí předat tento řetězec metodě DocumentBuilder->InsertHtml. Jednou z užitečných implementací metody je uložení řetězce HTML do databáze a jeho vložení do dokumentu během Mail Merge, aby se formátovaný obsah přidal místo vytváření pomocí různých metod tvůrce dokumentů. Níže uvedený příklad ukazuje vložení HTML do dokumentu pomocí DocumentBuilder.

Vložení vodorovného Pravidla do dokumentu

Příklad Below code ukazuje, jak vložit vodorovný tvar pravidla do dokumentu pomocí metody DocumentBuilder->InsertHorizontalRule.