Información general sobre controles de formularios Windows Forms en documentos de Office

Actualización: Julio de 2008

Se aplica a

La información de este tema sólo se aplica a los proyectos y versiones especificados de Visual Studio Tools para Office de Microsoft Office.

Proyectos de nivel de documento

  • Excel 2003

  • Excel 2007

  • Word 2003

  • Word 2007

Proyectos de nivel de aplicación

  • Excel 2007

  • Word 2007

Para obtener más información, consulte Características disponibles por aplicación y tipo de proyecto.

Los controles de formularios Windows Forms son objetos con los que pueden interactuar los usuarios para escribir o manipular datos. En proyectos en el nivel del documento para Microsoft Office Excel y Microsoft Office Word, puede agregar controles de formularios Windows Forms al documento o al libro de su proyecto en tiempo de diseño, o puede agregarlos mediante programación en tiempo de ejecución. A partir de Visual Studio 2008 Service Pack 1 (SP1), puede agregar mediante programación, en tiempo de ejecución, estos controles a cualquier documento u hoja de cálculo abierta de un complemento en el nivel de la aplicación para Excel 2007 o Word 2007.

Para obtener más información, vea Cómo: Agregar controles de Windows Forms a documentos de Office.

Utilizar controles de formularios Windows Forms

Puede agregar controles de formularios Windows Forms a documentos y elementos de la interfaz de usuario personalizables, incluidos los paneles de acciones, los paneles de tareas personalizados y los formularios Windows Forms. Los controles de formularios Windows Forms tienen generalmente el mismo comportamiento en los documentos que en estos otros elementos de la interfaz de usuario, pero existen algunas diferencias. Para obtener más información, vea Limitaciones de los controles de formularios Windows Forms en los documentos de Office.

La decisión de agregar controles de formularios Windows Forms a un documento o a otro elemento de la interfaz de usuario depende de varios factores. A la hora de diseñar la interfaz de usuario de la solución, considere los usos de los controles de los formularios Windows Forms que se describen en la tabla siguiente.

  • En un documento.

    • Cuando desea mostrar los controles todo el tiempo.

    • Cuando desea que los usuarios escriban datos directamente en el documento, por ejemplo, en documentos basados en formularios donde se bloquea la superficie de edición.

    • Cuando desea que se muestren los controles alineados con los datos en el documento. Por ejemplo, si agrega botones a cada fila de un objeto de lista, deseará que estén alineados con cada elemento de lista.

  • En el panel de acciones o un panel de tareas personalizado.

    • Cuando desea proporcionar información contextual al usuario.

    • Cuando desea que sólo aparezcan los resultados en el documento, y no los controles de consulta y datos.

    • Cuando desea garantizar que los controles no se imprimen con el documento.

    • Cuando desea garantizar que los controles no interfieren con la vista del documento.

  • En un formulario Windows Forms.

    • Cuando desea controlar el tamaño de la interfaz de usuario.

    • Cuando desea evitar que los usuarios oculten o eliminen los controles.

    • Cuando desea obtener datos proporcionados por el usuario y evitar que el usuario haga algo en el documento hasta que se reciban los datos.

Agregar controles de formularios Windows Forms mediante programación

Puede agregar en tiempo de ejecución controles de formularios Windows Forms a los documentos de Word y a las hojas de cálculo de Excel. Visual Studio Tools para Office proporciona los métodos de aplicación auxiliares para agregar los controles de formularios Windows Forms más comunes. Estos métodos auxiliares permiten agregar rápidamente controles al documento de Office y tener acceso a la funcionalidad combinada y la funcionalidad relacionada con Office de controles de formularios Windows Forms.

Para obtener más información, vea Agregar controles a documentos de Office en tiempo de ejecución.

Uso de los controles de formularios Windows Forms en proyectos en el nivel del documento

Algunos aspectos de utilizar los controles de formularios Windows Forms en documentos son específicos de los proyectos en el nivel del documento, y le permiten diseñar la interfaz de usuario utilizando el diseñador de Visual Studio.

Crear controles de usuario personalizados

Puede agregar un control de usuario al proyecto y, a continuación, agregarlo al Cuadro de herramientas. A continuación, puede arrastrar directamente el control de usuario hasta el documento del mismo modo que agregaría un control de formulario Windows Forms al documento. Hay algunos aspectos que se deben recordar al crear controles de usuario:

  • No cree un control de usuario sealed. Visual Studio Tools para Office genera una clase contenedora derivada del control de usuario para extenderlo y admitir su uso en el documento; Visual Studio Tools para Office no puede derivar de una clase sealed.

  • Los controles de usuario deben tener el atributo ComVisibleAttribute establecido en true. En los controles de usuario creados dentro de un proyecto de Visual Studio Tools para Office este atributo está establecido en true de manera predeterminada, pero en los controles de usuario que forman parte de proyectos externos podría no estar establecido en true.

  • Después de agregar un control de usuario al documento, no cambie el nombre ni elimine la clase UserControl del proyecto. Si necesita cambiar el nombre de un control de usuario, en primer lugar debe eliminarlo del documento y, a continuación, agregarlo de nuevo después de cambiar el nombre.

