Método Add (Microsoft Forms)
Agrega o inserta una pestaña o una página en un TabStrip o MultiPage, o agrega un control por su identificador de programación (ProgID) a una página o formulario.
Sintaxis
Para MultiPage, TabStrip:
Establecerobjeto Object = . Add( [ Name [, Caption [, index ]]] )
Para otros controles:
Establezca elobjetoControl = . Add(ProgID [, Name [, Visible ]] )
La sintaxis del método Add tiene estas partes:
| Parte | Descripción |
|---|---|
| object | Obligatorio. Un nombre de objeto válido. |
| Nombre | Opcional. Especifica el nombre del objeto que se está agregando. Si no se especifica un nombre, el sistema genera un nombre predeterminado según las reglas de la aplicación donde se usa el formulario. |
| Caption | Opcional. Especifica la leyenda que aparecerá en una pestaña o un control. Si no se especifica un nombre, el sistema genera una leyenda predeterminada según las reglas de la aplicación donde se usa el formulario. |
| index | Opcional. Identifica la posición de una página o pestaña dentro de una colección de páginas o pestañas. Si no se especifica un índice, el sistema anexa la página o la pestaña al final de la colección de páginas o pestañas y asigna el valor de índice apropiado. |
| ProgID | Obligatorio. Identificador programático. Una cadena de texto sin espacios que identifica una clase de objeto. La sintaxis estándar de un ProgID es <Vendor>.< Componente>.< Versión>. Un ProgID se asigna a un identificador de clase (CLSID). |
| Visible | Opcional. True si el objeto es visible (predeterminado). False si el objeto está oculto. |
Configuración
Los valores de ProgID para controles individuales son:
| Control | Valor de ProgID |
|---|---|
| Casilla | Forms.CheckBox.1 |
| ComboBox | Forms.ComboBox.1 |
| Commandbutton | Forms.CommandButton.1 |
| Frame | Forms.Frame.1 |
| Imagen | Forms.Image.1 |
| Etiqueta | Forms.Label.1 |
| Listbox | Forms.ListBox.1 |
| Multipage | Forms.MultiPage.1 |
| Optionbutton | Forms.OptionButton.1 |
| Scrollbar | Forms.ScrollBar.1 |
| SpinButton | Forms.SpinButton.1 |
| Tabstrip | Forms.TabStrip.1 |
| TextBox | Forms.TextBox.1 |
| Togglebutton | Forms.ToggleButton.1 |
Comentarios
Para un control MultiPage, el método Add devuelve un objeto Page. Para TabStrip, devuelve un objeto de pestaña. El valor del índice para el primer objeto Page o Tab de una colección es 0; el valor del segundo objeto Page o Tab es 1, etc.
Para la colección Controls de un objeto, el método Add devuelve un control correspondiente al ProgID especificado. El evento AddControl ocurre después de que se agregue el control.
Puede agregar un control a la colección Controls de un formulario de usuario en tiempo de diseño, pero debe usar la propiedad Designer de la biblioteca de extensibilidad de Microsoft Visual Basic para Aplicaciones para hacerlo. La propiedad Designer devuelve el objeto UserForm .
La siguiente sintaxis devolverá la propiedad Text del control especificado:
userform1.thebox.text
Si agrega un control en tiempo de ejecución, debe usar la sintaxis de exclamación para hacer referencia a propiedades de dicho control. Por ejemplo, para devolver la propiedad Text de un control agregado en tiempo de ejecución, use la siguiente sintaxis:
userform1!thebox.text
Nota:
Puede cambiar la propiedad Name de un control en tiempo de ejecución solo si agregó el control en tiempo de ejecución con el método Add.
Consulte también
Soporte técnico y comentarios
¿Tiene preguntas o comentarios sobre VBA para Office o esta documentación? Vea Soporte técnico y comentarios sobre VBA para Office para obtener ayuda sobre las formas en las que puede recibir soporte técnico y enviar comentarios.