Compartilhar via

Método Add (Microsoft Forms)

  • Artigo

Adiciona ou insere uma Guia ou Página em um TabStrip ou MultiPage ou adiciona um controle por seu identificador programático (ProgID) a uma página ou formulário.

Sintaxe

Para MultiPage, TabStrip:
Definirobjeto Object = . Add( [ Name [, Caption [, index ]]] )

Para outros controles:
DefinirobjetoControl = . Add(ProgID [, Name [, Visible ]] )

A sintaxe do método Add tem estas partes:

Sair Descrição
objeto Obrigatório. Um nome de objeto válido.
Nome Opcional. Especifica o nome do objeto que está sendo adicionado. Se um nome não for especificado, o sistema irá gerar um nome padrão com base nas regras do aplicativo onde o formulário é usado.
Caption Opcional. Especifica a legenda a ser exibida em uma guia ou em um controle. Se uma legenda não for especificada, o sistema irá gerar uma legenda padrão com base nas regras do aplicativo onde o formulário é usado.
índice Opcional. Identifica a posição de uma página ou guia em uma coleção Páginas ou Guias . Se um índice não for especificado, o sistema anexará a página ou a guia ao final da coleção Páginas ou Guias e atribuirá o valor de índice apropriado.
ProgID Obrigatório. Identificador programático. Uma cadeia de caracteres de texto sem espaços que identifica uma classe de objeto. A sintaxe padrão de um ProgID é <Vendor>.< Componente>.< Versão>. Um ProgID é mapeado para um CLSID (identificador de classe).
Visible Opcional. True se o objeto estiver visível (padrão). False se o objeto estiver oculto.

Configurações

Os valores progID para controles individuais são:

Controle Valor progID
Checkbox Forms.CheckBox.1
ComboBox Forms.ComboBox.1
Commandbutton Forms.CommandButton.1
Quadro Forms.Frame.1
Image Forms.Image.1
Rótulo Forms.Label.1
Listbox Forms.ListBox.1
Multipágina 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

Comentários

Para um controle MultiPage , o método Add retorna um objeto Page . Para um TabStrip, ele retorna um objeto Tab . O valor do índice da primeira Página ou Guia de uma coleção é 0, o valor da segunda Página ou Guia é 1 e assim por diante.

Para a coleção Controls de um objeto, o método Add retorna um controle correspondente ao ProgID especificado. O evento AddControl ocorre depois que o controle é adicionado.

Você pode adicionar um controle à coleção Controles de um formulário de usuário no momento do design, mas deve usar a propriedade Designer da Biblioteca de Extensibilidade do Microsoft Visual Basic for Applications para fazê-lo. A propriedade Designer retorna o objeto UserForm .

A sintaxe a seguir retornará a propriedade Text do controle especificado:

userform1.thebox.text

Se você adicionar um controle em tempo de execução, deverá usar a sintaxe de exclamação para fazer referência às propriedades desse controle. Por exemplo, para retornar a propriedade Text de um controle adicionado em tempo de execução, use a seguinte sintaxe:

userform1!thebox.text

Observação

Você só pode alterar a propriedade Name de um controle em tempo de execução se tiver adicionado esse controle em tempo de execução com o método Add .

Confira também

Suporte e comentários

Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.