Общие сведения об использовании элементов управления Windows Forms в документах Office

Статья
02/20/2013

Элементы управления Windows Forms — это объекты, с которыми могут взаимодействовать пользователи для ввода данных или управления ими.В проектах уровня документа для Microsoft Office Excel и Microsoft Office Word, можно добавить элементы управления Windows Forms во время разработки в документ или книгу в проекте, либо можно программными средствами добавить эти элементы управления во время выполнения.Разработчик может программным способом добавить эти элементы управления в любой открытый документ или лист во время выполнения с помощью надстройки уровня приложения для Excel или Word.

Дополнительные сведения см. в разделе Практическое руководство. Добавление элементов управления Windows Forms в документы Office.

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

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

Элементы управления Windows Forms можно добавить в документы и в настраиваемые элементы пользовательского интерфейса, включая панели действий, настраиваемые области задач и формы Windows Forms.Элементы управления Windows Forms обычно ведут себя в документах точно так же, как в других элементах пользовательского интерфейса, но существуют определенные различия.Сведения см. в разделе Ограничения по использованию элементов управления Windows Forms в документах Office.

Решение о добавлении элементов управления Windows Forms в документ или другой элемент пользовательского интерфейса зависит от ряда факторов.При разработке пользовательского интерфейса для решения следует учитывать следующие варианты использования элементов управления Windows Forms:

В документе.
- Если необходимо отображать элементы управления все время.
- Если нужно, чтобы пользователи вводили данные прямо в документ, например, в документы на основе форм, в которых область редактирования блокирована.
- Если необходимо, чтобы элементы управления отображались в соответствии с данными в документе.Например, при добавлении кнопок к каждой строке списка объектов может потребоваться, чтобы они располагались рядом с каждым элементом списка.
В панели действий или в настраиваемой области задач.
- Если необходимо предоставлять пользователю контекстно-зависимую информацию.
- Если необходимо, чтобы в документе появлялся только результат, а не данные и элементы управления запроса.
- Если необходимо убедиться, что элементы управления не будут напечатаны вместе с документом.
- Если необходимо убедиться, что элементы управления не влияют на представление документа.
В форме Windows Forms.
- Если необходимо управлять размерами элементов пользовательского интерфейса.
- Если необходимо, чтобы пользователи не могли скрывать или удалять элементы управления.
- Если необходимо получить входные данные от пользователя и при этом требуется обеспечить, чтобы пользователь не мог выполнять никаких действий с документом, пока входные данные не будут получены.

Добавление элементов управления Windows Forms программными средствами

Разработчик может добавить элементы управления Windows Forms в документы Word и листы Excel во время выполнения.Среда Visual Studio Tools for Office (cреда выполнения) предоставляет вспомогательные методы для добавления наиболее распространенных элементов управления Windows Forms.Эти вспомогательные методы позволяют быстро добавлять элементы управления в документы Office и получать доступ к объединенным функциональным возможностям Office и Windows Forms, реализованным в этих элементах управления.

Дополнительные сведения см. в разделе Добавление элементов управления в документы Office во время выполнения.

Использование элементов управления Windows Forms в проектах уровня документа

Некоторые аспекты использования элементов управления Windows Forms в документах уникальны для проектов уровня документа, что позволяет проектировать пользовательский интерфейс создаваемого документа с помощью конструктора Visual Studio.

Создание настраиваемых пользовательских элементов управления

Можно добавить пользовательский элемент управления в проект, а затем на Панель элементов.Затем можно перетащить пользовательский элемент управления в документ таким же способом, каким в документ добавляется элемент управления форм Windows Forms.При создании пользовательских элементов управления необходимо иметь в виду следующее.

Не создавайте пользовательский элемент управления sealed.При перетаскивании этого элемента управления в документ Visual Studio создает для его расширения класс-оболочку, производный от пользовательского элемента управления, и поддерживает его использование в документах.Если пользовательский элемент управления имеет значение sealed, то пакет Visual Studio не способен создать класс-оболочку.
Атрибуту ComVisibleAttribute пользовательского элемента управления должно быть присвоено значение true.Для этого атрибута пользовательских элементов управления, созданных в проекте Office, значение true установлено по умолчанию, однако для пользовательских элементов управления, являющихся частью внешних проектов, этому атрибуту не всегда присваивается значение true.
После добавления пользовательского элемента управления в документ не следует переименовывать или удалять из проекта класс UserControl.При необходимости изменить имя пользовательского элемента управления необходимо удалить его из документа, а затем добавить его снова после того, как имя будет изменено.

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

