Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. 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.