Udostępnij za pośrednictwem


Dodawanie kontrolek zakładki do dokumentów programu Word

W projektach na poziomie dokumentu można dodawać Bookmark kontrolki do dokumentu w projekcie w czasie projektowania lub w czasie wykonywania. W projektach dodatków VSTO można dodawać Bookmark kontrolki do dowolnego otwartego dokumentu w czasie wykonywania.

Dotyczy: informacje w tym temacie dotyczą projektów na poziomie dokumentu i projektów dodatków VSTO dla programu Word. Aby uzyskać więcej informacji, zobacz Funkcje dostępne przez aplikacja pakietu Office lication i typ projektu.

W tym temacie opisano następujące zadania:

Dodawanie kontrolek zakładki w czasie projektowania

Istnieje kilka sposobów dodawania Bookmark kontrolek do dokumentu w projekcie na poziomie dokumentu w czasie projektowania:

  • Z przybornika programu Visual Studio.

    Możesz przeciągnąć kontrolkę Bookmark z przybornika do dokumentu. Możesz wybrać ten sposób, jeśli używasz już przybornika do dodawania kontrolek formularzy systemu Windows do dokumentu.

  • Z poziomu programu Word.

    Kontrolkę Bookmark można dodać do dokumentu w taki sam sposób, jak w przypadku dodawania zakładki natywnej. Zaletą dodawania jej w ten sposób jest możliwość nadania nazwy kontrolce podczas jej tworzenia.

  • W oknie Źródła danych.

    Kontrolkę Bookmark można przeciągnąć do dokumentu z okna Źródła danych. Jest to przydatne, gdy chcesz powiązać kontrolkę z danymi w tym samym czasie. Kontrolkę hosta można dodać w taki sam sposób, jak można dodać kontrolkę Formularz systemu Windows z okna Źródła danych. Aby uzyskać więcej informacji, zobacz Powiązanie danych i Formularze systemu Windows.

    Uwaga

    Na komputerze w poniższych instrukcjach mogą być wyświetlane inne nazwy i lokalizacje niektórych elementów interfejsu użytkownika programu Visual Studio. Te elementy są określane przez numer wersji Visual Studio oraz twoje ustawienia. Aby uzyskać więcej informacji, zobacz Personalizowanie środowiska IDE.

Aby dodać kontrolkę Zakładka do dokumentu z przybornika

  1. Otwórz przybornik i kliknij kartę Kontrolki programu Word.

  2. Przeciągnij kontrolkę Bookmark do dokumentu.

    Zostanie wyświetlone okno dialogowe Dodawanie zakładki .

  3. Zaznacz tekst lub inne elementy, które chcesz uwzględnić w zakładce.

  4. Kliknij przycisk OK.

    Jeśli nie chcesz zachować domyślnej nazwy zakładki, możesz zmienić nazwę w oknie Właściwości .

Aby dodać kontrolkę Zakładka do dokumentu w programie Word

  1. W dokumencie hostowanym w projektancie programu Visual Studio umieść kursor, w którym chcesz dodać zakładkę, lub wybierz tekst, który ma zostać ujęta w zakładkę.

  2. Na karcie Wstawianie wstążki w grupie Łącza kliknij przycisk Zakładka.

  3. W oknie dialogowym Zakładka wpisz nazwę nowej zakładki, a następnie kliknij przycisk Dodaj.

Dodawanie kontrolek zakładki w czasie wykonywania w projekcie na poziomie dokumentu

Kontrolki można dodawać Bookmark programowo do dokumentu w czasie wykonywania przy użyciu metod Controls właściwości ThisDocument klasy w projekcie. Istnieją dwa przeciążenia metody, których można użyć do dodania kontrolki Bookmark w następujący sposób:

Aby programowo dodać kontrolkę Zakładka do dokumentu

  1. ThisDocument_Startup W programie obsługi zdarzeń w projekcie wstaw następujący kod, aby dodać kontrolkę Bookmark do pierwszego akapitu w dokumencie.

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

    Uwaga

    Jeśli chcesz utworzyć kontrolkę Bookmark z istniejącego Bookmarkobiektu , użyj AddBookmark metody i przekaż istniejący Bookmarkelement .

Dodawanie kontrolek zakładki w czasie wykonywania w projekcie dodatku VSTO

Kontrolki można dodawać Bookmark programowo do dowolnego otwartego dokumentu w czasie wykonywania przy użyciu dodatku VSTO. W tym celu wygeneruj Document element hosta oparty na otwartym dokumencie, a następnie użyj metod Controls właściwości tego elementu hosta. Istnieją dwa przeciążenia metody, których można użyć do dodania kontrolki Bookmark w następujący sposób:

Aby dodać kontrolkę Zakładka w określonym zakresie

  1. AddBookmark Użyj metody i przekaż element , w Range którym chcesz dodać Bookmarkelement .

    Poniższy przykład kodu dodaje nowy Bookmark element na początku aktywnego dokumentu. Aby użyć tego przykładu ThisAddIn_Startup , uruchom kod z programu obsługi zdarzeń w projekcie dodatku programu Word VSTO.

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

Aby dodać kontrolkę Zakładka, która jest oparta na natywnej kontrolce zakładki

  1. AddBookmark Użyj metody i przekaż istniejący Bookmark element, którego chcesz użyć jako podstawy dla nowego Bookmarkelementu .

    Poniższy przykład kodu tworzy nowy Bookmark , który jest oparty na pierwszym Bookmark w aktywnym dokumencie. Aby użyć tego przykładu ThisAddIn_Startup , uruchom kod z programu obsługi zdarzeń w projekcie dodatku programu 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");
    }