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 um Separador ou Página numa TabStrip ou MultiPage ou adiciona um controlo pelo respetivo identificador programático (ProgID) a uma página ou formulário.
Sintaxe
Para Várias Páginas, TabStrip:
Definirobjeto de objeto = .
Add( [ Nome [, Legenda [, índice ]]] )
Para outros controlos:
Definao objetoControlo = .
Add(ProgID [, Name [, Visible ]] )
A sintaxe Adicionar método tem as seguintes 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 o legenda a aparecer num separador ou num controlo. 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 separador numa coleção de Páginas ou Separadores . Se não for especificado um índice, o sistema acrescenta a página ou o separador ao final da coleção Páginas ou Separadores e atribui o valor de índice adequado. |
| ProgID | Obrigatório. Identificador programático. Uma cadeia de texto sem espaços que identifique uma classe de objeto. A sintaxe padrão para um ProgID é <Fornecedor>.<Componente>.<Versão>. Um ProgID é mapeado para um identificador de classe (CLSID). |
| Visible | Opcional. Verdadeiro se o objeto estiver visível (predefinição). Falso se o objeto estiver oculto. |
Configurações
Os valores de ProgID para controlos 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 |
| Caixa de Listagem | Forms.ListBox.1 |
| Várias Páginas | Forms.MultiPage.1 |
| Botão de Opção | Forms.OptionButton.1 |
| Barra de Deslocamento | Forms.ScrollBar.1 |
| SpinButton | Forms.SpinButton.1 |
| TabStrip | Forms.TabStrip.1 |
| TextBox | Forms.TextBox.1 |
| Botão de Alternar | Forms.ToggleButton.1 |
Comentários
Para um controlo de Várias Páginas , o método Adicionar devolve um objeto Página . Para uma TabStrip, devolve um objeto tab . O valor de índice da primeira Página ou Separador de uma coleção é 0, o valor da segunda Página ou Tabulação é 1 e assim sucessivamente.
Para a coleção Controlos de um objeto, o método Add devolve um controlo correspondente ao ProgID especificado. O evento AddControl ocorre depois de o controlo ser adicionado.
Pode adicionar um controlo à coleção Controlos de um formulário de utilizador no momento da conceção, mas tem de utilizar a propriedade Designer da Biblioteca de Extensibilidade do Microsoft Visual Basic for Applications para o fazer. A propriedade Designer devolve o objeto UserForm.
A sintaxe seguinte devolverá a propriedade Text do controlo especificado:
userform1.thebox.text
Se adicionar um controlo no tempo de execução, tem de utilizar a sintaxe de exclamação para referenciar as propriedades desse controlo. Por exemplo, para devolver a propriedade Text de um controlo adicionado no tempo de execução, utilize a seguinte sintaxe:
userform1!thebox.text
Observação
Só pode alterar a propriedade Nome de um controlo no tempo de execução se tiver adicionado esse controlo no tempo de execução com o método Adicionar .
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.