Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Adiciona ou insere uma guia ou página em uma TabStrip ou MultiPage, ou adiciona um controle por seu identificador programático (ProgID) a uma página ou formulário.
Sintaxe
Para MultiPage, TabStrip:
Defina oobjetoObject = .
Add( [ Name [, Caption [, index ]]] )
Para outros controles:
Defina oobjetode Controle = .
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 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 dentro de uma coleção de Páginas ou Guias . Se um índice não for especificado, o sistema acrescentará a página ou 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 texto sem espaços que identifica uma classe de objeto. A sintaxe padrão para um ProgID é <Fornecedor>.<do Windows>.<Versão>. Um ProgID é mapeado para um identificador de classe (CLSID). |
| Visible | Opcional. Verdadeiro se o objeto estiver visível (padrão). Falso se o objeto estiver oculto. |
Configurações
Os valores ProgID para controles individuais são:
| Control | 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 |
| MultiPage | Forms.MultiPage.1 |
| OptionButton | Forms.OptionButton.1 |
| Barra de rolagem | Forms.ScrollBar.1 |
| Botão de rotação | 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 de índice para a primeira página ou guia de uma coleção é 0, o valor para a 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 Controls de um formulário de usuário em tempo de design, mas deve usar a propriedade Designer da Biblioteca de Extensibilidade do Microsoft Visual Basic for Applications para fazer isso. 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 a 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ó poderá 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.