Porady: dodawanie formantów zakładek do dokumentów programu Word

Artykuł
06/10/2015

W przypadku projektów na poziomie dokumentu, można dodać Bookmark formanty do dokumentu w projekcie w czasie projektowania lub w czasie wykonywania.W przypadku projektów na poziomie aplikacji, można dodać Bookmark formanty do otwartego dokumentu, w czasie wykonywania.

Zastosowanie: Informacje przedstawione w tym temacie mają zastosowanie do projektów na poziomie dokumentu i aplikacji obsługiwanych w programach Word 2013 i Word 2010. Aby uzyskać więcej informacji, zobacz Funkcje dostępne w aplikacjach pakietu Office i typ projektu.

W tym temacie opisano następujące zadania:

Dodawanie formantów zakładki w czasie projektowania
Dodawanie formantów zakładki w czasie wykonania w projekt na poziomie dokumentu
Dodawanie formantów zakładki w czasie wykonywania w projekcie na poziomie aplikacji

Aby uzyskać więcej informacji o Bookmark kontroli, zobacz Formant zakładki.

Dodawanie formantów zakładki w czasie projektowania

Istnieje kilka sposobów, aby dodać Bookmark formanty do dokumentu w projekcie poziomie dokumentu w czasie projektowania:

Z programu Visual Studio Przybornik.

Można przeciągnąć Bookmark kontroli Przybornik do dokumentu.Należy wybrać w ten sposób, jeśli już używasz Przybornik Aby dodać formanty Windows Forms do dokumentu.
W programie Word.

Można dodać Bookmark formantu do dokumentu w taki sam sposób należy dodać zakładkę macierzystego.Zaletą dodanie go w ten sposób jest wymienić kontroli w chwili jej tworzenia.
Z Źródła danych okna.

Można przeciągnąć Bookmark formantu do dokumentu z Źródła danych okna.Jest to przydatne, gdy chcesz powiązać formant z danymi w tym samym czasie.Można dodać formant hosta w taki sam sposób, by dodać formant Windows z Źródła danych okna.Aby uzyskać więcej informacji, zobacz Wią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 Dostosowywanie ustawień środowiska deweloperskiego w Visual Studio.

Aby dodać formant zakładki w dokumencie z przybornika

Otwórz Przybornik i kliknij przycisk Kontroli słowo kartę.
Przeciągnij Bookmark formantu do dokumentu.

Dodaj zakładkę pojawi się okno dialogowe.
Zaznacz tekst lub inne przedmioty, które mają zostać uwzględnione w zakładce.
Kliknij przycisk OK.

Jeśli nie chcesz zachować domyślną nazwę zakładki, można zmienić nazwy w Właściwości okna.

Aby dodać formant zakładki do dokumentu w programie Word

W dokumencie, który znajduje się w Visual Studio designer, umieść kursor w którym chcesz dodać zakładkę lub zaznacz tekst, który chcesz zakładki, należy ująć.
Na wstawić karty wstążki, w linki grupy, kliknij przycisk Zakładka przycisk.
W Zakładka okno dialogowe, wpisz nazwę nowej zakładki, a następnie kliknij przycisk Dodaj.

Dodawanie formantów zakładki w czasie wykonywania projektu poziomie dokumentu

Można dodać Bookmark steruje programowo do dokumentu w czasie wykonywania przy użyciu metody Controls właściwość ThisDocument klasy do projektu.Istnieją dwa przeciążenia metody, które można użyć, aby dodać Bookmark kontroli w następujący sposób:

Dodaj Bookmark w określonym zakresie.
Dodaj Bookmark jest oparty na rodzimych zakładki w dokumencie (czyli Bookmark).

Tworzone dynamicznie Bookmark formanty nie są zachowywane w dokumencie, gdy dokument jest zamykany.Jednak urodzony Bookmark pozostaje w dokumencie.Można odtworzyć Bookmark jest oparty na zakładkę macierzystym przy następnym otwarciu dokumentu.Aby uzyskać więcej informacji, zobacz Dodawanie formantów do dokumentów pakietu Office w czasie wykonywania.

