Usar controles de WPF en soluciones de Office

Artículo
04/28/2010

Actualización: noviembre 2007

Windows Presentation Foundation (WPF) es una alternativa a los formularios Windows Forms para diseñar interfaces de usuario. WPF utiliza un lenguaje de marcado llamado lenguaje de marcado de aplicaciones extensible (XAML) que proporciona nuevas técnicas con el fin de incorporar interfaces de usuario, multimedia y documentos. Para obtener más información, consulte Introducción a Windows Presentation Foundation.

Si bien las soluciones de Visual Studio Tools para Office están diseñadas para trabajar con controles de formularios Windows Forms, también puede utilizar en ellas controles de WPF. Cualquier elemento de la interfaz de usuario que pueda hospedar controles de formularios Windows Forms en una solución de Visual Studio Tools para Office también puede hospedar controles de WPF. Entre estos elementos se incluyen los siguientes:

Documentos y hojas de cálculo en personalizaciones de nivel de documento.
Paneles de acciones en personalizaciones de nivel de documento.
Paneles de tareas personalizados en complementos de nivel de aplicación.
Áreas de formulario en complementos de nivel de aplicación para Outlook.

Agregar controles de WPF a proyectos de Visual Studio Tools para Office en tiempo de diseño

No puede agregar directamente los controles de WPF a los elementos de la interfaz de usuario en las soluciones de Visual Studio Tools para Office. En su lugar, agregue un elemento Control de usuario (WPF) al proyecto y utilícelo como superficie de diseño para los controles de WPF. A continuación, agregue el control de usuario de WPF a un elemento de la interfaz de usuario del proyecto.

Para agregar controles de WPF a un panel de acciones, panel de tareas personalizado o área de formulario

Abra un proyecto al que desea agregar un panel de tareas personalizado, un panel de acciones o un área de formulario.
Agregue un elemento Control de usuario (WPF) al proyecto.
En el Cuadro de herramientas, agregue controles de WPF a la superficie de diseño del control de usuario de WPF.

De forma predeterminada, cuando el diseñador de controles de usuario de WPF está abierto, el Cuadro de herramientas sólo contiene controles de WPF.
Genere el proyecto.
Agregue un panel de acciones, área de formulario o panel de tareas personalizado al proyecto:
- Para las áreas de formulario, agregue un elemento Región de formulario de Outlook al proyecto. Para obtener más información, consulte Cómo: Agregar un área de formulario a un proyecto de complemento de Outlook.
- Para los paneles de acciones, agregue un elemento Control del panel de acciones o Control de usuario al proyecto. Para obtener más información, consulte Cómo: Agregar un panel de acciones a un documento de Word y Cómo: Agregar un panel de acciones a un libro de Excel.
- Para los paneles de tareas personalizados, agregue un elemento Control de usuario al proyecto. Para obtener más información, consulte Cómo: Agregar un panel de tareas personalizado a una aplicación.
Desde la ficha Controles de usuario denombreDeProyecto del Cuadro de herramientas, arrastre el control de usuario de WPF hacia el diseñador para el panel de acciones, área de formulario o panel de tareas personalizado.

Visual Studio crea automáticamente un objeto ElementHost que hospeda el control de usuario de WPF en el elemento de la interfaz de usuario.
Vuelva a generar el proyecto.

Para agregar controles de WPF a un documento u hoja de cálculo en un proyecto de nivel de documento

Abra un proyecto de nivel de documento para Word o Excel.
Agregue un elemento Control de usuario (WPF) al proyecto.
En el Cuadro de herramientas, agregue controles de WPF a la superficie de diseño del control de usuario de WPF.
Genere el proyecto.
Agregue un elemento Control de usuario (es decir, un control de usuario de formularios Windows Forms) al proyecto.
Abra el diseñador para el control de usuario de formularios Windows Forms.
Desde la ficha Controles de usuario denombreDeProyecto del Cuadro de herramientas, arrastre el control de usuario de WPF hacia el diseñador.

Visual Studio crea automáticamente un objeto ElementHost que hospeda el control de usuario de WPF en el control de usuario de formularios Windows Forms.
Escriba código que agregue mediante programación el control de usuario de formularios Windows Forms al documento o libro. Para obtener más información, consulte Agregar controles a documentos de Office en tiempo de ejecución.

Nota:

No puede arrastrar el control de usuario de formularios Windows Forms hacia el documento o la hoja de cálculo en el diseñador.
Vuelva a generar el proyecto.

Nota:
No puede arrastrar el control de usuario de formularios Windows Forms hacia el documento o la hoja de cálculo en el diseñador.

Hospedar controles de WPF mediante la clase ElementHost

Visual Studio Tools para Office proporciona características que le ayudan a utilizar controles de formularios Windows Forms en las soluciones, pero no proporciona características similares para los controles de WPF. Por ejemplo, puede agregar controles de formularios Windows Forms a los documentos y hojas de cálculo en tiempo de diseño si arrastra los controles desde el Cuadro de herramientas o bien en tiempo de ejecución si utiliza métodos auxiliares. Sin embargo, estas herramientas no están disponibles para los controles de WPF.

Los controles de WPF utilizan la clase ElementHost como una capa de la integración entre un control de formularios Windows Forms y los controles de WPF. .NET Framework proporciona la clase ElementHost a partir de la versión 3.0.

Al agregar controles de WPF a la solución en tiempo de diseño, Visual Studio genera automáticamente un objeto ElementHost. Para tener acceso a un tutorial que muestra cómo utilizar la clase ElementHost mediante programación, vea Cómo: Hospedar un control de Windows Presentation Foundation en formularios Windows Forms mediante el uso de ElementHost.

Recursos de WPF

Para obtener más información sobre los problemas de arquitectura y diseño relacionados con el hospedaje de controles de WPF en controles de formularios y formularios Windows Forms, vea los temas siguientes:

Para obtener más información sobre cómo agregar controles de WPF a los controles de formularios y formularios Windows Forms en Visual Studio en tiempo de diseño, vea los temas siguientes: