Přidání ovládacích prvků Záložka do wordových dokumentů

V projektech na úrovni dokumentu můžete do dokumentu v projektu přidat Bookmark ovládací prvky v době návrhu nebo v době běhu. V projektech doplňků VSTO můžete přidat Bookmark ovládací prvky do libovolného otevřeného dokumentu za běhu.

Platí pro: Informace v tomto tématu platí pro projekty na úrovni dokumentu a projekty doplňků VSTO pro Word. Další informace naleznete v tématu Funkce dostupné aplikace Office lication a typu projektu.

Toto téma popisuje následující úlohy:

Přidání ovládacích prvků záložky v době návrhu

Existuje několik způsobů, jak přidat Bookmark ovládací prvky do dokumentu v projektu na úrovni dokumentu v době návrhu:

  • Ze sady nástrojů sady Visual Studio.

    Ovládací prvek můžete přetáhnout Bookmark ze sady nástrojů do dokumentu. Pokud už panel nástrojů používáte k přidání ovládacích prvků model Windows Forms do dokumentu, můžete zvolit tento způsob.

  • Z Wordu.

    Ovládací prvek můžete do dokumentu přidat Bookmark stejným způsobem jako nativní záložku. Výhodou jeho přidání je, že ovládací prvek můžete pojmenovat v době, kdy ho vytvoříte.

  • V okně Zdroje dat.

    Ovládací prvek můžete přetáhnout Bookmark do dokumentu z okna Zdroje dat. To je užitečné, když chcete ovládací prvek svázat s daty najednou. Ovládací prvek hostitele můžete přidat stejným způsobem jako ovládací prvek Windows Form z okna Zdroje dat. Další informace najdete v tématu Datové vazby a model Windows Forms.

    Poznámka:

    Váš počítač může v následujících pokynech zobrazovat odlišné názvy nebo umístění některých prvků uživatelského rozhraní sady Visual Studio. Tyto prvky jsou určeny edicí sady Visual Studio a použitým nastavením. Další informace naleznete v tématu Přizpůsobení integrovaného vývojového prostředí (IDE).

Přidání ovládacího prvku Záložka do dokumentu ze sady nástrojů

  1. Otevřete panel nástrojů a klikněte na kartu Ovládací prvky aplikace Word.

  2. Bookmark Přetáhněte ovládací prvek do dokumentu.

    Zobrazí se dialogové okno Přidat záložku .

  3. Vyberte text nebo jiné položky, které chcete do záložky zahrnout.

  4. Klikněte na OK.

    Pokud nechcete zachovat výchozí název záložky, můžete název změnit v okně Vlastnosti .

Přidání ovládacího prvku Záložka do dokumentu ve Wordu

  1. V dokumentu, který je hostovaný v návrháři sady Visual Studio, umístěte kurzor na místo, kam chcete přidat záložku, nebo vyberte text, který má záložka uzavřít.

  2. Na kartě Vložení na pásu karet klikněte ve skupině Odkazy na tlačítko Záložka.

  3. V dialogovém okně Záložka zadejte název nové záložky a klepněte na tlačítko Přidat.

Přidání ovládacích prvků záložky za běhu v projektu na úrovni dokumentu

Ovládací prvky můžete do dokumentu přidat Bookmark programově pomocí metod Controls vlastnosti ThisDocument třídy v projektu. Existují dvě přetížení metod, které můžete použít k přidání Bookmark ovládacího prvku následujícími způsoby:

Přidání ovládacího prvku Záložka do dokumentu prostřednictvím kódu programu

  1. ThisDocument_Startup Do obslužné rutiny události v projektu vložte následující kód pro přidání Bookmark ovládacího prvku do prvního odstavce v dokumentu.

    Microsoft.Office.Tools.Word.Bookmark firstParagraph;
    firstParagraph = this.Controls.AddBookmark(this.Paragraphs[1].Range,
        "FirstParagraph");
    

    Poznámka:

    Pokud chcete vytvořit Bookmark ovládací prvek z existujícího Bookmark, použijte metodu AddBookmark a předejte existující Bookmark.

Přidání ovládacích prvků záložky za běhu v projektu doplňku VSTO

Ovládací prvky můžete přidat Bookmark programově do libovolného otevřeného dokumentu za běhu pomocí doplňku VSTO. Uděláte to tak, že vygenerujete Document položku hostitele založenou na otevřeném dokumentu a pak použijete metody Controls vlastnosti této položky hostitele. Existují dvě přetížení metod, které můžete použít k přidání Bookmark ovládacího prvku následujícími způsoby:

Přidání ovládacího prvku Záložka v zadaném rozsahu

  1. Použijte metodu AddBookmark a předejte Range místo, kam chcete přidat Bookmark.

    Následující příklad kódu přidá nový Bookmark na začátek aktivního dokumentu. Pokud chcete tento příklad použít, spusťte kód z ThisAddIn_Startup obslužné rutiny události v projektu doplňku Word VSTO.

    Document extendedDocument = Globals.Factory.GetVstoObject(this.Application.ActiveDocument);
    
    
    Bookmark firstParagraph = extendedDocument.Controls.AddBookmark(
        extendedDocument.Paragraphs[1].Range, "FirstParagraph");
    

Přidání ovládacího prvku Záložka, který je založený na nativním ovládacím prvku Bookmark

  1. Použijte metodu AddBookmark a předejte stávající Bookmark , kterou chcete použít jako základ pro nový Bookmark.

    Následující příklad kódu vytvoří nový Bookmark , který je založen na prvním Bookmark v aktivním dokumentu. Pokud chcete tento příklad použít, spusťte kód z ThisAddIn_Startup obslužné rutiny události v projektu doplňku Word VSTO.

    if (this.Application.ActiveDocument.Bookmarks.Count > 0)
    {
        object index = 1;
        Word.Bookmark firstBookmark = this.Application.ActiveDocument.Bookmarks.get_Item(ref index);
    
    
         Document extendedDocument = Globals.Factory.GetVstoObject(this.Application.ActiveDocument);
    
        Bookmark vstoBookmark = extendedDocument.Controls.AddBookmark(
                firstBookmark, "VSTOBookmark");
    }