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


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

Хотя решения, созданные с помощью средств разработки Office в Visual Studio, предназначены для работы непосредственно с элементами управления Windows Forms, в них также можно использовать элементы управления WPF. Windows Presentation Foundation (WPF) — это альтернатива Windows Forms для разработки пользовательских интерфейсов. WPF использует язык разметки XAML для реализации новых методов включения элементов пользовательского интерфейса, объектов мультимедиа и документов. Дополнительные сведения см. в обзоре WPF.

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

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

  • документы и книги в настройках уровня документа;

  • панели действий в настройках уровня документа;

  • настраиваемые области задач в надстройках VSTO;

  • области формы в надстройках VSTO для Outlook.

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

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

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

  1. Откройте проект, в который требуется добавить настраиваемую область задач, панель действий или область формы.

  2. Добавьте элемент пользовательского элемента управления (WPF) в проект.

  3. На панели элементов добавьте элементы управления WPF в область конструктора пользовательского элемента управления WPF.

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

  4. Выполните сборку проекта.

  5. Добавьте в проект панель действий, область формы или настраиваемую область задач:

  6. На вкладке "Элементы управления пользователем PROJECTName WPF" на панели элементов перетащите элемент управления WPF в конструктор области действий, области форм или настраиваемую область задач.

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

  7. Выполните повторную сборку проекта.

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

  1. Откройте проект уровня документа для Word или Excel.

  2. Добавьте элемент пользовательского элемента управления (WPF) в проект.

  3. На панели элементов добавьте элементы управления WPF в область конструктора пользовательского элемента управления WPF.

  4. Выполните сборку проекта.

  5. Добавьте элемент пользовательского элемента управления (то есть пользовательского элемента управления Windows Forms) в проект.

  6. Откройте конструктор пользовательского элемента управления Windows Forms.

  7. На вкладке "Элементы управления пользователем WPF ProjectName WPF" на панели элементов перетащите пользовательский элемент управления WPF в конструктор.

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

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

    Примечание.

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

  9. Выполните повторную сборку проекта.

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

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

Элементы управления WPF используют класс ElementHost как уровень интеграции между элементом управления или формой Windows Forms и элементом управления WPF. При добавлении элементов управления WPF в решение во время разработки Visual Studio автоматически создает объект ElementHost.

Ресурсы WPF

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

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