Agregar controles en tiempo de diseño

Si agrega varios controles a los documentos de Excel y Word en tiempo de diseño, puede establecer rápidamente la alineación de todos los controles seleccionados utilizando las barras de herramientas de Microsoft Office Word y Microsoft Office Excel en Visual Studio. Estas barras de herramientas solo están disponibles cuando hay un documento o una hoja de cálculo abierta en el diseñador.

Al seleccionar varios controles en el diseñador, puede utilizar los botones siguientes de estas barras de herramientas para organizarlos:

  • Alinear lados izquierdos

  • Alinear centros

  • Alinear lados derechos

  • Alinear lados superiores

  • Alinear puntos medios

  • Alinear lados inferiores

  • Igualar espaciado horizontal

  • Igualar espaciado vertical

Nota:

En proyectos de Word, estos botones están habilitados solo si los controles seleccionados no están en línea con texto. De forma predeterminada, los controles que agrega en tiempo de diseño al documento están en línea con texto. Para obtener más información, vea Utilizar controles de formularios Windows Forms en documentos de Word..

Evitar que aparezcan datos antiguos en libros de Excel cuando se cargan

Cuando se agregan en tiempo de diseño controles de formularios Windows Forms a documentos u hojas de cálculo, los controles permanecen en el documento cuando el usuario lo cierra. Los controles agregados en tiempo de diseño también se denominan controles estáticos.

Cuando se abre un libro de Excel que contiene controles estáticos, el libro presenta un mapa de bits del control en un control ActiveX hasta que el código de personalización se ejecuta y carga el control real. Excel crea el mapa de bits y lo almacena en el libro cada vez que se guarda el libro. El mapa de bits muestra el control tal como aparecía la última vez que se guardó el libro, incluidos los datos que estuviera mostrando el control. Para obtener más información acerca del control ActiveX que contiene controles de formularios Windows Forms y mapas de bits, vea Limitaciones de los controles de formularios Windows Forms en los documentos de Office.

En ciertas condiciones, el código no se carga y sólo se presenta el mapa de bits, por ejemplo cuando el usuario abre el libro en modo de diseño. Además, si el usuario abre el libro en un equipo que no tiene instalado el motor en tiempo de ejecución de Visual Studio Tools para Office, la personalización no se puede ejecutar para cargar los controles y, por lo tanto, sólo se puede ver el mapa de bits del control. Siempre debe quitar la información personal de los controles en los libros antes de guardarlos y enviarlos a otro usuario, con el fin de asegurarse de que su información personal no se revele accidentalmente.

Agregar componentes en tiempo de diseño

Ciertos controles o componentes no son visibles en el documento y se muestran en una bandeja de componentes. Visual Studio Tools para Office proporciona una bandeja de componentes para cada ventana de documento. La bandeja de componentes solo aparece en la pantalla si hay componentes en el documento.

Vea también

Tareas

Cómo: Agregar controles de Windows Forms a documentos de Office

Cómo: Cambiar el tamaño de controles en celdas de hojas de cálculo

Cómo: Ocultar controles en hojas de cálculo al imprimir

Tutorial: Cambiar el formato de una hoja de cálculo utilizando controles CheckBox

Tutorial: Cambiar el formato de un documento utilizando controles CheckBox

Tutorial: Mostrar texto en un cuadro de texto en un documento utilizando un botón

Tutorial: Mostrar texto en un cuadro de texto en una hoja de cálculo utilizando un botón

Conceptos

Utilizar controles de formularios Windows Forms en documentos de Word.

Usar controles de formularios Windows Forms en hojas de cálculo de Excel

Agregar controles a documentos de Office en tiempo de ejecución

Información general sobre elementos y controles Host

Información general sobre paneles de acciones

Limitaciones de los controles de formularios Windows Forms en los documentos de Office

Referencia

ControlCollection.Remove

ControlCollection.Remove

Otros recursos

Controles en documentos de Office

Controles de formularios Windows Forms

Historial de cambios

Fecha

Historial

Motivo

Julio de 2008

Se agrega información sobre cómo agregar controles de formularios Windows Forms a documentos utilizando complementos en el nivel de la aplicación.

Cambio de características de SP1.