Tutorial: Crear nuevo contenido de Windows Presentation Foundation en formularios Windows Forms en tiempo de diseño

Artículo
08/23/2008

Actualización: noviembre 2007

En este tema se muestra cómo crear un control de Windows Presentation Foundation (WPF) para utilizarlo en sus aplicaciones basadas en formularios Windows Forms.

Realizará las tareas siguientes:

Crear el proyecto.
Crear un nuevo control de WPF.
Agregar el nuevo control de WPF a un formulario Windows Forms. El control de WPF se incluye en un control ElementHost.

Nota:
Los cuadros de diálogo y comandos de menú que se ven pueden diferir de los descritos en la Ayuda, dependiendo de los valores de configuración o de edición activos. Para cambiar la configuración, elija Importar y exportar configuraciones en el menú Herramientas. Para obtener más información, consulte Valores de configuración de Visual Studio.

Requisitos previos

Necesita los componentes siguientes para completar este tutorial:

Visual Studio 2008.

Creación del proyecto

El primer paso es crear el proyecto de formularios Windows Forms.

Nota:
Cuando se hospeda contenido WPF, sólo se admiten proyectos de C# y Visual Basic.

Para crear el proyecto

Cree un nuevo proyecto de aplicación de formularios Windows Forms en Visual Basic o Visual C# denominado HostingWpf. Para obtener más información, consulte Cómo: Crear un proyecto de aplicación para Windows.

Crear un nuevo control de WPF

Crear un nuevo control de WPF y agregarlo a un proyecto es tan fácil como agregar cualquier otro elemento al proyecto. El Diseñador de Windows Forms funciona con un tipo determinado de control denominado control compuestoo control de usuario. Para obtener más información acerca de los controles de usuario de WPF, vea UserControl.

Nota:
El tipo System.Windows.Controls.UserControl de WPF es distinto del tipo de control de usuario proporcionado por los formularios Windows Forms, que también se denomina System.Windows.Forms.UserControl.

Para crear un nuevo control de WPF

En el Explorador de soluciones, agregue un nuevo elemento Control de usuario (WPF) al proyecto. Use el nombre predeterminado para el tipo de control, UserControl1. Para obtener más información, consulte Cómo: Agregar y quitar elementos de una solución. Utilice el nombre predeterminado UserControl1.xaml.

Al agregar el nuevo control ocurre lo siguiente.
- El archivo UserControl1.xaml se agrega al proyecto.
- Cada archivo UserControl1.xaml.cs o UserControl1.xaml.vb se agrega al proyecto. Este archivo contiene el código subyacente para los controladores de eventos y otra implementación.
- Se agregan las referencias a los ensamblados de WPF al proyecto.
- Se abre el archivo UserControl1.xaml en Windows Presentation Foundation (WPF) Designer for Visual Studio.
En la vista Diseño, asegúrese de que UserControl1 está seleccionado. Para obtener más información, consulte Cómo: Seleccionar y mover elementos en la superficie de diseño.
En la ventana Propiedades, establezca el valor de las propiedades Width y Height en 200.
En el Cuadro de herramientas, arrastre un control System.Windows.Controls.TextBox a la superficie de diseño.
En la ventana Propiedades, establezca el valor de la propiedad Text en Contenido hospedado.

Nota:

En general, debería hospedar contenido de WPF más complejo. El control System.Windows.Controls.TextBox se utiliza aquí únicamente con fines ilustrativos.
Genere el proyecto.

Nota:
En general, debería hospedar contenido de WPF más complejo. El control System.Windows.Controls.TextBox se utiliza aquí únicamente con fines ilustrativos.

Agregar un control de WPF a un formulario Windows Forms

Su nuevo control de WPF está listo para utilizarlo en el formulario. Formularios Windows Forms utiliza el control ElementHost para hospedar el contenido de WPF

Para agregar un control de WPF a un formulario Windows Forms

Abra Form1 en el Diseñador de Windows Forms.
En el Cuadro de herramientas, busque la ficha Controles de usuario de WPF HostingWpf.
Arrastre una instancia de UserControl1 al formulario.
- Se crea automáticamente un control ElementHost en el formulario para hospedar el control de WPF.
- El control ElementHost se denomina elementHost1, y en la ventana Propiedades puede ver su propiedad Child establecida en UserControl1.
- Se agregan las referencias a los ensamblados de WPF al proyecto.
- El control elementHost1 tiene un panel de etiquetas inteligentes que muestra las opciones de hospedaje disponibles.
En el panel de etiquetas inteligentes Tareas de ElementHost, seleccione Acoplar en contenedor principal.
Presione F5 para generar y ejecutar la aplicación.

Pasos siguientes

Formularios Windows Forms y WPF son tecnologías diferentes, pero están diseñadas para operar estrechamente entre sí. Para proporcionar un aspecto y comportamiento más avanzado en sus aplicaciones, pruebe lo siguiente.