Aby dodać formant zakładki do dokumentu programowego

W ThisDocument_Startup obsługi zdarzeń w projekcie, wstaw poniższy kod, aby dodać Bookmark kontroli do pierwszego akapitu w dokumencie.

Dim firstParagraph As Microsoft.Office.Tools.Word.Bookmark
firstParagraph = Me.Controls.AddBookmark(Me.Paragraphs(1).Range, "FirstParagraph")

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

[!UWAGA]

Jeśli chcesz utworzyć Bookmark kontroli z istniejącego Bookmark, użyj AddBookmark metoda i przebieg w istniejących Bookmark.

Dodawanie formantów zakładki w czasie wykonywania w projekcie na poziomie aplikacji

Można dodać Bookmark kontroli programowo do otwartego dokumentu, w czasie wykonywania przy użyciu dodatku poziomie aplikacji.Aby to zrobić, należy wygenerować Document host element, który jest oparty na otwartym dokumencie, a następnie użyj metody Controls właściwości tego elementu hosta.Istnieją dwa przeciążenia metody, które można użyć, aby dodać Bookmark kontroli w następujący sposób:

Dodaj Bookmark w określonym zakresie.
Dodaj Bookmark jest oparty na rodzimych zakładki w dokumencie (czyli Bookmark).

Tworzone dynamicznie Bookmark formanty nie są zachowywane w dokumencie, gdy dokument jest zamykany.Jednak urodzony Bookmark pozostaje w dokumencie.Można odtworzyć Bookmark jest oparty na zakładkę macierzystym przy następnym otwarciu dokumentu.Aby uzyskać więcej informacji, zobacz Przechowywanie formantów dynamicznych w dokumentach pakietu Office.

Aby uzyskać więcej informacji na temat generowania elementów hosta w poziomie aplikacji, zobacz Rozszerzanie dokumentów programu Word i skoroszytów w programie Excel w czasie wykonywania w dodatkach na poziomie aplikacji.

Aby dodać formant zakładki w określonym zakresie

Użycie ControlCollection.AddBookmark(Range, String) metoda i przebiegu w Range gdzie chcesz dodać Bookmark.

Poniższy przykład kodu dodaje nowy Bookmark na początku aktywnego dokumentu.Aby wykorzystać ten przykład, należy uruchomić kod z ThisAddIn_Startup obsługi zdarzeń w Word-w projekcie.

Dim extendedDocument As Document = Globals.Factory.GetVstoObject(Me.Application.ActiveDocument)


Dim firstParagraph As Bookmark = extendedDocument.Controls.AddBookmark( _
    extendedDocument.Paragraphs(1).Range, "FirstParagraph")

Document extendedDocument = Globals.Factory.GetVstoObject(this.Application.ActiveDocument);


Bookmark firstParagraph = extendedDocument.Controls.AddBookmark(
    extendedDocument.Paragraphs[1].Range, "FirstParagraph");

Aby dodać formant zakładki, oparty na macierzystego formantu zakładki

Użyj ControlCollection.AddBookmark(Bookmark, String) metoda i przebieg w istniejących Bookmark , który ma zostać użyty jako podstawa dla nowych Bookmark.

Poniższy przykład kodu tworzy nowy Bookmark to jest oparte na pierwszym Bookmark w aktywnym dokumencie.Aby wykorzystać ten przykład, należy uruchomić kod z ThisAddIn_Startup obsługi zdarzeń w Word-w projekcie.

If Me.Application.ActiveDocument.Bookmarks.Count > 0 Then 
    Dim firstBookmark As Word.Bookmark = Me.Application.ActiveDocument.Bookmarks(1)

    Dim extendedDocument As Document = Globals.Factory.GetVstoObject(Me.Application.ActiveDocument)

    Dim vstoBookmark As Bookmark = extendedDocument.Controls.AddBookmark( _
        firstBookmark, "VSTOBookmark")
End If

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");
}

Zobacz też

Udostępnij za pośrednictwem