Método AddVea también Ejemplo Aplicable a Detalles

Agrega o inserta un objeto Tab o Page en un control TabStrip o MultiPage, o agrega un control mediante suidentificador de programa (IdProg) a una página o formulario.

Sintaxis

Para un control MultiPage, TabStripSet Objeto = objeto.Add( [ Nombre [, Título [, índice]]])

Para otros controlesSet Control = objeto.Add( IdProg [, Nombre [, Visible]])

La sintaxis del método Add consta de las siguientes partes:

Valores

Los valores de IdProg para controles individuales son:

Parte Descripción

objeto Requerido. Un nombre de objeto válido.

Nombre Opcional. Especifica el nombre del objeto que se va a agregar. Si no se especifica un nombre,el sistema crea un nombre predeterminado basado en las reglas de la aplicación donde seutiliza el formulario.

Título Opcional. Especifica el título que aparece en una ficha o en un control. Si no se especificaningún título, el sistema crea un título predeterminado basado en las reglas de la aplicacióndonde se utiliza el formulario.

índice Opcional. Identifica la posición de una página o una ficha de una colección Pages o Tabs. Sino se especifica ningún índice, el sistema anexa la página o la ficha al final de la colecciónPages o Tabs y le asigna el valor de índice apropiado.

IdProg Requerido. Identificador de programa. Una cadena de texto sin espacios que identifica unaclase de objeto. La sintaxis estándar de un IdProg es<Fabricante>.<Componente>.<Versión>. Un IdProg se asigna a un identificador de clase(CLSID).

Visible Opcional. True si el objeto es visible (predeterminado). False si el objeto está oculto.

CheckBox Forms.CheckBox.1

ComboBox Forms.ComboBox.1

CommandButton Forms.CommandButton.1

Frame Forms.Frame.1

Image Forms.Image.1

Label 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

Página1 de 2Método Add

09/12/2012ms-help://MS.EXCEL.DEV.12.3082/MS.VBE.DEV.12.3082/VBE.DEV/html/f3mthadd....

Comentarios

Para un control MultiPage, el método Add devuelve un objeto Page. Para un control TabStrip, devuelve un objetoTab. El valor de índice del primer control Page o Tab de una colección es 0, el valor para el segundo control Page oTab es 1 y así sucesivamente.

Para la colección Controls de un objeto, el método Add devuelve un control correspondiente al IdProg especificado.El evento AddControl se produce después de que se agrega el control.

Puede agregar un control a una colección Controls de un formulario de usuario en tiempo de diseño pero se debeusar la propiedad Designer de la Biblioteca de extensibilidad de Visual Basic para Aplicaciones de Microsoft parahacerlo. La propiedad Designer devuelve el objeto UserForm.

La siguiente sintaxis devolverá la propiedad Text del control indicado:

user f or m1. t hebox. t ext

Si agrega un control en tiempo de ejecución, debe utilizar la sintaxis de admiración para hacer referencia apropiedades de ese control. Por ejemplo, para devolver la propiedad Text de un control agregado en tiempo deejecución, utilice la siguiente sintaxis:

user f or m1! t hebox. t ext

Nota Puede cambiar la propiedad Name de un control en tiempo de ejecución solamente si agregó ese control entiempo de ejecución con el método Add.

ToggleButton Forms.ToggleButton.1

Página2 de 2Método Add

09/12/2012ms-help://MS.EXCEL.DEV.12.3082/MS.VBE.DEV.12.3082/VBE.DEV/html/f3mthadd....