Элементы управления Bookmark

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

Применение. Сведения этого раздела применяются к проектам уровня документа и уровня приложения для Word 2013 и Word 2010. Дополнительные сведения см. в разделе Доступность функций по типам приложений Office и проектов.

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

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

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

Изменения данных в связанном наборе данных отображаются в элементе управления Microsoft.Office.Tools.Word.Bookmark.

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

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

Форматирование, применяемое к элементу Microsoft.Office.Interop.Word.Bookmark, можно применять и к элементу управления Microsoft.Office.Tools.Word.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, доступного в свойстве Range элемента управления Microsoft.Office.Tools.Word.Bookmark, или от свойства Range объекта Microsoft.Office.Interop.Word.Bookmark.

Свойство текста	Описание
Bookmark.Text	Воспользуйтесь этим свойством, чтобы отобразить текст в пределах закладки и оставить закладку в документе.Присвоение текста закладке увеличивает ее диапазон, но не удаляет ее. Например, Bookmark1.Text = "Hello world" добавляет текст в закладку и оставляет закладку неизменной.
Range.Text	Воспользуйтесь этим свойством, чтобы отобразить текст в расположении закладки и автоматически удалить ее.Например, Bookmark1.Range.Text = "Hello world" добавляет текст в закладку и удаляет ее.

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

В проектах уровня документа при перетаскивании элемента управления Microsoft.Office.Tools.Word.Bookmark из области элементов в документ Visual Studio имя элемента управления создается автоматически.Имя элемента управления можно изменить с помощью окна Свойства.

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

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

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

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

При присвоении закладке Bookmark1 нового текста "Это замена" закладки больше не перекрывают друг друга, и закладка Bookmark2 отражает только ту часть текста, которой изначально не было в тексте закладки Bookmark1.

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

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

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

При присвоении закладке Bookmark1 нового текста "Это замена" закладки больше не перекрывают друг друга, закладка Bookmark2 становится пустой и перемещается в конец закладки Bookmark1.

Закладка	Текст.
Две отдельные закладки	[это замена.]{}
Bookmark1	Это замена.
Bookmark2	<пусто>

События

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

• BeforeDoubleClick

• BeforeRightClick

• BindingContextChanged

• Deselected

• Disposed

• Selected

• SelectionChange

См. также

Задачи

Практическое руководство. Добавление закладок в документы Word

Пошаговое руководство. Создание контекстного меню для закладок

Основные понятия

Автоматизация Word с помощью расширенных объектов

Программные ограничения ведущих элементов и элементов управления ведущего приложения

Другие ресурсы

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