Если во время разработки в документы Word и Excel добавляется несколько элементов управления, можно быстро настроить выравнивание всех выделенных элементов управления с помощью панелей инструментов Microsoft Office Word и Microsoft Office Excel в Visual Studio.Эти панели инструментов доступны, только когда документ или лист открываются в конструкторе.

Выделив несколько элементов управления в конструкторе, можно использовать следующие кнопки этих панелей инструментов, чтобы упорядочить элементы управления:

Выровнять левые границы
Выровнять центры по горизонтали
Выровнять правые границы
Выровнять верхние границы
Выровнять центры по вертикали
Выровнять нижние границы
Сделать интервалы по горизонтали равными
Сделать интервалы по вертикали равными

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

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

Предотвращения появления старых данных в книгах Excel в процессе загрузки

При добавлении элементов управления Windows Forms в документы или листы во время разработки эти элементы управления остаются в документе, когда пользователь закрывает документ.Элементы управления, добавленные во время разработки, также называются статическими элементами управления.

Когда открыта книга Excel, содержащая статические элементы управления, она отображает растровое изображение элемента управления в элементе управления ActiveX до тех пор, пока выполняется код настройки и загружается фактический элемент управления.Excel создает это растровое изображение и сохраняет его в книге при каждом ее сохранении.Это растровое изображение показывает элемент управления так, как он отображался при последнем сохранении книги, включая любые данные, отображаемые элементом управления.Дополнительные сведения об элементе управления ActiveX, содержащем элементы управления Windows Forms и точечные рисунки, см. в разделе Ограничения по использованию элементов управления Windows Forms в документах Office.

При определенных условиях код не загружается и отображается только точечный рисунок, например когда пользователь открывает книгу в режиме разработки.Кроме того, если пользователь открывает книгу на компьютере, на котором не установлена среда выполнения Visual Studio Tools for Office (cреда выполнения), то настройка не будет запущена, поэтому элементы управления не загружаются, и отображается только точечный рисунок элемента управления.Следует всегда удалять личные сведения из элементов управления в книгах перед сохранением книги и отправкой ее другому пользователю, чтобы они не были случайно раскрыты.

Соответствующий размер элемента управления до размера ячеек на листе Excel

Можно настроить элемент управления для автоматического изменения размера при изменении размера родительской ячейки.Дополнительные сведения см. в разделе Практическое руководство. Изменение размера внутри ячеек листа Excel.

Добавление компонентов, совместно используемых всеми листами

Можно добавить компоненты, которые должны совместно использоваться всеми листами, например DataSet, в конструктор книги, а не в листы.Компонент появится в области компонентов.

Формула для внедрения элементов управления на лист Excel

При выборе элемента управления в Excel в строке формул отображается текст =EMBED("WinForms.Control.Host","").Этот текст является обязательным и не подлежит удалению.

Стиль макета элементов управления в документе слова

Если элемент управления Windows Forms добавляется в документ Word в проекте уровня документа с помощью конструктора Visual Studio, используется стиль обтекания "В тексте".Чтобы изменить стиль макета элемента управления, щелкните правой кнопкой мыши элемент управления и затем щелкните элемент Формат объекта.Выберите стиль обтекания на странице Макет диалогового окна Формат объекта.

При добавлении элемента управления в документ Word во время выполнения можно задать стиль макета нового элемента управления, используя другие перегрузки метода Add<класса элемента управления> Microsoft.Office.Tools.Word.ControlCollection:

Для добавления элемента управления со стилем обтекания "В тексте" следует использовать перегрузку метода, принимающую диапазон Range, который указывает размещение элемента управления.
Для добавления элемента управления со стилем обтекания "Вокруг контура" следует использовать перегрузку метода, принимающую левую и верхнюю координаты элемента управления.

Дополнительные сведения см. в разделе Добавление элементов управления в документы Office во время выполнения.

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

Элементы управления вне тела базовый документ

Элементы управления Windows Forms не поддерживаются внутри заголовка или нижнего колонтитула или внутри вложенного документа.

Добавление компонентов во время разработки

Определенные элементы управления или компоненты отображаются не в документе, а в области компонентов.Visual Studio предоставляет область компонентов для каждого окна документа.Область компонентов отображается на экране, только если документ содержит компоненты.

См. также

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