Программное обновление текста закладки

Вы можете вставить текст в закладку-заполнитель в документе Microsoft Office Word, чтобы позднее извлечь или заменить текст закладки. При разработке настройки на уровне документа можно обновить текст в элементе управления Bookmark с привязкой к данным. Дополнительные сведения см. в статье "Привязка данных к элементам управления в решениях Office".

Область применения. Сведения в этом разделе относятся к проектам уровня документа и проектам надстроек VSTO для Word. Дополнительные сведения см. в разделе "Функции", доступные по Приложение Office ликации и типу проекта.

Объект закладки может быть одного из двух типов.

• Элемент управления ведущего приложения Bookmark.

  Элементы управления Bookmark расширяют неуправляемые объекты Bookmark, реализуя привязку к данным и предоставляя события. Дополнительные сведения об элементах управления узлами см. в обзоре элементов узла и элементов управления узлами.

• Собственный объект Bookmark.

  У объектов Bookmark нет событий или возможностей для привязки данных.

  Поведение Bookmark и Bookmark при назначении текста закладке отличается. Дополнительные сведения см. в разделе "Элемент управления Закладки".

Использование элементов управления узлами

Обновление содержимого закладки с помощью элемента управления Bookmark

1. Создайте процедуру, которая принимает аргумент bookmark в качестве имени закладки и аргумент newText в качестве строки, назначаемой свойству Text.

   Примечание.

   Назначение текста свойству Text или FormattedText элемента управления Bookmark не приводит к удалению закладки.

   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. Назначьте строку Text newText свойству объекта Bookmark.

   C#

       bookmark.Text = newText;
   }
   

   VB

       bookmark.Text = newText
   End Sub
   

Использование объектов Word

Обновление содержимого закладки с помощью объекта Bookmark приложения Word

1. Создайте процедуру, которая принимает аргумент bookmark в качестве имени Bookmark и аргумент newText в качестве строки, назначаемой свойству Text закладки.

   Примечание.

   При присвоении текста собственному объекту Bookmark Word закладка удаляется.

   C#

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

   VB

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

2. Назначьте строку Text newText свойству закладки, которая автоматически удаляет закладку. Затем снова добавьте закладку в коллекцию Bookmarks.

   Следующий пример кода можно использовать в настройке на уровне документа.

   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
   

   Следующий пример кода можно использовать в надстройке VSTO. В этом примере используется активный документ.

   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
   

Связанный контент

• Практическое руководство. Программное вставка текста в документы Word
• Обзор объектной модели Word
• Элемент управления "Закладка"