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

Статья
04/28/2010

Обновлен: Ноябрь 2007

Windows Presentation Foundation (WPF) является альтернативой Windows Forms в области разработки пользовательских интерфейсов. WPF использует расширяемый язык исправления для приложений XAML для обеспечения новых методов включения пользовательского интерфейса, мультимедийных файлов и документов. Дополнительные сведения см. в разделе Знакомство с Windows Presentation Foundation.

Хотя решения Visual Studio Tools for Office рассчитаны на использование с элементами управления Windows Forms, в решениях можно также использовать элементы управления WPF. Любой элемент пользовательского интерфейса в решении Visual Studio Tools for Office, который может содержать элементы управления Windows Forms, может также содержать и элементы управления WPF. В их числе:

Документы и книги в настройках уровня документа.
Панели действий в настройках уровня документа.
Настраиваемые панели задач в надстройках уровня приложения.
Области форм в надстройках уровня приложения для Outlook.

Добавление элементов управления WPF в проекты Visual Studio Tools for Office во время разработки

Добавлять элементы управления WPF напрямую к элементам пользовательского интерфейса в решениях Visual Studio Tools for Office нельзя. Вместо этого в проект следует добавить элемент Пользовательский элемент управления (WPF) и использовать его в качестве рабочей области конструирования для элементов управления WPF. Затем необходимо добавить пользовательский элемент управления WPF в элемент пользовательского интерфейса в проекте.

Добавление элемента управления WPF в панель действий, настраиваемую панель задач или область форм

Откройте проект, в котором требуется добавить настраиваемую панель задач, панель действий или область форм.
Добавьте в проект Пользовательский элемент управления (WPF).
Добавьте элементы управления WPF с панели элементов в рабочую область конструирования пользовательского элемента управления WPF.

По умолчанию, когда конструктор пользовательских элементов управления WPF открыт, панель элементов содержит только элементы управления WPF.
Выполните построение проекта.
Добавление в проект панели действий, настраиваемой панели задач или области форм
- Для добавления областей форм следует добавить в проект элемент Область форм Outlook. Дополнительные сведения см. в разделе Практическое руководство. Добавление области формы в проект надстройки Outlook.
- Чтобы добавить панели действий, в проект необходимо добавить Элемент управления панели действий или Пользовательский элемент управления. Дополнительные сведения см. в разделах Практическое руководство. Добавление панели действий в документы Word и Практическое руководство. Добавление панели действий в книги Excel.
- Для добавления настраиваемой панели задач следует добавить в проект Пользовательский элемент управления. Дополнительные сведения см. в разделе Практическое руководство. Добавление настраиваемой панели задач в приложение.
С вкладки ИмяПроектаэлементы управления WPF в панели элементов перетащите пользовательский элемент управления WPF в конструктор панели действий, области форм или настраиваемой панели задач.

Visual Studio автоматически создает объект ElementHost, размещающий пользовательский элемент управления WPF на элементе пользовательского интерфейса.
Постройте проект заново.

Добавление элементов управления WPF в документ или лист в проекте уровня документа

Откройте проект уровня документа для Word или Excel.
Добавьте в проект Пользовательский элемент управления (WPF).
Добавьте элементы управления WPF с панели элементов в рабочую область конструирования пользовательского элемента управления WPF.
Выполните построение проекта.
Добавьте в проект Пользовательский элемент управления (то есть пользовательский элемент управления Windows Forms).
Откройте конструктор пользовательского элемента Windows Forms.
Перетащите в конструктор со вкладки ProjectNameПользовательские элементы управления WPF в панели элементов элемент управления WPF.

Visual Studio автоматически создает объект ElementHost, размещающий пользовательский элемент управления WPF на пользовательском элементе управления Windows Forms.

Напишите код, который программными средствами добавляет пользовательский элемент управления Windows Forms в документ или книгу. Дополнительные сведения см. в разделе Добавление элементов управления в документы Office во время выполнения.

Примечание.
Перетащить пользовательский элемент управления Windows Forms в документ или книгу в режиме конструктора нельзя.

Постройте проект заново.

Размещение элементов управления WPF с помощью класса ElementHost

Средства Visual Studio Tools for Office предоставляют функциональные возможности, облегчающие использование элементов управления Windows Forms в решениях, но не обеспечивают аналогичные функциональные возможности для элементов управления WPF. Например, элементы управления Windows Forms можно добавлять в документы и книги во время разработки посредством перетаскивания элементов управления с панели элементов, или же во время выполнения — с помощью вспомогательных методов. Тем не менее, некоторые инструменты недоступны для элементов управления WPF.

Элементы управления WPF используют класс ElementHost в качестве слоя интеграции между элементами управления Windows Forms и элементами управления WPF. Класс ElementHost предоставляется платформой .NET Framework, начиная с версии 3.0.

При добавлении элементов управления WPF в решение во время разработки Visual Studio автоматически генерирует объект ElementHost. Пошаговое руководство по использованию класса ElementHost программными средствами см. в разделе Практическое руководство. Размещение элементов управления Windows Presentation Foundation в Windows Forms с помощью ElementHost.

Ресурсы WPF

Дополнительные сведения по вопросам архитектуры и разработки для размещения элементов управления WPF в элементах управления и формах Windows Forms см. в следующих разделах:

Дополнительные сведения о добавлении элементов управления WPF в элементы управления и формы Windows Forms в Visual Studio во время разработки см. в следующих разделах: