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 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.