Programowe aktualizowanie tekstu zakładki

Tekst można wstawić do zakładki zastępczej w dokumencie programu Microsoft Office Word, aby można było pobrać tekst w późniejszym czasie lub zastąpić tekst w zakładce. Jeśli tworzysz dostosowanie na poziomie dokumentu, możesz również zaktualizować tekst w kontrolce powiązanej Bookmark z danymi. Aby uzyskać więcej informacji, zobacz Wiązanie danych z kontrolkami w rozwiązaniach pakietu Office.

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.

Obiekt zakładki może być jednym z dwóch typów:

• Kontrolka Bookmark hosta.

  Bookmark kontrolki rozszerzają obiekty natywne Bookmark , włączając powiązanie danych i uwidacznianie zdarzeń. Aby uzyskać więcej informacji na temat kontrolek hostów, zobacz Host items and host controls overview (Omówienie elementów hosta i kontrolek hostów).

• Obiekt macierzysty Bookmark .

  Bookmark obiekty nie mają zdarzeń ani możliwości powiązania danych.

  Podczas przypisywania tekstu do zakładki zachowanie różni się między elementem a Bookmark a Bookmark. Aby uzyskać więcej informacji, zobacz Kontrolka zakładki.

Korzystanie z kontrolek hosta

Aby zaktualizować zawartość zakładek przy użyciu kontrolki Zakładka

1. Utwórz procedurę bookmark , która przyjmuje argument nazwy zakładki i newText argument dla ciągu, który ma zostać przypisany do Text właściwości .

   Uwaga

   Przypisanie tekstu do Text właściwości lub FormattedText kontrolki Bookmark nie powoduje usunięcia zakładki.

   C#

   static void BookMarkReplace(
       ref Microsoft.Office.Tools.Word.Bookmark bookmark, 
       string newText)
   {
   

   VB

   Shared Sub BookMarkReplace( _
       ByRef bookmark As Microsoft.Office.Tools.Word.Bookmark, _
       ByVal newText As String)
   

2. Przypisz nowy ciągText do Text właściwości Bookmark.

   C#

       bookmark.Text = newText;
   }
   

   VB

       bookmark.Text = newText
   End Sub
   

Używanie obiektów programu Word

Aby zaktualizować zawartość zakładek przy użyciu obiektu zakładki programu Word

1. Utwórz procedurę, która ma bookmark argument nazwy Bookmark, i newText argument dla ciągu, który ma zostać przypisany do Text właściwości zakładki.

   Uwaga

   Przypisanie tekstu do natywnego obiektu programu Word Bookmark powoduje usunięcie zakładki.

   C#

   internal void BookMarkReplaceNative(
       Word.Bookmark bookmark, 
       string newText)
   {
   

   VB

   Friend Sub BookMarkReplaceNative( _
       ByVal bookmark As Word.Bookmark, _
       ByVal newText As String)
   

2. Przypisz nowy ciągText do Text właściwości zakładki, która automatycznie usuwa zakładkę. Następnie dodaj ponownie zakładkę do kolekcji Bookmarks .

   Poniższy przykład kodu może być używany w dostosowywaniu na poziomie dokumentu.

   C#

       object rng = bookmark.Range;
       string bookmarkName = bookmark.Name;
   
       bookmark.Range.Text = newText;
   
       this.Bookmarks.Add(bookmarkName, ref rng); 
   }
   

   VB

       Dim rng As Word.Range = bookmark.Range
       Dim bookmarkName As String = bookmark.Name
   
       bookmark.Range.Text = newText
   
       Me.Bookmarks.Add(Name:=bookmarkName, Range:=rng)
   End Sub
   

   Poniższy przykład kodu może być używany w dodatku VSTO. W tym przykładzie użyto aktywnego dokumentu.

   C#

       object rng = bookmark.Range;
       string bookmarkName = bookmark.Name;
   
       bookmark.Range.Text = newText;
   
       Word.Document document = this.Application.ActiveDocument;
       document.Bookmarks.Add(bookmarkName, ref rng);
   }
   

   VB

       Dim rng As Object = bookmark.Range
       Dim bookmarkName As String = bookmark.Name
   
       bookmark.Range.Text = newText
       Me.Application.ActiveDocument.Bookmarks.Add(Name:=bookmarkName, Range:=rng)
   End Sub
   

Powiązana zawartość

• Instrukcje: Programowe wstawianie tekstu do dokumentów programu Word
• Omówienie modelu obiektów programu Word
• Kontrolka zakładki