Método Add (Microsoft Forms)
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.