Элементы управления Bookmark
Обновлен: Июль 2008
Применение |
|---|
Сведения, приведенные в данном разделе, относятся только к указанным проектам Visual Studio Tools for Office и версиям Microsoft Office. Проекты уровня документа
Проекты уровня приложения
Дополнительные сведения см. в разделе Доступность функций по типам приложений и проектов. |
Элемент управления Bookmark представляет собой закладку с уникальным именем, событиями и возможностью привязки к данным. Закладку можно использовать в качестве прототипа элемента или размещения в документе Microsoft Office Word.
Элемент управления Bookmark представляет собой сочетание объектов Microsoft.Office.Interop.Word.Bookmark и Microsoft.Office.Interop.Word.Range. При добавлении закладки в документ Visual Studio Tools for Office создает объект закладки, который можно программировать непосредственно, не обращаясь к объектной модели Word.
В проектах уровня документа можно добавлять элементы управления Bookmark в документ во время разработки или во время выполнения. Начиная с пакета обновления 1 для Visual Studio 2008, можно также добавлять элементы управления Bookmark в любой открытый документ во время выполнения, используя надстройку уровня приложения для Word 2007. Дополнительные сведения см. в разделе Практическое руководство. Добавление закладок в документы Word.
Связывание данных с элементом управления
Элемент управления Bookmark поддерживает простую привязку данных. Закладку следует привязать к источнику данных с помощью свойства DataBindings. Свойством привязки данных закладки по умолчанию является Text.
Изменения данных в связанном наборе данных отображаются в элементе управления Bookmark.
В проектах уровня документа привязать данные к закладкам можно также с помощью окна Источники данных. Дополнительные сведения см. в разделе Практическое руководство. Заполнение документов данными из объектов.
Форматирование
Форматирование, применяемое к элементу Microsoft.Office.Interop.Word.Bookmark, можно применять и к элементу управления Bookmark. К таким функциям форматирования относятся шрифты, отступы, интервалы, нумерация списка, а также стили.
Присвоение текста закладке
Дополнительное различие между объектом Microsoft.Office.Interop.Word.Bookmark и элементом управления Bookmark составляет их поведение при присвоении текста закладке. Если присваивается текст нулевой длины Microsoft.Office.Interop.Word.Bookmark, он будет указан справа от закладки, и длина закладки останется нулевой. Однако, если присваивается текст нулевой длины Bookmark, он будет добавлен в закладку, а длина закладки увеличится в соответствии с общим количеством добавленных знаков.
Кроме того, Visual Studio Tools for Office добавляет свойство Bookmark.Text элементу управления Bookmark. Это составляет отличие от свойства Range.Text, доступного на Range закладки.
Свойство текста |
Описание |
|---|---|
Воспользуйтесь этим свойством, чтобы отобразить текст в пределах закладки и оставить закладку в документе. Присвоение текста закладке увеличивает ее диапазон, но не удаляет ее. Например, Bookmark1.Text = "Hello world" добавляет текст в закладку и оставляет закладку неизменной. |
|
Воспользуйтесь этим свойством, чтобы отобразить текст в расположении закладки и автоматически удалить ее. Например, Bookmark1.Range.Text = "Hello world" добавляет текст в закладку и удаляет ее. |
Переименование элемента управления во время разработки.
В проектах уровня документа при перетаскивании элемента управления Bookmark из элемента управления Панель элементов в документ Visual Studio Tools for Office создает имя элемента управления автоматически. Имя элемента управления можно изменить с помощью окна Свойства.
Перекрывающиеся элементы управления
Элементы управления типа "Закладка" могут перекрывать друг друга, т.е. один и тот же текст может использоваться несколькими закладками. При присвоении нового текста одной из перекрывающихся закладок, она будет содержать только новый текст, и закладки больше не будут перекрывать друг друга. Другая закладка в этом случае будет содержать только текст, не использующийся исходными перекрывающимися закладками.
В данной таблице приводится пример совместного использования предложения "Это текст примера." двумя перекрывающимися закладками.
Закладка |
Текст |
|---|---|
Перекрывающиеся закладки |
[Это {текст] примера.} |
Bookmark1 |
[Это текст |
Bookmark2 |
текст примера. |
При присвоении закладке Bookmark1 нового текста "Это замена" закладки больше не перекрывают друг друга, и закладка Bookmark2 отражает только ту часть текста, которой изначально не было в тексте закладки Bookmark1.
Закладка |
Текст |
|---|---|
Две отдельные закладки |
[это замена]{ примера.} |
Bookmark1 |
Это замена |
Bookmark2 |
примера. |
Если закладка полностью заполнена в пределах другой закладки и необходимо изменить текст внешней закладки, внутренняя закладка не удаляется. Однако внутренняя закладка становится пустой и перемещается в конец внешней закладки. В данной таблице приводится пример совместного использования предложения "Это текст примера." закладкой, входящей в состав другой закладки.
Закладка |
Текст |
|---|---|
Перекрывающиеся закладки |
[Это {текст} примера.] |
Bookmark1 |
[Это текст примера. |
Bookmark2 |
текст |
При присвоении закладке Bookmark1 нового текста "Это замена" закладки больше не перекрывают друг друга, закладка Bookmark2 становится пустой и перемещается в конец закладки Bookmark1.
Закладка |
Текст |
|---|---|
Две отдельные закладки |
[это замена.]{} |
Bookmark1 |
Это замена. |
Bookmark2 |
<пусто> |
События
Для элемента управления Bookmark доступны следующие события:
См. также
Задачи
Практическое руководство. Добавление закладок в документы Word
Пошаговое руководство. Создание контекстного меню для закладок
Основные понятия
Привязка данных к элементам управления
Программные ограничения ведущих элементов и элементов управления ведущего приложения
Другие ресурсы
Элементы управления ведущего приложения Word
Элементы управления ведущего приложения Excel
Журнал изменений
Дата |
Журнал |
Причина |
|---|---|---|
Июль 2008 |
Добавлены сведения об использовании закладок в проектах уровня приложения. |
Изменение функции SP1. |