Métodos auxiliares para controles de formularios Windows Forms
Mediante programación puede agregar controles de Windows Forms en tiempo de ejecución a un documento de Microsoft Office Word y a un libro de Microsoft Office Excel usando los métodos auxiliares disponibles en el proyecto. Para obtener más información, vea Agregar controles a documentos de Office en tiempo de ejecución.
Se aplica a: la información de este tema se aplica a los proyectos de nivel de documento y los proyectos de nivel de aplicación para las siguientes aplicaciones: Excel 2007 y Excel 2010; Word 2007 y Word 2010. Para obtener más información, vea Características disponibles por aplicación y tipo de proyecto de Office.
Métodos auxiliares para Excel
Para agregar controles de Windows Forms a una hoja de cálculo en tiempo de ejecución, utilice los métodos auxiliares que están disponibles en el objeto ControlCollection devuelto por la propiedad Worksheet.Controls (en un proyecto de nivel de aplicación) o la propiedad WorksheetBase.Controls (en un proyecto de nivel de documento). Se sobrecarga cada método auxiliar para que pueda pasar un objeto Range o las coordenadas de una ubicación determinada. Cuando crea un control pasando un objeto Range, el control cambia automáticamente de tamaño cuando se cambia el tamaño de las celdas dentro del rango.
Nota
En los proyectos de complemento de Excel destinados a .NET Framework 4, debe agregar una referencia al ensamblado Microsoft.Office.Tools.Excel.v4.0.Utilities.dll para poder obtener acceso a los métodos auxiliares.
En la siguiente tabla se enumeran los métodos auxiliares que puede utilizar para agregar mediante programación los controles de formularios Windows Forms a los libros de Excel.
Método auxiliar |
Descripción |
|---|---|
Agrega un control Button al rango especificado. |
|
AddButton(ControlCollection, Double, Double, Double, Double, String) |
Agrega un control Button en la posición especificada en lugar de en un rango. Las coordenadas se representan en puntos. |
Agrega un control Label al rango especificado. |
|
AddLabel(ControlCollection, Double, Double, Double, Double, String) |
Agrega un control Label en la posición especificada en lugar de en un rango. Las coordenadas se representan en puntos. |
Agrega un control LinkLabel al rango especificado. |
|
AddLinkLabel(ControlCollection, Double, Double, Double, Double, String) |
Agrega un control LinkLabel en la posición especificada en lugar de en un rango. Las coordenadas se representan en puntos. |
Agrega un control TextBox al rango especificado. |
|
AddTextBox(ControlCollection, Double, Double, Double, Double, String) |
Agrega un control TextBox en la posición especificada en lugar de en un rango. Las coordenadas se representan en puntos. |
Agrega un control CheckBox al rango especificado. |
|
AddCheckBox(ControlCollection, Double, Double, Double, Double, String) |
Agrega un control CheckBox en la posición especificada en lugar de en un rango. Las coordenadas se representan en puntos. |
Agrega un control RadioButton al rango especificado. |
|
AddRadioButton(ControlCollection, Double, Double, Double, Double, String) |
Agrega un control RadioButton en la posición especificada en lugar de en un rango. Las coordenadas se representan en puntos. |
Agrega un control PictureBox al rango especificado. |
|
AddPictureBox(ControlCollection, Double, Double, Double, Double, String) |
Agrega un control PictureBox en la posición especificada en lugar de en un rango. Las coordenadas se representan en puntos. |
Agrega un control CheckedListBox al rango especificado. |
|
AddCheckedListBox(ControlCollection, Double, Double, Double, Double, String) |
Agrega un control CheckedListBox en la posición especificada en lugar de en un rango. Las coordenadas se representan en puntos. |
Agrega un control ComboBox al rango especificado. |
|
AddComboBox(ControlCollection, Double, Double, Double, Double, String) |
Agrega un control ComboBox en la posición especificada en lugar de en un rango. Las coordenadas se representan en puntos. |
Agrega un control ListView al rango especificado y, además, establece la posición y el tamaño del control. |
|
AddListView(ControlCollection, Double, Double, Double, Double, String) |
Agrega un control ListView en la posición especificada en lugar de en un rango. Las coordenadas se representan en puntos. |
Agrega un control TreeView al rango especificado. |
|
AddTreeView(ControlCollection, Double, Double, Double, Double, String) |
Agrega un control TreeView en la posición especificada en lugar de en un rango. Las coordenadas se representan en puntos. |
Agrega un control DateTimePicker al rango especificado. |
|
AddDateTimePicker(ControlCollection, Double, Double, Double, Double, String) |
Agrega un control DateTimePicker en la posición especificada en lugar de en un rango. Las coordenadas se representan en puntos. |
Agrega un control MonthCalendar al rango especificado. |
|
AddMonthCalendar(ControlCollection, Double, Double, Double, Double, String) |
Agrega un control MonthCalendar en la posición especificada en lugar de en un rango. Las coordenadas se representan en puntos. |
Agrega un control DomainUpDown al rango especificado. |
|
AddDomainUpDown(ControlCollection, Double, Double, Double, Double, String) |
Agrega un control DomainUpDown en la posición especificada en lugar de en un rango. Las coordenadas se representan en puntos. |
Agrega un control NumericUpDown al rango especificado. |
|
AddNumericUpDown(ControlCollection, Double, Double, Double, Double, String) |
Agrega un control NumericUpDown en la posición especificada en lugar de en un rango. Las coordenadas se representan en puntos. |
Agrega un control TrackBar al rango especificado. |
|
AddTrackBar(ControlCollection, Double, Double, Double, Double, String) |
Agrega un control TrackBar en la posición especificada en lugar de en un rango. Las coordenadas se representan en puntos. |
Agrega un control RichTextBox al rango especificado. |
|
AddRichTextBox(ControlCollection, Double, Double, Double, Double, String) |
Agrega un control RichTextBox en la posición especificada en lugar de en un rango. Las coordenadas se representan en puntos. |
Agrega un control DataGridView al rango especificado. |
|
AddDataGridView(ControlCollection, Double, Double, Double, Double, String) |
Agrega un control DataGridView en la posición especificada en lugar de en un rango. Las coordenadas se representan en puntos. |
Agrega un control HScrollBar al rango especificado. |
|
AddHScrollBar(ControlCollection, Double, Double, Double, Double, String) |
Agrega un control HScrollBar en la posición especificada en lugar de en un rango. Las coordenadas se representan en puntos. |
Agrega un control VScrollBar al rango especificado. |
|
AddVScrollBar(ControlCollection, Double, Double, Double, Double, String) |
Agrega un control VScrollBar en la posición especificada en lugar de en un rango. Las coordenadas se representan en puntos. |
Agrega un control PropertyGrid al rango especificado. |
|
AddPropertyGrid(ControlCollection, Double, Double, Double, Double, String) |
Agrega un control PropertyGrid en la posición especificada en lugar de en un rango. Las coordenadas se representan en puntos. |
Agrega un control WebBrowser al rango especificado. |
|
AddWebBrowser(ControlCollection, Double, Double, Double, Double, String) |
Agrega un control WebBrowser en la posición especificada en lugar de en un rango. Las coordenadas se representan en puntos. |
Métodos auxiliares para Word
Para agregar controles de Windows Forms a un documento en tiempo de ejecución, utilice los métodos auxiliares que están disponibles en el objeto ControlCollection devuelto por la propiedad Document.Controls (en un proyecto de nivel de aplicación) o la propiedad DocumentBase.Controls (en un proyecto de nivel de documento). Se sobrecarga cada método para que pueda pasar un objeto Range o las coordenadas de una ubicación determinada. Cuando crea un control pasando un objeto Range, el control se agrega como objeto InlineShape al principio del rango. No puede cambiar las propiedades Top y Left de controles agregados en línea con texto. Cuando crea un control pasando coordenadas, el control se agrega como objeto Shape flotante en la ubicación especificada.
Nota
En los proyectos de complemento de Word destinados a .NET Framework 4, debe agregar una referencia al ensamblado Microsoft.Office.Tools.Word.v4.0.Utilities.dll para poder obtener acceso a los métodos auxiliares.
En la siguiente tabla se enumeran los métodos auxiliares que puede utilizar para agregar mediante programación los controles de formularios Windows Forms a los documentos de Word.
Método auxiliar |
Descripción |
|---|---|
Agrega un control Button al principio del rango especificado. |
|
AddButton(ControlCollection, Single, Single, Single, Single, String) |
Agrega un control Button en la posición especificada en lugar de en un rango. Las coordenadas se representan en puntos. |
Agrega un control Label al principio del rango especificado. |
|
AddLabel(ControlCollection, Single, Single, Single, Single, String) |
Agrega un control Label en la posición especificada en lugar de en un rango. Las coordenadas se representan en puntos. |
AddLinkLabel(ControlCollection, Range, Single, Single, String) |
Agrega un control LinkLabel al principio del rango especificado. |
AddLinkLabel(ControlCollection, Single, Single, Single, Single, String) |
Agrega un control LinkLabel en la posición especificada en lugar de en un rango. Las coordenadas se representan en puntos. |
AddTextBox(ControlCollection, Range, Single, Single, String) |
Agrega un control TextBox al principio del rango especificado. |
AddTextBox(ControlCollection, Single, Single, Single, Single, String) |
Agrega un control TextBox en la posición especificada en lugar de en un rango. Las coordenadas se representan en puntos. |
AddCheckBox(ControlCollection, Range, Single, Single, String) |
Agrega un control CheckBox al principio del rango especificado. |
AddCheckBox(ControlCollection, Single, Single, Single, Single, String) |
Agrega un control CheckBox en la posición especificada en lugar de en un rango. Las coordenadas se representan en puntos. |
AddRadioButton(ControlCollection, Range, Single, Single, String) |
Agrega un control RadioButton al principio del rango especificado. |
AddRadioButton(ControlCollection, Single, Single, Single, Single, String) |
Agrega un control RadioButton en la posición especificada en lugar de en un rango. Las coordenadas se representan en puntos. |
AddPictureBox(ControlCollection, Range, Single, Single, String) |
Agrega un control PictureBox al principio del rango especificado. |
AddPictureBox(ControlCollection, Single, Single, Single, Single, String) |
Agrega un control PictureBox en la posición especificada en lugar de en un rango. Las coordenadas se representan en puntos. |
AddCheckedListBox(ControlCollection, Range, Single, Single, String) |
Agrega un control CheckedListBox al principio del rango especificado. |
AddCheckedListBox(ControlCollection, Single, Single, Single, Single, String) |
Agrega un control CheckedListBox en la posición especificada en lugar de en un rango. Las coordenadas se representan en puntos. |
AddComboBox(ControlCollection, Range, Single, Single, String) |
Agrega un control ComboBox al principio del rango especificado. |
AddComboBox(ControlCollection, Single, Single, Single, Single, String) |
Agrega un control ComboBox en la posición especificada en lugar de en un rango. Las coordenadas se representan en puntos. |
AddListView(ControlCollection, Range, Single, Single, String) |
Agrega un control ListView al rango especificado y, además, establece la posición y el tamaño del control. |
AddListView(ControlCollection, Single, Single, Single, Single, String) |
Agrega un control ListView en la posición especificada en lugar de en un rango. Las coordenadas se representan en puntos. |
AddTreeView(ControlCollection, Range, Single, Single, String) |
Agrega un control TreeView al principio del rango especificado. |
AddTreeView(ControlCollection, Single, Single, Single, Single, String) |
Agrega un control TreeView en la posición especificada en lugar de en un rango. Las coordenadas se representan en puntos. |
AddDateTimePicker(ControlCollection, Range, Single, Single, String) |
Agrega un control DateTimePicker al principio del rango especificado. |
AddDateTimePicker(ControlCollection, Single, Single, Single, Single, String) |
Agrega un control DateTimePicker en la posición especificada en lugar de en un rango. Las coordenadas se representan en puntos. |
AddMonthCalendar(ControlCollection, Range, Single, Single, String) |
Agrega un control MonthCalendar al principio del rango especificado. |
AddMonthCalendar(ControlCollection, Single, Single, Single, Single, String) |
Agrega un control MonthCalendar en la posición especificada en lugar de en un rango. Las coordenadas se representan en puntos. |
AddDomainUpDown(ControlCollection, Range, Single, Single, String) |
Agrega un control DomainUpDown al principio del rango especificado. |
AddDomainUpDown(ControlCollection, Single, Single, Single, Single, String) |
Agrega un control DomainUpDown en la posición especificada en lugar de en un rango. Las coordenadas se representan en puntos. |
AddNumericUpDown(ControlCollection, Range, Single, Single, String) |
Agrega un control NumericUpDown al principio del rango especificado. |
AddNumericUpDown(ControlCollection, Single, Single, Single, Single, String) |
Agrega un control NumericUpDown en la posición especificada en lugar de en un rango. Las coordenadas se representan en puntos. |
AddTrackBar(ControlCollection, Range, Single, Single, String) |
Agrega un control TrackBar al principio del rango especificado. |
AddTrackBar(ControlCollection, Single, Single, Single, Single, String) |
Agrega un control TrackBar en la posición especificada en lugar de en un rango. Las coordenadas se representan en puntos. |
AddRichTextBox(ControlCollection, Range, Single, Single, String) |
Agrega un control RichTextBox al principio del rango especificado. |
AddRichTextBox(ControlCollection, Single, Single, Single, Single, String) |
Agrega un control RichTextBox en la posición especificada en lugar de en un rango. Las coordenadas se representan en puntos. |
AddDataGridView(ControlCollection, Range, Single, Single, String) |
Agrega un control DataGridView al principio del rango especificado. |
AddDataGridView(ControlCollection, Single, Single, Single, Single, String) |
Agrega un control DataGridView en la posición especificada en lugar de en un rango. Las coordenadas se representan en puntos. |
AddHScrollBar(ControlCollection, Range, Single, Single, String) |
Agrega un control HScrollBar al principio del rango especificado. |
AddHScrollBar(ControlCollection, Single, Single, Single, Single, String) |
Agrega un control HScrollBar en la posición especificada en lugar de en un rango. Las coordenadas se representan en puntos. |
AddVScrollBar(ControlCollection, Range, Single, Single, String) |
Agrega un control VScrollBar al principio del rango especificado. |
AddVScrollBar(ControlCollection, Single, Single, Single, Single, String) |
Agrega un control VScrollBar en la posición especificada en lugar de en un rango. Las coordenadas se representan en puntos. |
AddPropertyGrid(ControlCollection, Range, Single, Single, String) |
Agrega un control PropertyGrid al principio del rango especificado. |
AddPropertyGrid(ControlCollection, Single, Single, Single, Single, String) |
Agrega un control PropertyGrid en la posición especificada en lugar de en un rango. Las coordenadas se representan en puntos. |
AddWebBrowser(ControlCollection, Range, Single, Single, String) |
Agrega un control WebBrowser al principio del rango especificado. |
AddWebBrowser(ControlCollection, Single, Single, Single, Single, String) |
Agrega un control WebBrowser en la posición especificada en lugar de en un rango. Las coordenadas se representan en puntos. |
Vea también
Conceptos
Agregar controles a documentos de Office en tiempo de ejecución
Información general sobre controles de formularios Windows Forms en documentos de Office
Limitaciones de los controles de formularios Windows Forms en los documentos de Office