Поделиться через


Bookmark - элемент управления

Элемент управления Bookmark представляет собой закладку с уникальным именем, которая предоставляет события и может быть привязана к данным. Закладка может использоваться как заполнитель для пометки элемента или расположения в документе Microsoft Office Word. Элемент управления Bookmark представляет собой комбинацию объектов Bookmark и Range .

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

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

Привязка данных к элементу управления

Элемент управления Bookmark поддерживает простую привязку данных. Закладка должна быть привязана к источнику данных с помощью свойства DataBindings . Свойство Text — это свойство привязки данных по умолчанию для закладки.

Если данные в связанном наборе данных обновляются, Bookmark элемент управления отображает изменения.

В проектах на уровне документа вы также можете привязывать данные к закладкам с помощью окна Источники данных . Дополнительные сведения см. в разделе "Практическое руководство. Заполнение документов данными из объектов".

Форматирование

Любое форматирование, которое можно применить к Bookmark , также можно применить и к элементу управления Bookmark . Это форматирование включает шрифты, отступы, интервалы, нумерации и стили.

Назначение текста закладке

Дополнительное различие между объектом Microsoft.Office.Interop.Word.Bookmark и элементом управления Microsoft.Office.Tools.Word.Bookmark состоит в их поведении при назначении текста закладке. Если вы назначаете текст Microsoft.Office.Interop.Word.Bookmarkнулевой длины, этот текст добавляется справа от закладки, а закладка останется нулевой длины. Однако если вы назначаете текст Microsoft.Office.Tools.Word.Bookmarkнулевой длины, этот текст вставляется в закладку, и длина закладки увеличивается на число вставленных символов.

Элемент управления Microsoft.Office.Tools.Word.Bookmark также имеет свойство Bookmark.Text . Это свойство отличается от Range.Text свойства, доступного для Bookmark.Range свойства Microsoft.Office.Tools.Word.Bookmark элемента управления, или Bookmark.Range свойства Microsoft.Office.Interop.Word.Bookmark объекта.

Свойство Text Description
Bookmark.Text Используйте это свойство для отображения текста в закладке и оставления закладки в документе. Назначение текста закладке расширяет диапазон закладки и не удаляет ее.

Например, Bookmark1.Text = "Hello world" вставляет текст в закладку и оставляет закладку неизменной.
Range.Text Используйте это свойство для отображения текста в расположении закладки и автоматического удаления ее. Например, Bookmark1.Range.Text = "Hello world" вставляет текст в закладку и удаляет закладку.

Переименование элемента управления во время разработки

В проектах уровня документа при перетаскивании элемента управления Bookmark из панели элементов в документ Visual Studio автоматически создает имя для этого элемента управления. Вы можете изменить это имя в окне Свойства .

Перекрывающиеся элементы управления

Элементы управления закладками могут перекрываться друг с другом. Один и тот же текст может использоваться несколькими закладками. При назначении нового текста одной из перекрывающихся закладок он содержит только новый текст и закладки больше не перекрываются. Другая закладка теперь содержит только текст, который не был предоставлен совместно между исходными перекрывающимися закладками.

В следующей таблице показано, как предложение "Это пример текста". Используется двумя перекрывающимися закладками:

Закладка Text
Перекрывающиеся закладки [это {образец] текста.}
Bookmark1 это образец
Bookmark2 образец текста.

Если назначить новый текст "Это замена". Закладки 1 не перекрываются, а Закладки 2 сохраняют только текст, который изначально не был частью Bookmark1.

Закладка Text
Две отдельные закладки [это замена]{ текста}
Bookmark1 это замена
Bookmark2 текста.

При изменении текста закладки, содержащей другую закладку, внутренняя закладка не удаляется. Однако внутренняя закладка становится пустой закладкой и переходит к концу внешней закладки.

В следующей таблице показано, как предложение "Это пример текста" предоставляется закладкой, содержащейся в другой закладке:

Закладка Text
Перекрывающиеся закладки [это {образец} текста.]
Bookmark1 это образец текста.
Bookmark2 пример

Если назначить новый текст "Это замена". Закладки 1 больше не перекрываются, а Закладки 2 становятся пустой закладкой, расположенной в конце закладки1.

Закладка Text
Две отдельные закладки [это замена.]{}
Bookmark1 это замена.
Bookmark2 <empty>

События

Для элемента управления Bookmark доступны следующие события: